Laravel集成Pusher实现WebSocket教程 PHP实时推送插件使用方法-js教程-PHP中文网

pusher 是第三方 websocket 服务，laravel 仅通过广播系统推送事件；本地 http 可连因浏览器放行 localhost，上线需 wss://；nginx/apache 需透传 upgrade 和 connection 头；.env 中 pusher_scheme=http 无效，前端须设 forcetls: true；广播失败常见原因包括：broadcastserviceprovider 未正确注册、broadcast_driver 配置错误、事件类未实现 shouldbroadcast、私有频道鉴权路由误用 web 中间件、auth 响应格式不符、频道名不一致、前端 key 未用 mix_ 前缀、三处 pusher 配置未对齐。

laravel集成pusher实现websocket教程 php实时推送插件使用方法

Pusher 不是 Laravel 的 WebSocket 插件，Laravel 本身不运行 WebSocket 服务器；它只是通过广播系统把事件推给 Pusher 托管的 WebSocket 服务。前端用 pusher-js 或 Laravel Echo 连接 Pusher 的 wss:// 端点，不是连你自己的 PHP 进程。

为什么本地 HTTP 能连上 Pusher，但上线就报 SecurityError？

现代浏览器强制要求 WebSocket 在非 localhost 域名下必须走 wss://（即 HTTPS + WebSocket）。这不是 Laravel 或 Pusher 设的限，是浏览器策略。

开发时用 http://localhost:8000 可以通，因为浏览器对 localhost 放行不安全连接
一旦部署到 http://example.com，pusher-js 会直接拒绝建立连接，并抛出 WebSocket connection failed: SecurityError
Nginx/Apache 必须透传 Upgrade 和 Connection 头，否则连接会降级为长轮询并静默失败
.env 里写 PUSHER_SCHEME=http 没用——pusher-php-server 包根本不读这个配置；前端初始化时才需要显式设 forceTLS: true

广播事件没触发，`BroadcastServiceProvider` 注册对了但还是收不到？

漏掉任一环节都会导致 event(new MessageSent($message)) 完全静默：后端不报错、Redis 无记录、前端监听不到。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

config/app.php 中 BroadcastServiceProvider::class 必须在 providers 数组里，且不能被条件包裹或注释掉
config/broadcasting.php 的 'default' => env('BROADCAST_DRIVER', 'pusher') 必须生效，且 .env 中 BROADCAST_DRIVER=pusher 拼写不能错
广播事件类必须实现 ShouldBroadcast 接口，broadcastOn() 返回有效频道实例（如 new PrivateChannel('chat.' . $this->roomId)），不能返回空数组或 null
私有频道需认证端点 POST /broadcasting/auth，该路由**不能加 web 中间件**（会塞 session cookie 导致跨域预检失败），应改用 api 中间件或自定义无 session 的中间件

`Echo.private('chat.123')` 订阅失败，控制台只显示 `Subscription to private-chat.123 failed`

这是私有频道鉴权失败的典型表现，问题几乎总出在后端响应格式或前端配置上。

前端 authEndpoint 必须指向 Laravel 的认证路由（默认是 /broadcasting/auth），别写成 /api/broadcasting/auth 却忘了配路由前缀
响应体必须是 {"auth":"xxx:yyy"}，且 Content-Type: application/json；返回 {"error": "unauthorized"} 会导致前端卡在 “connecting” 状态
频道名大小写敏感、前后空格、整数拼接（如 'chat.' . $id 中 $id 是 int 还是 string）都会让前后端频道名不一致
前端 JS 读不到 PUSHER_APP_KEY —— 必须在 .env 中写成 MIX_PUSHER_APP_KEY=xxx，再经 Laravel Mix 编译注入；process.env.MIX_PUSHER_APP_KEY 为空？90% 是忘了加 MIX_ 前缀

最容易被忽略的是三处配置对齐：.env、config/broadcasting.php、config/services.php 中的 Pusher 配置必须完全一致；PUSHER_APP_CLUSTER 填错（比如新应用该填 mt1 却写了 us2）会导致静默失败，控制台连错误都不报。