Come funzionano gli eventi e i listener?

Question

Accepted Answer

L'implementazione di **eventi e listener** in Laravel segue il pattern observer — **dispatchi un evento** quando accade qualcosa di significativo, e uno o più **listener** reagiscono ad esso. Questo disaccoppia il codice: la fonte dell'evento non ha bisogno di sapere chi risponde, permettendo una netta separazione delle responsabilità.

## Definire un evento e un listener

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

## Dispatchare l'evento

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

Dispatchare l'evento attiva tutti i suoi listener registrati. Il codice di spedizione dell'ordine semplicemente annuncia ciò che è accaduto — non sa (e non gli importa) che email, analytics, o altre reazioni avvengono.

## Più listener per un evento (disaccoppiamento)

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

Questa è il vantaggio chiave: puoi aggiungere nuove reazioni (un listener) a un evento senza toccare il codice che lo dispatcha — disaccoppiamento pulito ed estensibile.

## Listener in coda (asincrono)

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

Implementare `ShouldQueue` fa eseguire un listener **asincronamente** tramite la coda — quindi le reazioni lente (invio email) non ritardano la risposta.

## Perché è importante

Gli eventi e i listener sono una funzionalità utile di Laravel per **disaccoppiare** il codice — permettendo a parti diverse dell'applicazione di reagire agli eventi senza accoppiamento stretto, il che è prezioso per reazioni trasversali e per mantenere il codice manutenibile.

Comprendere come funzionano è utile sia per utilizzarli che per riconoscerli nei codebase: il pattern ti permette di dispatchare un evento quando accade qualcosa di significativo (un ordine viene spedito, un utente si registra) e avere più listener indipendenti che reagiscono (inviare email, aggiornare l'inventario, registrare analytics), ciascuno gestendo una responsabilità separata.

Il vantaggio principale è l'**estensibilità attraverso il disaccoppiamento** — puoi aggiungere nuove reazioni registrando un listener senza modificare il codice che dispatcha l'evento, mantenendo le responsabilità separate e il codice di dispatch focalizzato.

La possibilità di rendere i listener **in coda** (`ShouldQueue`) affinché vengono eseguiti asincronamente è importante, permettendo reazioni lente (email, chiamate API esterne) di avvenire in background senza ritardare la risposta dell'utente.

Sapere come funzionano gli eventi/listener, il loro vantaggio di disaccoppiamento, e i listener in coda per l'elaborazione asincrona è una conoscenza preziosa per costruire applicazioni Laravel ben strutturate ed estensibili. (Come con i signal in altri framework, la considerazione è che gli eventi creano comportamenti impliciti di action-at-a-distance che possono essere più difficili da tracciare — quindi è meglio usarli per un genuino disaccoppiamento trasversale piuttosto che come default per tutta la logica post-azione, dove il codice esplicito è spesso più chiaro.)