Events ve listeners nasıl çalışır?

Question

Accepted Answer

Laravel'in **events ve listeners** observer pattern'ini uygular — önemli bir şey olduğunda bir **event dispatch edersiniz** ve bir veya daha fazla **listener** buna tepki verir. Bu kodu ayrıştırır: event kaynağının kim tepki vereceğini bilmesi gerekmez, bu da temiz bir concern ayrılmasını sağlar.

## Event ve listener tanımlama

```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'i dispatch etme

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

Event'i dispatch etmek tüm kayıtlı listener'larını tetikler. Sipariş-kargo kodu sadece ne olduğunu açıklar — e-postaların, analitiğin veya diğer tepkilerin oluştuğunu bilmez (veya umursamaz).

## Bir event için birden fazla listener (ayrıştırma)

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

Bu ana fayda: event'i dispatch eden koda dokunmadan, event'e yeni tepkiler (bir listener) ekleyebilirsiniz — temiz, genişletilebilir ayrıştırma.

## Queued listeners (async)

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

`ShouldQueue` uygulamak, bir listener'ı queue aracılığıyla **asenkron** olarak çalıştırır — böylece yavaş tepkiler (e-posta gönderme) yanıtı geciktirmez.

## Neden önemli

Events ve listeners, kodu **ayrıştırmak** için faydalı bir Laravel özelliğidir — bir uygulamanın farklı bölümlerinin sıkı coupling olmadan olayları tetiklemesine ve buna tepki vermesine olanak tanır; bu, cross-cutting tepkiler ve kodu sürdürülebilir tutmak için değerlidir.

Onları anlamak hem onları kullanmak hem de codebase'lerde tanımak için faydalıdır: pattern, önemli bir şey olduğunda (bir sipariş gönderilir, bir kullanıcı kaydolur) bir event dispatch etmenize ve birden fazla bağımsız listener'ın tepki vermesine (e-posta gönder, envanteri güncelle, analitik kaydet) olanak tanır; her biri ayrı bir concern'i ele alır.

Ana fayda **ayrıştırma yoluyla genişletilebilirlik**tir — event'i dispatch eden kodu değiştirmeden bir listener kaydedecerek yeni tepkiler ekleyebilirsiniz; bu da concern'leri ayrılı tutar ve dispatch kodu odaklı kalır.

Listener'ların **queued** (`ShouldQueue`) olabilmesi; böylece asenkron olarak çalışması da önemlidir; bu da yavaş tepkilerin (e-postalar, dış API çağrıları) kullanıcının yanıtını geciktirmeden arka planda oluşmasını sağlar.

Event'lerin/listener'ların nasıl çalıştığını, bunların ayrıştırma faydalarını ve asenkron işleme için queued listener'ları bilmek, iyi yapılandırılmış, genişletilebilir Laravel uygulamaları oluşturmak için değerli bilgidir. (Diğer framework'lerdeki sinyallerde olduğu gibi, uyarı: event'ler takip edilmesi daha zor olan örtük, action-at-a-distance davranışı oluştururlar — bu nedenle gerçek cross-cutting ayrıştırma için en iyisidir; açık kodun genellikle daha açık olduğu tüm post-action mantığı için varsayılan olarak değil.)