Kako delujejo dogodki in poslušalci?

Question

Accepted Answer

Laravelovi **dogodki in poslušalci** izvajajo vzorec opazovalca — **odproslužite dogodek**, ko se zgodi kaj pomembnega, in en ali več **poslušalcev** se na to odzove. To odklaplja kodo: vir dogodka ne mora vedeti, kdo se odziva, kar omogoča čisto ločitev skrbi.

## Definiranje dogodka in poslušalca

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

## Odprošljanje dogodka

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

Odprošljanje dogodka sproži vse njegove registrirane poslušalce. Koda za pošiljanje naročil le sporoči, kaj se je zgodilo — ne ve (in ji ni vseeno), da se dogajajo e-pošte, analitika ali drugi odgovori.

## Več poslušalcev za en dogodek (odklapljanje)

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

To je ključna prednost: novim odzivom (poslušalcu) se lahko dodate dogodek brez dotikanja kode, ki ga odprošlja — čisto, razširljivo odklapljanje.

## Poslušalci v čakalni vrsti (asinkreno)

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

Izvajanje `ShouldQueue` povzroči, da se poslušalec izvaja **asinkreno** prek čakalne vrste — počasni odgovori (pošiljanje e-pošte) zato ne zamudijo odziva.

## Zakaj je to pomembno

Dogodki in poslušalci so uporabna Laravelova funkcionalnost za **odklapljanje** kode — omogočajo različnim delom aplikacije, da se odzovejo na dogodke brez tesne povezanosti, kar je dragoceno za prečne odgovore in za vzdrževanje kode.

Razumevanje tega je koristno tako za uporabo kot za prepoznavanje v kodni bazi: vzorec omogoča, da odproslužite dogodek, ko se zgodi kaj pomembnega (naročilo se odpremi, uporabnik se registrira), in da se na to odzove več neodvisnih poslušalcev (pošlje e-pošto, posodobi zalogo, zabeleži analitiko), od katerih vsak obdeluje ločeno skrb.

Ključna prednost je **razširljivost skozi odklapljanje** — nove odgovore lahko dodate z registracijo poslušalca brez spreminjanja kode, ki odprošlja dogodek, saj se s tem ločijo skrbi in se koda za odprošljanje osredotoči.

Možnost, da se poslušalci **postavijo v čakalno vrsto** (`ShouldQueue`) in se izvajajo asinkreno, je prav tako pomembna, saj omogoči počasne odgovore (e-pošta, zunanji klici API-ja), da se zgodijo v ozadju brez zamude odziva uporabnika.

Znanje, kako delujejo dogodki/poslušalci, njihova prednost odklapljanja in poslušalci v čakalni vrsti za asinkreno obdelavo, je dragoceno znanje za izgradnjo dobro strukturiranih, razširljivih Laravelovih aplikacij. (Kot pri signalih v drugih ogrodjih je opozorilo, da dogodki ustvarjajo implicitno vedenje na daljavo, ki ga je težje slediti — zato se jih najbolje uporabi za pravo prečno odklapljanje in ne kot privzeto za vso logiko po dejanju, kjer je pogosto jasnejša eksplicitna koda.)