Kaip veikia įvykiai ir klausytojai?

Question

Accepted Answer

Laravel'io **įvykiai ir klausytojai** įgyvendina stebėtojo šabloną — jūs **dispatch'iniate įvykį**, kai nutinka kažkas reikšmingo, ir vienas ar daugiau **klausytojų** į tai reaguoja. Tai atriša kodą: įvykio šaltinis nereikalauja žinoti, kas reaguoja, todėl leidžiama nuodugniai atskirti concerns'us.

## Įvykio ir klausytojo apibrėžimas

```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
```

## Įvykio dispatch'inimas

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

Dispatch'iniant įvykį suaktyvinami visi jo registruoti klausytojai. Užsakymo siuntimo kodas tiesiog skelbia, kas įvyko — jis nežino (ir neperima), kad vyksta el. laiškai, analitika ar kiti atsakai.

## Keli vieno įvykio klausytojai (atriša kodą)

```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
```

Tai yra pagrindinė nauda: galite pridėti naujus atsakus (klausytoją) į įvykį neliesdami kodo, kuris jį dispatch'ina — švariai, plečiamoje atriština.

## Eilės klausytojai (asinchroninis)

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

`ShouldQueue` įgyvendinimas klausytoją paleidžia **asinchroniškai** per eilę — todėl lėti atsakai (el. laiško siuntimas) nepavėluoja atsakymo.

## Kodėl tai svarbu

Įvykiai ir klausytojai yra naudinga Laravel savybė **kod atriši** — leisdami skirtingoms programos dalims reaguoti į įvykius be tvirtų ryšių, kurie yra vertingi skersai einantiems atsakams ir kodo palaikymui.

Jų supratimas yra naudingas tiek juos naudojant, tiek jų atpažinus kodų bazėse: šablonas leidžia dispatch'inti įvykį, kai nutinka kažkas reikšmingo (užsakymas išsiųstas, vartotojas registruojasi) ir turėti kelis nepriklausomus klausytojus reaguojant (siųsti laišką, atnaujinti atsargas, įrašyti analitikos duomenis), kiekvienas sprendžiant atskirą problemą.

Pagrindinė nauda yra **išplečiamumas atriše** — galite pridėti naujus atsakus registruodami klausytoją be kodo, kuris dispatch'ina įvykį, modifikavimo, nuo to laikydami concerns'us atskirtus ir dispatch'inimo kodą sukoncentruotą.

Galimybė padaryti klausytojus **eilės** (`ShouldQueue`), kad jie veiktų asinchroniškai, taip pat svarbi, leisdama lėtiems atsakams (el. laiškai, išoriniai API skambučiai) vykti fone nesutrukdant vartotojo atsakymui.

Žinojimas, kaip veikia įvykiai/klausytojai, jų atriši naudą ir eilės klausytojus asinchroniškam apdorojimui, yra vertinga žinia norint kurti gerai struktūrizuotas, išplečiamas Laravel aplikacijas. (Kaip ir signalai kitose sistemose, pastaba yra ta, kad įvykiai kuria numanimus, tolimosios nuotolio veiksmų sąlygas, kurias gali būti sunkiau seka — todėl geriausia jus naudoti tikriems skersai ejantiems atriši, o ne kaip numatytuosius visos veiksmų po-loginės, kur aiškus kodas dažnai yra aiškesnis.)