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 App\Events\TestEvent());
如果前端已订阅 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进程，否则终端关闭就断了
