Events#

Events let services react to application behavior without coupling the publisher to every listener.

Register a listener#

use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;

$events = $app->container->get(EventDispatcherInterface::class);
$events->addListener(OrderPlaced::class, function (OrderPlaced $event) {
    // React to the event synchronously.
});

Dispatch an object#

final readonly class OrderPlaced
{
    public function __construct(public int $orderId) {}
}

$events->dispatch(new OrderPlaced(42));

Register listeners in a service provider's boot() method. Elang binds the contracts interface to Symfony EventDispatcher as a singleton.

Execution model#

Listeners run synchronously in the current PHP process. Dispatch slow work explicitly through the database JSON job queue described in /docs/v0.1/queues; listeners do not become background jobs automatically. Design exception handling and transaction boundaries explicitly.