Laravel 中的实时广播是如何工作的？

Question

Accepted Answer

Laravel **广播（broadcasting）**通过 WebSockets 将服务器端事件推送到浏览器来实现**实时**功能（实时通知、聊天、实时更新）。它通过在 WebSocket 连接上广播 Laravel 事件来工作，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** 来订阅通道并在事件到达时运行代码——实时更新 UI 而无需轮询。

## 通道类型和身份验证

```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** 订阅通道并对事件做出反应，实时更新 UI 而无需低效的轮询。

理解架构（事件通过 WebSocket 通道广播、客户端上的 Echo）、WebSocket 服务器选项（第一方 **Reverb**、托管的 **Pusher** 或自托管 Soketi）以及**通道类型**（用于公开数据的公开通道、用于用户特定数据的带授权的私有通道和用于跟踪在线用户的在线状态）是构建实时功能的高级知识。

由于实时、交互式体验在现代应用程序中日益期待，而且 Laravel 提供了一个优雅的系统，将后端事件连接到实时前端更新，了解广播如何工作对于构建响应式、实时功能（聊天、通知、实时更新、在线状态）很有价值，这些功能区分了现代、引人入胜的应用程序——这是当代 Web 开发中越来越相关的能力。