跳转到主内容
趣航编程网 - 趣学编程,启航技术之路!

Laravel集成Pusher实现WebSocket教程 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 配置未对齐。 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 无记录、前端监听不到。
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
这是私有频道鉴权失败的典型表现,问题几乎总出在后端响应格式或前端配置上。 PHP 8.5.5 PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。 下载 立即学习 “ PHP免费学习笔记(深入) ”; 前端
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
)会导致静默失败,控制台连错误都不报。

相关文章