Как работают события и слушатели?

Question

Accepted Answer

**События и слушатели** Laravel реализуют паттерн Observer — вы **отправляете событие** когда происходит что-то значительное, и один или несколько **слушателей** реагируют на это. Это развязывает код: источник события не нужно знать кто реагирует, позволяя чистое разделение ответственности.

## Определение события и слушателя

```php
// the event — a simple data carrier for "something happened"
class OrderShipped {
    public function __construct(public Order $order) {}
}

// a listener — reacts to the event
class SendShipmentNotification {
    public function handle(OrderShipped $event): void {
        Mail::to($event->order->customer)->send(new ShipmentMail($event->order));
    }
}
// generate with: php artisan make:event / make:listener
```

## Отправка события

```php
// when the order ships, DISPATCH the event — all listeners run
OrderShipped::dispatch($order);
// or: event(new OrderShipped($order));
```

Отправка события запускает всех зарегистрированных слушателей. Код отправки заказа просто объявляет что произошло — он не знает (и не волнует), что отправляются письма, собирается аналитика или происходят другие реакции.

## Несколько слушателей для одного события (развязка)

```php
// one event can have MANY listeners — each a separate concern
OrderShipped → SendShipmentNotification    // email
            → UpdateInventory               // adjust stock
            → RecordAnalytics               // log the event
// add reactions without modifying the order-shipping code
```

Вот ключевое преимущество: вы можете добавить новую реакцию (слушателя) к событию без изменения кода, который его отправляет — чистая, расширяемая развязка.

## Асинхронные слушатели (в очереди)

```php
class SendShipmentNotification implements ShouldQueue {   // run the listener in the BACKGROUND
    public function handle(OrderShipped $event): void { ... }
}
```

Реализация `ShouldQueue` делает слушателя работающим **асинхронно** через очередь — таким образом медленные реакции (отправка письма) не задерживают ответ.

## Почему это важно

События и слушатели — полезный инструмент Laravel для **развязки** кода — позволяя разным частям приложения реагировать на события без плотной связанности, что ценно для сквозных реакций и поддерживаемости кода.

Понимание их полезно как для использования, так и для узнавания их в кодовых базах: паттерн позволяет отправить событие когда происходит что-то значительное (отправляется заказ, регистрируется пользователь) и иметь несколько независимых слушателей реагировать (отправить письмо, обновить инвентарь, записать аналитику), каждый обрабатывая отдельное concernом.

Ключевое преимущество — **расширяемость через развязку** — вы можете добавить новую реакцию регистрацией слушателя без изменения кода, который отправляет событие, сохраняя разделение ответственности и фокус отправляющего кода.

Возможность сделать слушателей **асинхронными** (`ShouldQueue`) чтобы они выполнялись в фоне тоже важна, позволяя медленным реакциям (письма, вызовы внешних API) выполняться в фоне без задержки ответа пользователю.

Знание как работают события/слушатели, их преимущество развязки и асинхронные слушатели для фоновой обработки — ценное знание для построения хорошо структурированных, расширяемых Laravel приложений. (Как и сигналы в других фреймворках, оговорка состоит в том что события создают неявное, дальнодействующее поведение которое может быть сложнее отследить — таким образом они лучше всего используются для настоящей сквозной развязки нежели как по умолчанию для всей логики после действия, где явный код часто понятнее.)