PHP搭建WebSocket即时通讯教程：Swoole与Workerman对比

本文深入解析了PHP构建高性能WebSocket即时通讯服务的核心实践，重点对比Swoole与Workerman两大方案，明确指出Swoole（≥4.8版本）凭借协程广播、自动心跳、高并发稳定性及成熟生态，成为生产环境的首选；同时直击开发常见致命误区——如错误监听地址、Nginx未透传Upgrade头、手写握手逻辑导致90%连接失败、同步广播阻塞进程，以及在onOpen阶段忽视客户端参数校验等关键细节，为开发者提供一条避开坑洞、开箱即用的落地路径。

直接用 swoole_websocket_server，别手写握手逻辑——90% 的连接失败都卡在握手阶段，不是网络不通，是服务端压根没正确响应 Sec-WebSocket-Accept。

确认 Swoole 扩展已就位且版本 ≥ 4.8

这是硬门槛。低于 v4.8 的 Swoole 缺少协程化广播、心跳自动管理等关键能力，强行用会掉进超时关闭、连接堆积的坑里。

• 运行 php -m | grep swoole，确认输出中包含 swoole
• 再查版本：php --ri swoole | grep "Version"，必须 ≥ 4.8（推荐 v5.x）
• 若未安装，用 PECL：pecl install swoole；宝塔用户需在「软件管理→PHP→设置→安装扩展」里勾选 Swoole
• 改完 php.ini 后务必重启 PHP 服务（不只是 Web 服务器）

监听地址写成 0.0.0.0:9501，别只绑 127.0.0.1

本地测试能连上，一上服务器就报 net::ERR_CONNECTION_REFUSED？八成是监听地址写死了 127.0.0.1，导致外部请求根本进不来。

• $server = new swoole_websocket_server('0.0.0.0', 9501); —— 允许所有网卡接入
• 前端连接 URL 必须带端口：new WebSocket('ws://your-domain.com:9501')，漏掉 :9501 就是走 HTTP 80 端口，必然失败
• 云服务器（如阿里云、腾讯云）要额外放行安全组端口 9501；宝塔用户需在「安全」里添加放行规则
• Nginx 反向代理场景下，必须透传 Upgrade 和 Connection 头，否则握手被截断

广播消息必须用协程方式遍历 $server->connections

直接 foreach 全量连接 push，高并发下会阻塞当前 worker 进程，新连接排队、心跳超时、消息延迟飙升。

• 不要写：foreach ($server->connections as $fd) { $server->push($fd, $data); }
• 改用协程并发：go(function () use ($server, $data) { foreach ($server->connections as $fd) { $server->push($fd, $data); } });
• 更稳妥的做法是结合 defer 或投递到 task 进程处理，避免主线程长时间占用
• 注意：$server->connections 是连接 ID 集合，不是对象数组，不能直接调用 isConnected()，需先 isset($server->connection_info($fd)) 判活

Workerman 能跑通，但不适合中高并发实时场景

Workerman 启动快、不依赖扩展，适合快速验证或低负载内部工具。但它默认无心跳保活、连接数上限低、广播无协程支持，上线后容易出连接假死、消息积压问题。

• 若坚持用 Workerman，请务必手动加心跳检测：$worker->ping_interval = 30;，并重写 onWebSocketConnect 做 token 验证
• Workerman 的 send() 不是异步的，广播循环里每发一次都可能阻塞毫秒级，1000 连接就明显卡顿
• Ratchet 更轻量，但依赖 ext-sockets，且不支持热更新、进程管理弱，仅建议用于学习协议原理
• 真实业务线上的聊天、通知类服务，Swoole 是目前唯一兼顾性能、稳定性与生态的 PHP 方案

最常被忽略的一点：客户端传参（比如 uid、token）必须在 onOpen 回调里解析并校验，不能拖到 onMessage 才做——一旦连接建立后才拒绝，已浪费资源且暴露握手逻辑漏洞。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP搭建WebSocket即时通讯教程：Swoole与Workerman对比》文章吧，也可关注golang学习网公众号了解相关技术文章。