Conas a oibríonn imeachtaí agus éisteoirí?

Question

Accepted Answer

Cuireann **imeachtaí agus éisteoirí** Laravel an patrún observer i bhfeidhm — **díchealann tú imeacht** nuair a tharlaíonn rud suntasach, agus **éisteoirí** ar leith nó níos mó ag freagairt dó. Scarann sé seo an cód: ní chaithfidh foinse an imeachta a bheith ar an eolas cé a fhreagróidh, rud a fhéadann scaradh geal a dhéanamh ar imní.

## Imeacht agus éisteoir a shainmhíniú

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

## An imeacht a dhíchealadh

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

Díchealú an imeachta a spreagann a chuid éisteoirí cláraithe ar fad. Ní dhéanann an cód socrú ord ach a fhógairt go tharla - ní bhíonn fios aici (ná doilíonn sé di) go dtarlaíonn ríomhphoist, anailísíochta, nó freagraí eile.

## Éisteoirí iolracha do imeacht amháin (scaradh)

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

Is é seo an buntáiste príomha: is féidir leat freagraí nua (éisteoir) a chur leis an imeacht gan an cód a dhíchealann a bheith i dteagmháil leis - scaradh geal agus infheidhmeach.

## Éisteoirí soitheach (neamhshéanach)

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

A chur i bhfeidhm `ShouldQueue` a dhéanann éisteoir a rith **go neamhshéanach** trí an fhile - mar sin ní bhíonn freagraí mall (ríomhphoist a sheoladh) ag déanamh dúil sa fhreagra.

## Cén fáth a bhíonn tábhacht ann

Is gné úsáideach de Laravel iad imeachtaí agus éisteoirí chun cód a **scaradh** - rud a ligeann do ghné éagsúla de fheidhmchlár ar tharluithe a freagairt gan greadam dlúth, ar rud ina bhfuil luach do fhreagraí trasghearrthach agus cad atá i ndán do choimeád cód in ord.

Tá sé cabhrach dóibh tuiscint a fháil cén fáth a bhíonn siad ann agus gan iad a aithint i mbunchair: ligeann an patrún duit imeacht a dhíchealadh nuair a tharlaíonn rud tábhachtach (ordú a sheoltar, úsáideoir a clárú) agus gur féidir le héisteoirí neamhspleácha ar leith freagairt (ríomhphoist a sheoladh, fardal a nuashonrú, anailísíochta a thaifeadadh), gach ceann ag déanamh imní ar leith.

Is é an príomhbhuntáiste **extensibility trí scaradh** - is féidir leat freagraí nua a chur leis trí éisteoir a clárú gan an cód a dhíchealann an imeacht a athrú, imní scartha agus cód díchealaithe ar fhócas.

Tá tábhacht ar leith ag gabháil le cumas éisteoirí a dhéanamh **soitheach** (`ShouldQueue`) ionas go rithfidh siad go neamhshéanach, rud a ligeann do fhreagraí mall (ríomhphoist, glaonna API sheachtrach) a tharla san spriobadh gan oiread is a dhéanamh dúil i bhfreagra an úsáideora.

Is eolas luachmhar do fheidhmchláir Laravel a bhíonn breá-struchtúrtha agus infheidhmeach a thógáil imeachtaí/éisteoirí a oibríonn, a bhuntáiste scaradh, agus éisteoirí soitheach chun próiseála neamhshéanach a chur ar fáil. (Mar atá i gcomharthaí i bhfreamh eile, an caomhnú agus imeachtaí a bhíonn i gcruth a dhéanann gníomh-ar-fad-i-bhfad ar iompar nach bhfuil róbhog ar a rianú - ar an chúis seo, is fearr iad a úsáid do scaradh trasghearrthach fíor seachas mar dhéfailt do gach logainm-gníomh, nuair a bhíonn cód follasach i bhfad níos soiléire go minic.)