كيف تعمل الأحداث والمستمعون؟

Question

Accepted Answer

تطبق **الأحداث والمستمعون** في Laravel نمط المراقب — عندما يحدث شيء مهم، تقوم **بإرسال حدث**، وواحد أو أكثر من **المستمعين** يتفاعل معه. هذا يفصل الكود: مصدر الحدث لا يحتاج إلى معرفة من سيرد عليه، مما يتيح فصلاً نظيفاً للمسؤوليات.

## تعريف الحدث والمستمع

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

## إرسال الحدث

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

إرسال الحدث يفعّل جميع المستمعين المسجلين له. كود شحن الطلب يعلن فقط ما حدث — لا يعرف (ولا يهمه) أن رسائل بريدية أو تحليلات أو ردود فعل أخرى تحدث.

## عدة مستمعين لحدث واحد (فصل الكود)

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

هذه هي الفائدة الأساسية: يمكنك إضافة ردود فعل جديدة (مستمع) لحدث دون لمس الكود الذي يرسله — فصل نظيف وقابل للتوسع.

## المستمعون المصفوفون (غير متزامن)

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

تطبيق `ShouldQueue` يجعل المستمع يعمل **بشكل غير متزامن** عبر الطابور — بحيث لا تؤخر ردود الفعل البطيئة (إرسال البريد) الاستجابة.

## لماذا يهم هذا

الأحداث والمستمعون هي ميزة مفيدة في Laravel **لفصل الكود** — السماح لأجزاء مختلفة من التطبيق بالتفاعل مع الأحداث دون ربط وثيق، وهذا قيّم للتفاعلات الشاملة والحفاظ على سهولة صيانة الكود.

فهمها مفيد لكل من استخدامها والتعرف عليها في قواعد الكود: النمط يتيح لك إرسال حدث عندما يحدث شيء مهم (شحن طلب، تسجيل مستخدم) وجعل عدة مستمعين مستقلين يتفاعلون (إرسال بريد، تحديث المخزون، تسجيل التحليلات)، كل منهم يتعامل مع مسؤولية منفصلة.

الفائدة الأساسية هي **التوسيع من خلال الفصل** — يمكنك إضافة ردود فعل جديدة بتسجيل مستمع دون تعديل الكود الذي يرسل الحدث، مما يحافظ على فصل المسؤوليات ويركز الكود على المرسل.

القدرة على جعل المستمعين **مصفوفين** (`ShouldQueue`) بحيث يعملون بشكل غير متزامن مهمة أيضاً، مما يتيح للتفاعلات البطيئة (رسائل البريد، استدعاءات API الخارجية) أن تحدث في الخلفية دون تأخير استجابة المستخدم.

معرفة كيف تعمل الأحداث والمستمعون، وفائدة الفصل، والمستمعون المصفوفون للمعالجة غير المتزامنة هي معرفة قيمة لبناء تطبيقات Laravel منظمة وقابلة للتوسع. (كما هو الحال مع الإشارات في الأطر الأخرى، التحذير هو أن الأحداث تخلق سلوكاً ضمنياً وتأثيراً على مسافة يمكن أن يكون من الصعب تتبعه — لذا يُستخدم بشكل أفضل للفصل الحقيقي الشامل بدلاً من استخدامه كخيار افتراضي لجميع منطق ما بعد الإجراء، حيث يكون الكود الصريح غالباً أوضح.)