events และ listeners ทำงานอย่างไร?

Question

Accepted Answer

**events และ listeners** ของ Laravel ใช้ observer pattern คุณ **dispatch event** เมื่อมีบางอย่างที่น่าสนใจเกิดขึ้น แล้ว **listener** หนึ่งตัวหรือมากกว่านั้นจะตอบสนองต่อมัน สิ่งนี้ช่วยลดการผูกติด (decouple) ของโค้ด เพราะต้นทางของ event ไม่จำเป็นต้องรู้ว่าใครเป็นผู้ตอบสนอง ทำให้แยกความรับผิดชอบ (separation of concerns) ได้อย่างชัดเจน

## การนิยาม event และ 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
```

## การ dispatch event

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

การ dispatch event จะกระตุ้น listener ที่ลงทะเบียนไว้ทั้งหมด โค้ดส่วนที่จัดส่งคำสั่งซื้อเพียงแค่ประกาศว่ามีอะไรเกิดขึ้น มันไม่รู้ (และไม่สนใจ) ว่าจะมีการส่งอีเมล การทำ analytics หรือการตอบสนองอื่น ๆ เกิดขึ้น

## หลาย listener สำหรับ event เดียว (การ decouple)

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

นี่คือประโยชน์หลัก คุณสามารถเพิ่มการตอบสนองใหม่ (listener) ให้กับ event ได้โดยไม่ต้องแตะโค้ดที่ทำการ dispatch มัน เป็นการ decouple ที่สะอาดและขยายต่อได้

## queued listeners (แบบ async)

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

การ implement `ShouldQueue` ทำให้ listener ทำงานแบบ **asynchronous** ผ่าน queue ดังนั้นการตอบสนองที่ช้า (เช่นการส่งอีเมล) จะไม่ทำให้ response ล่าช้า

## ทำไมจึงสำคัญ

events และ listeners เป็นฟีเจอร์ของ Laravel ที่มีประโยชน์สำหรับการ **decouple** โค้ด ช่วยให้ส่วนต่าง ๆ ของแอปพลิเคชันตอบสนองต่อเหตุการณ์ได้โดยไม่ผูกติดกันแน่นเกินไป ซึ่งมีค่าสำหรับการตอบสนองแบบ cross-cutting และการรักษาให้โค้ดดูแลรักษาง่าย

การเข้าใจสิ่งเหล่านี้มีประโยชน์ทั้งในการใช้งานและการจดจำรูปแบบในโค้ดเบส รูปแบบนี้ช่วยให้คุณ dispatch event เมื่อมีบางอย่างสำคัญเกิดขึ้น (เช่นคำสั่งซื้อถูกจัดส่ง ผู้ใช้สมัครสมาชิก) แล้วให้ listener อิสระหลายตัวตอบสนอง (ส่งอีเมล อัปเดตสต็อก บันทึก analytics) โดยแต่ละตัวจัดการความรับผิดชอบที่แยกจากกัน

ประโยชน์หลักคือ **ความสามารถในการขยายผ่านการ decouple** คุณสามารถเพิ่มการตอบสนองใหม่ด้วยการลงทะเบียน listener โดยไม่ต้องแก้ไขโค้ดที่ dispatch event เป็นการแยกความรับผิดชอบและทำให้โค้ดที่ทำการ dispatch โฟกัสได้

ความสามารถในการทำให้ listener เป็นแบบ **queued** (`ShouldQueue`) เพื่อให้ทำงานแบบ asynchronous ก็สำคัญเช่นกัน ช่วยให้การตอบสนองที่ช้า (อีเมล การเรียก API ภายนอก) เกิดขึ้นใน background โดยไม่ทำให้ response ของผู้ใช้ล่าช้า

การรู้ว่า events/listeners ทำงานอย่างไร ประโยชน์ของการ decouple และ queued listeners สำหรับการประมวลผลแบบ async เป็นความรู้ที่มีค่าสำหรับการสร้างแอปพลิเคชัน Laravel ที่มีโครงสร้างดีและขยายต่อได้ (เช่นเดียวกับ signals ในเฟรมเวิร์กอื่น ข้อควรระวังคือ events สร้างพฤติกรรมที่เกิดขึ้นโดยอ้อมและจากระยะไกล (action-at-a-distance) ซึ่งอาจติดตามได้ยากกว่า ดังนั้นจึงควรใช้สำหรับการ decouple แบบ cross-cutting จริง ๆ มากกว่าการใช้เป็นค่าเริ่มต้นสำหรับลอจิกหลังการกระทำทั้งหมด ซึ่งการเขียนโค้ดอย่างชัดเจนมักจะชัดเจนกว่า)