如何使用Laravel Reverb替代Pusher实现WebSocket通信？ (自托管方案)

Reverb 能直接替代 Pusher 客户端逻辑，因其完全兼容 Pusher 协议与 SDK 行为，前端只需修改连接参数（如 wsHost、wsPort、authEndpoint）并保持 new Pusher(…) 初始化方式即可无缝对接。

为什么 Reverb 能直接替代 Pusher 的客户端逻辑

Reverb 是 laravel 官方推出的自托管 websocket 服务器，它完全兼容 Pusher 的 WebSocket 协议和客户端 SDK 行为。这意味着你不需要重写前端 Pusher 实例初始化代码，只需改掉 key、wsHost、wsPort 等连接参数，就能让现有 pusher-js 无缝对接 Reverb 服务。

关键前提是：Reverb 启动后默认暴露与 Pusher 兼容的 WebSocket 接口（/app/{key}），且支持 ws:// 和 wss://，也支持 TLS 终止后的代理转发（如 nginx）。

• 前端仍用 new Pusher(...)，但 cluster 字段可留空或设为任意值（Reverb 不校验 cluster）
• authEndpoint 必须指向你的 Laravel 应用中带 reverb:auth 中间件的路由（如 /api/broadcasting/auth）
• 确保 BROADCAST_CONNECTION=reverb 已在 .env 中设置，否则 Laravel 广播事件不会发往 Reverb

如何配置 Reverb 服务端并启动

Reverb 不依赖 redis Pub/Sub 做消息中转（它自己就是广播总线），但需要 Redis 存储连接元数据和认证状态。安装后必须显式运行 php artisan reverb:start 启动独立进程 —— 这不是 Artisan 命令行工具，而是一个常驻的 swoole 服务器。

常见疏漏点：

• REVERB_HOST 和 REVERB_PORT 必须与前端连接地址一致；若走 Nginx 反代，REVERB_HOST 应设为 0.0.0.0，Nginx 配置 proxy_pass http://127.0.0.1:8000（假设 Reverb 监听 8000）
• REVERB_ssl_CERT 和 REVERB_SSL_KEY 仅在启用 wss:// 时需要；若由 Nginx 终止 TLS，则 Reverb 只需监听 ws://（即不填这两个变量）
• 务必执行 php artisan vendor:publish --tag=reverb-config 生成 config/reverb.php，否则 reverb:start 会因缺少配置失败

前端 Pusher 初始化要改哪些参数

原 Pusher 初始化通常类似：

const pusher = new Pusher('app-key', {   cluster: 'mt1',   encrypted: true, });

换成 Reverb 后，核心变化是去掉 cluster、显式指定 host/port、关闭加密自动协商（因为 wss/ws 由你控制）：

const pusher = new Pusher('your-reverb-app-key', {   wsHost: 'your-domain.com',   wsPort: 6001,   wssPort: 6001,   forceTLS: true, // 若 Nginx 终止 TLS，这里设 true；若 Reverb 自己跑 wss，则也设 true   disableStats: true,   authEndpoint: '/api/broadcasting/auth', });

注意：wsPort 和 wssPort 数值相同是允许的，forceTLS 为 true 时，pusher-js 会自动用 wss:// 协议连接。

• your-reverb-app-key 必须与 config/broadcasting.php 中 reverb 驱动的 key 一致
• authEndpoint 返回的响应格式必须严格符合 Pusher 协议（{ "auth": "xxx:xxx" }），Reverb 的 reverb:auth 中间件已内置该逻辑
• 若浏览器报 WebSocket connection to 'wss://...' failed，优先检查 Nginx 是否透传了 Upgrade 和 Connection 头

如何验证 Reverb 是否正常收发事件

最直接的方式是用 php artisan tinker 手动触发一个广播事件，同时用浏览器开发者工具的 Network → WS 标签观察连接状态和消息收发。

例如，定义一个测试事件：

class TestEvent implements ShouldBroadcast {     use Dispatchable, InteractsWithSockets, SerializesModels;      public function broadcastOn(): array     {         return [new channel('test-channel')];     }      public function broadcastAs(): string     {         return 'test-event';     } }

然后在 tinker 中执行：

event(new AppEventsTestEvent());

如果前端已订阅 test-channel，且控制台能看到 test-event 消息，说明链路通了。

• Reverb 日志默认输出到 storage/logs/reverb.log，连接拒绝、鉴权失败等错误都在这里；权限问题（如 Redis 连接失败）会导致 reverb:start 启动瞬间退出，无日志 —— 此时加 --verbose 参数重试
• 不要依赖 php artisan serve 来跑 Reverb；它必须作为独立进程运行，且与 Laravel 应用共享同一份 .env
• 生产环境务必用 Supervisor 或 systemd 管理 php artisan reverb:start 进程，否则终端关闭就断了