Bagaimanakah event dan listener berfungsi?

Question

Accepted Answer

**Event dan listener** Laravel melaksanakan corak observer — anda **mendispatch sesuatu event** apabila sesuatu yang penting berlaku, dan satu atau lebih **listener** bertindak balas kepadanya. Ini memisahkan kod: sumber event tidak perlu tahu siapa yang bertindak balas, membolehkan pemisahan kebimbangan yang bersih.

## Mentakrifkan 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 mencetuskan semua listener yang didaftarkan untuknya. Kod penghantaran pesanan hanya mengumumkan apa yang berlaku — ia tidak tahu (atau peduli) bahawa e-mel, analitik, atau tindak balas lain berlaku.

## Berbilang listener untuk satu event (pemisahan)

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

Inilah manfaat utama: anda boleh menambah tindak balas baru (sebuah listener) kepada event tanpa menyentuh kod yang mendispatchnya — pemisahan yang bersih dan boleh diperluas.

## Listener ber-queue (async)

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

Melaksanakan `ShouldQueue` menjadikan sesuatu listener berjalan **secara asinkron** melalui queue — jadi tindak balas yang lambat (menghantar e-mel) tidak melambatkan respons.

## Mengapa ia penting

Event dan listener ialah ciri Laravel yang berguna untuk **memisahkan** kod — membolehkan bahagian aplikasi yang berbeza bertindak balas kepada kejadian tanpa pasangan ketat, yang berharga untuk tindak balas rentas-potong dan mengekalkan kod yang mudah diselenggara.

Memahaminya membantu kedua-dua menggunakannya dan mengecaminya dalam pangkalan kod: corak ini membolehkan anda mendispatch event apabila sesuatu yang penting berlaku (pesanan dihantar, pengguna mendaftar) dan mempunyai berbilang listener bebas bertindak balas (menghantar e-mel, mengemas kini inventori, merekod analitik), setiap satu mengendalikan kebimbangan berasingan.

Manfaat utama ialah **kebolehluasan melalui pemisahan** — anda boleh menambah tindak balas baru dengan mendaftarkan listener tanpa mengubah kod yang mendispatch event, mengekalkan kebimbangan terpisah dan kod penghantaran tertumpu.

Keupayaan untuk menjadikan listener **ber-queue** (`ShouldQueue`) supaya ia berjalan secara asinkron juga penting, membolehkan tindak balas yang lambat (e-mel, panggilan API luaran) berlaku di latar belakang tanpa melambatkan respons pengguna.

Mengetahui cara event/listener berfungsi, manfaat pemisahannya, dan listener ber-queue untuk pemprosesan async adalah pengetahuan berharga untuk membina aplikasi Laravel yang berstruktur baik dan boleh diperluas. (Seperti dengan signal dalam rangka kerja lain, kaveatnya ialah event mencipta tingkah laku implisit dan bertindak-dari-jauh (action-at-a-distance) yang boleh lebih sukar dijejaki — jadi ia paling baik digunakan untuk pemisahan rentas-potong yang tulen dan bukannya sebagai lalai untuk semua logik selepas-tindakan, di mana kod eksplisit selalunya lebih jelas.)