Laravel如何与Pusher实现实时通信？（WebSocket示例）-Laravel-PHP中文网

Laravel如何与Pusher实现实时通信？（WebSocket示例）

尼克

发布： 2025-12-22 20:53:02

原创

357人浏览过

Laravel 配合 Pusher 实现实时通信本质是利用 Pusher 托管的 WebSocket 服务，通过 Laravel 广播机制将事件推送给 Pusher，前端用 Pusher JS SDK 或 Laravel Echo 订阅监听。

laravel如何与pusher实现实时通信？（websocket示例）

用 Laravel 配合 Pusher 实现实时通信，本质是借助 Pusher 托管的 WebSocket 服务，绕过自己搭建和维护 WebSocket 服务器的复杂性。Laravel 不直接处理 WebSocket 连接，而是通过事件广播机制把数据推给 Pusher，前端再通过 Pusher JS SDK 订阅频道、监听事件。

1. 安装依赖并配置广播驱动

先确保 Laravel 的广播功能已启用。修改 .env 文件，将广播驱动设为 PUSHER，并填入 Pusher 控制台获取的凭证：

BROADCAST_DRIVER=pusher
PUSHER_APP_ID=your-app-id
PUSHER_APP_KEY=your-app-key
PUSHER_APP_SECRET=your-app-secret
PUSHER_APP_CLUSTER=mt1  // 注意：不是 us2 或 eu，以控制台显示为准

登录后复制

安装官方 Pusher PHP SDK：

composer require pusher/pusher-php-server "^7.0"

登录后复制

2. 创建可广播的事件

运行命令生成事件类（比如通知用户新消息）：

php artisan make:event NewMessagePosted

登录后复制

在生成的事件类中实现 ShouldBroadcast 接口，并定义 broadcastOn() 方法指定频道（如私有频道 private-chat.{roomId}），还可设置 broadcastWith() 控制发送的数据字段。

小程序websocket用法示例

该示例将演示在原生微信小程序中使用GoEasy快速实现websocket实时通讯。

查看详情

频道名需与前端订阅的一致，且注意权限：public（公开）、private（需服务端鉴权）、presence（带用户信息的私有频道）
事件类默认使用 App\Events 命名空间，别忘了在 EventServiceProvider 中注册或使用自动发现

3. 后端触发广播

在控制器或业务逻辑中，直接 dispatch 该事件即可：

event(new NewMessagePosted($message, $roomId));
// 或
NewMessagePosted::dispatch($message, $roomId);

登录后复制

Laravel 会自动调用 Pusher SDK，把序列化后的事件数据发到对应频道。不需要手动写推送逻辑。

4. 前端监听事件（WebSocket 示例）

在页面中引入 Pusher JS SDK，并用 Laravel 的 echo 封装库（推荐）或原生 SDK 订阅：

// 使用 Laravel Echo（需 npm install --save laravel-echo pusher-js）
import Echo from 'laravel-echo';
window.Pusher = require('pusher-js');

window.Echo = new Echo({
    broadcaster: 'pusher',
    key: 'your-app-key',
    cluster: 'mt1',
    encrypted: true,
    authEndpoint: '/api/broadcasting/auth', // 私有/存在频道需要后端鉴权
});

// 监听私有频道上的事件
Echo.private(`chat.${roomId}`)
    .listen('NewMessagePosted', (e) => {
        console.log('收到新消息：', e.message);
        // 更新 UI
    });

登录后复制