Bagaimana cara kerja events dan listeners?

Question

Accepted Answer

**Events dan listeners** Laravel mengimplementasikan observer pattern — Anda **dispatch sebuah event** ketika sesuatu yang penting terjadi, dan satu atau lebih **listeners** bereaksi terhadapnya. Ini melonggarkan coupling: sumber event tidak perlu tahu siapa yang merespons, memungkinkan pemisahan concerns yang bersih.

## Mendefinisikan sebuah event dan 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
```

## Mendispatch event

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

Mendispatch event memicu semua listeners yang terdaftar. Kode pengiriman pesanan hanya mengumumkan apa yang terjadi — kode tersebut tidak tahu (atau tidak peduli) bahwa email, analytics, atau reaksi lainnya terjadi.

## Beberapa listeners untuk satu event (decoupling)

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

Ini adalah manfaat utama: Anda dapat menambahkan reaksi baru (sebuah listener) ke event tanpa mengubah kode yang mendispatchnya — decoupling yang bersih dan extensible.

## Queued listeners (async)

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

Mengimplementasikan `ShouldQueue` membuat listener berjalan **secara asynchronous** melalui queue — sehingga reaksi yang lambat (mengirim email) tidak menunda response.

## Mengapa ini penting

Events dan listeners adalah fitur Laravel yang berguna untuk **decoupling** kode — memungkinkan bagian-bagian berbeda dari aplikasi bereaksi terhadap kejadian tanpa tight coupling, yang sangat berharga untuk reaksi cross-cutting dan menjaga kode tetap maintainable.

Memahami mereka sangat membantu baik untuk menggunakannya maupun mengenalinya dalam codebases: pattern ini memungkinkan Anda mendispatch event ketika sesuatu yang signifikan terjadi (pesanan dikirim, pengguna mendaftar) dan memiliki beberapa independent listeners bereaksi (mengirim email, memperbarui inventory, merekam analytics), masing-masing menangani concern yang terpisah.

Manfaat utamanya adalah **extensibility melalui decoupling** — Anda dapat menambahkan reaksi baru dengan mendaftarkan listener tanpa memodifikasi kode yang mendispatch event, menjaga concerns tetap terpisah dan kode dispatch tetap fokus.

Kemampuan untuk membuat listeners **queued** (`ShouldQueue`) sehingga berjalan secara asynchronous juga penting, memungkinkan reaksi yang lambat (email, external API calls) terjadi di background tanpa menunda response pengguna.

Mengetahui bagaimana events/listeners bekerja, manfaat decoupling mereka, dan queued listeners untuk async processing adalah pengetahuan berharga untuk membangun aplikasi Laravel yang well-structured dan extensible. (Seperti signals di framework lain, caveat-nya adalah bahwa events menciptakan implicit, action-at-a-distance behavior yang bisa lebih sulit dilacak — jadi sebaiknya digunakan untuk genuine cross-cutting decoupling daripada sebagai default untuk semua post-action logic, di mana explicit code sering lebih jelas.)