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

用 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() 控制发送的数据字段。
- 频道名需与前端订阅的一致,且注意权限:public(公开)、private(需服务端鉴权)、presence(带用户信息的私有频道)
- 事件类默认使用
AppEvents命名空间,别忘了在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 });
- 若用 private 或 presence 频道,需在
routes/channels.php中定义授权逻辑(返回 true 或数组形式的用户数据) - 确保前端 key、cluster 和 .env 中完全一致,否则连接失败且无明显报错
- 开发时打开 Pusher Debug Console(控制台 → Demo Console)可实时看到事件是否成功发出和被接收
基本上就这些。不复杂但容易忽略细节,比如集群填错、频道名大小写不一致、没开鉴权 路由,都会导致“前端收不到”。跑通一次后,增删频道和事件就是复制粘贴的事了。
以上就是 Laravel 如何与 Pusher 实现实时通信?(WebSocket 示例)的详细内容,更多请关注 php 中文网其它相关文章!