Jak fungují události a posluchači?

Question

Accepted Answer

Laravel's **events and listeners** implementují observer pattern — **dispatch** event když se stane něco důležitého, a jeden nebo více **posluchačů** na něj reaguje. To odděluje kód: zdroj události nemusí vědět, kdo reaguje, což umožňuje čistý oddělení zodpovědnosti.

## Definování události a posluchače

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

## Odeslání události

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

Odeslání události spustí všechny její registrované posluchače. Kód zasílající objednávky jen oznámí, co se stalo — neví (a nezajímá ho), že dochází k odesílání e-mailů, analýze nebo jiným reakcím.

## Více posluchačů pro jednu událost (oddělení)

```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 klíčová výhoda: můžete přidat nové reakce (posluchače) k události bez zásahu do kódu, který ji odesílá — čisté, rozšiřitelné oddělení.

## Zařazení posluchačů do fronty (async)

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

Implementace `ShouldQueue` způsobí, že se posluchač spustí **asynchronně** přes frontu — pomalé reakce (odesílání e-mailu) tedy nezpozdí odpověď.

## Proč je to důležité

Události a posluchači jsou užitečná funkce Laravel pro **oddělení** kódu — umožňují různým částem aplikace reagovat na výskyty bez těsné vazby, což je cenné pro cross-cutting reakce a udržování kódu v dobré kondici.

Rozmět je užitečné jak pro jejich používání, tak pro jejich rozpoznávání v kódových základnách: pattern vám umožňuje dispatch event když se stane něco významného (objednávka se odešle, uživatel se zaregistruje) a mít více nezávislých posluchačů, kteří reagují (odeslat e-mail, aktualizovat inventář, zaznamenat analytiku), přičemž každý zpracovává samostatný aspekt.

Klíčová výhoda je **rozšiřitelnost prostřednictvím oddělení** — můžete přidat nové reakce registrací posluchače bez úpravy kódu, který event odesílá, čímž si udržíte aspekty oddělené a odesílací kód zaměřený.

Schopnost zařadit posluchače do fronty (`ShouldQueue`) aby běželi asynchronně je také důležitá, umožňuje pomalým reakcím (e-maily, volání externích API) běžet na pozadí bez zpoždění odpovědi uživateli.

Znalost, jak fungují events/listeners, jejich výhody v oddělení a zařazení posluchačů do fronty pro async zpracování, je cenná znalost pro vytváření dobře strukturovaných, rozšiřitelných Laravel aplikací. (Stejně jako u signálů v jiných frameworcích, caveat spočívá v tom, že events vytvářejí implicitní chování na dálku, které je těžší sledovat — takže se nejlépe používají pro opravdové cross-cutting oddělení spíše než jako default pro veškerou logiku po akci, kde je explicitní kód často jasnější.)