Events र listeners कसरी काम गर्छन्?

Question

Accepted Answer

Laravel को **events र listeners** observer pattern लागू गर्छन् — जब कुनै महत्त्वपूर्ण कुरा हुन्छ तपाईं **event dispatch** गर्नुहुन्छ, र एक वा अधिक **listeners** यसमा प्रतिक्रिया गर्छन्। यसले कोड अलग गर्छ: event source लाई जान्न आवश्यक छैन कसले जवाफ दिन्छ, स्वच्छ 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
```

## Event dispatch गर्दै

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

Event dispatch गर्दा यसको सबै पंजीकृत listeners ट्रिगर हुन्छन्। Order-shipping कोड केवल के भएको तालिका गर्छ — यो जान्दैन (वा चिन्ता गर्दैन) कि emails, analytics, वा अन्य प्रतिक्रियाहरू हुन्छन्।

## एक event को लागि धेरै listeners (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
```

यो मुख्य लाभ हो: तपाईं event लाई dispatch गर्ने कोड न छोएर event मा नयाँ प्रतिक्रियाहरू (एक listener) थप्न सक्नुहुन्छ — स्वच्छ, विस्तारयोग्य decoupling।

## Queued listeners (async)

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

`ShouldQueue` लागू गर्दा listener queue मार्फत **asynchronously** चल्छ — त्यसैले ढिलो प्रतिक्रियाहरू (email पठाउने) प्रतिक्रियालाई ढिलाई गर्दैन।

## यो किन महत्त्वपूर्ण हो

Events र listeners अनुप्रयोगको विभिन्न भागहरूलाई कोडको कडा युग्मन बिना अवस्थितिहरूमा प्रतिक्रिया गर्न दिएर कोड **decoupling** को लागि उपयोगी Laravel विशेषता हो, जो cross-cutting प्रतिक्रियाहरू र कोड राखयोग्यताको लागि मूल्यवान हो।

यसलाई बुझ्नु codebase मा उपयोग गर्ने र पहिचान गर्न दुवै को लागि सहायक छ: प्याटर्नले तपाईंलाई event dispatch गर्न अनुमति दिन्छ जब केही महत्त्वपूर्ण हुन्छ (एक आदेश जहाज, एक प्रयोगकर्ता रेजिस्टर) र धेरै स्वतन्त्र listeners प्रतिक्रिया गर्छन् (email पठाउनुहोस्, inventory अद्यावधिक गर्नुहोस्, analytics रेकर्ड गर्नुहोस्), प्रत्येक अलग चिन्ता सम्हालने।

मुख्य लाभ **decoupling को माध्यमबाट विस्तारयोग्यता** हो — तपाईं event dispatch गर्ने कोड परिमार्जन गर्न बिना listener पंजीकरण गरेर नयाँ प्रतिक्रियाहरू थप्न सक्नुहुन्छ, चिन्ताहरू अलग राख्नुहोस् र dispatch कोड केन्द्रित राख्नुहोस्।

Listeners **queued** (`ShouldQueue`) गर्ने क्षमता ताकि तिनीहरू asynchronously चल्छन् पनि महत्त्वपूर्ण छ, ढिलो प्रतिक्रियाहरू (emails, बाहिरी API कलहरू) पृष्ठभूमिमा हुन दिइन्छ प्रयोगकर्ताको प्रतिक्रियामा ढिलाई गर्न बिना।

कसरी events/listeners काम गर्छन्, तिनीहरूको decoupling लाभ, र async प्रसंस्करणको लागि queued listeners जान्नु राम्रो-संरचित, विस्तारयोग्य Laravel अनुप्रयोगहरू निर्माण गर्न को लागि मूल्यवान ज्ञान हो। (अन्य frameworks मा संकेतहरू जस्तै, सावधानीले कि events निहित, action-at-a-distance आचरण सिर्जना गर्छन् जो ट्रेस गर्न गाह्रो हुन सक्छ — त्यसैले तिनीहरू सबै post-action तर्कको लागि डिफल्टको रूपमा सबै cross-cutting decoupling को लागि उपयोग गर्न उत्तम हुन्छन्, जहाँ स्पष्ट कोड अक्सर स्पष्ट हुन्छ।)