كيف يعمل البث المباشر (Real-time Broadcasting) في Laravel؟

Question

Accepted Answer

يُمكّن **البث** (broadcasting) في Laravel من **الميزات المباشرة** (live notifications، الدردشة، التحديثات المباشرة) عن طريق دفع أحداث من جانب الخادم إلى المتصفح عبر WebSockets. يعمل من خلال بث أحداث Laravel عبر اتصال WebSocket، حيث يشترك عملاء JavaScript فيها ويستجيبون لها — مما يربط أحداث الواجهة الخلفية بالواجهة الأمامية في الوقت الفعلي.

## البنية المعمارية

```text
Server event (e.g. MessageSent) → broadcast over a WebSocket channel →
  client JS (Laravel Echo) listening on that channel receives it → updates the UI live.

WebSocket server options:
  ✓ Laravel Reverb (first-party, self-hosted WebSocket server)
  ✓ Pusher (hosted service)
  ✓ Soketi (open-source, self-hosted)
```

## بث حدث من الخادم

```php
<?php
class MessageSent implements ShouldBroadcast {       // mark the event to broadcast
    public function __construct(public Message $message) {}

public function broadcastOn(): Channel {
        return new PrivateChannel('chat.' . $this->message->room_id);   // the channel
    }
}

// dispatch it — it's sent to subscribed clients over WebSockets
MessageSent::dispatch($message);
```

الحدث الذي ينفذ `ShouldBroadcast` يتم دفعه عبر قناة WebSocket عند إطلاقه. تحدد `broadcastOn()` القناة — عامة، **خاصة** (تتطلب مصادقة)، أو الحضور (من متصل بالإنترنت).

## الاستماع على جانب العميل (Laravel Echo)

```js
// Laravel Echo — the JS library that subscribes to channels
Echo.private(`chat.${roomId}`)
    .listen('MessageSent', (e) => {
        addMessageToUI(e.message);     // react in real time when the event arrives
    });

// presence channels — track who's online
Echo.join(`room.${roomId}`)
    .here(users => ...)        // currently present users
    .joining(user => ...).leaving(user => ...);
```

يستخدم العميل **Laravel Echo** للاشتراك في القنوات وتشغيل الكود عندما تصل الأحداث — تحديث الواجهة مباشرة دون الاضطرار إلى الاستقصاء (polling).

## أنواع القنوات والمصادقة

```text
Public channel   → anyone can listen
Private channel  → requires authorization (defined in channels.php) — for user-specific data
Presence channel → private + tracks who's currently subscribed (online users)
```

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

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

فهم هذا مفيد لبناء تطبيقات تفاعلية حديثة يتوقعها المستخدمون بشكل متزايد.

الأناقة في نهج Laravel هي أنه **يربط أحداث الواجهة الخلفية الموجودة بالفعل إلى الواجهة الأمامية في الوقت الفعلي**: تحدد حدثًا كـ `ShouldBroadcast`، وتطلقه كالمعتاد، وسيتم دفعه عبر WebSockets إلى العملاء المشتركين — بحيث تتكامل الميزات المباشرة بشكل طبيعي مع كود Laravel الموجه للأحداث العادي.

على جانب العميل، يشترك **Laravel Echo** في القنوات ويستجيب للأحداث، محدثًا الواجهة مباشرة دون الاستقصاء غير الفعال.

فهم البنية المعمارية (أحداث تُبث عبر قنوات WebSocket، Echo على جانب العميل)، وخيارات خادم WebSocket (الأداة الأولى **Reverb**، المستضافة **Pusher**، أو Soketi المستضافة ذاتيًا)، و**أنواع القنوات** (عامة، خاصة مع التفويض لبيانات خاصة بالمستخدم، والحضور لتتبع المستخدمين المتصلين) هو معرفة مهمة على مستوى الخبرة لبناء الميزات المباشرة.

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