Як створити подію й слухача і диспетчеризувати подію?

Question

Accepted Answer

Подія - простий клас з даними про те, що сталося. Слухач - клас, що реагує.
php artisan make:event OrderShipped
php artisan make:listener SendShipmentNotification --event=OrderShipped

class OrderShipped
{
    use Dispatchable, SerializesModels;

public function __construct(public Order $order) {}
}

class SendShipmentNotification
{
    public function handle(OrderShipped $event): void
    {
        $event->order->customer->notify(new ShipmentSent($event->order));
    }
}

Реєстрація не потрібна: Laravel сам знаходить слухачів у app/Listeners за типом параметра handle(). Вручну - через Event::listen() у провайдері.
Диспетчеризація:
OrderShipped::dispatch($order);
// або
event(new OrderShipped($order));

Навіщо це: код, що відправляє замовлення, не знає, хто реагує - лист, аналітика, склад. Нову реакцію додають новим слухачем, не чіпаючи відправника.
Повільних слухачів (листи, HTTP) роблять ShouldQueue - тоді вони виконуються у воркері, а не в запиті.
Докладніше в документації: Визначення подій

Junior: питання на співбесіді з теми «Події»