Workerman 本身不支持 PHP 主动连接 WebSocket 服务,因其仅专注服务端功能,未提供 WebSocketClient 类;可行方案仅有 ext-websocket 扩展或 amphp/websocket-client,或采用进程间通信解耦。

Workerman 本身不支持 PHP 主动连接 WebSocket 服务
Workerman 是一个 PHP 的异步 TCP 长连接框架,它擅长的是「作为 WebSocket 服务端」(比如用 WebServer 或 Worker + WebSocketConnection),而不是作为 WebSocket 客户端去连接别人。PHP 原生不带 WebSocket 客户端实现,Workerman 也未提供 WebSocketClient 类或类似 new WebSocket('ws://...') 的能力。
如果你的需求是「PHP 主动发起 WebSocket 连接、发消息、收回调」,直接用 Workerman 是走不通的。
- 常见错误现象:
Fatal error: Class 'Workerman\Protocols\WebSocket\Client' not found(这个类根本不存在) - 有人误把
Workerman\Connection\TcpConnection强行套 WebSocket 握手流程,结果卡在 HTTP Upgrade 失败或帧解析异常 - Workerman 的
AsyncTcpConnection可以建 TCP 连接,但不处理 WebSocket 协议层(如 mask、opcode、ping/pong、frame 拆包),需自己实现——成本远超收益
PHP 主动连 WebSocket 的可行方案只有两个
真正能稳定、轻量、开箱即用的客户端方案非常有限,目前只有两类被广泛验证:
-
ext-websocket 扩展:C 编写的原生扩展,性能好、协议完整、支持 wss、自动 ping/pong;需编译安装,PHP 8.0+ 兼容良好;GitHub 项目名是
php-websocket(注意不是同名 Composer 包) -
amphp/websocket-client:纯 PHP 实现,基于
amphp/amp异步生态;需启用ext-sockets或ext-curl,支持 HTTPS/WSS,API 清晰;适合已用 Amp 生态的项目
别碰那些用 fsockopen + 手撕 Sec-WebSocket-Key 的“自制客户端”——握手失败率高、不处理重连、无心跳保活、不兼容代理,线上一压就丢连接。
立即学习“PHP免费学习笔记(深入)”;
为什么不用 ReactPHP 或 Ratchet
ReactPHP 的 clue/reactphp-websocket 确实有客户端,但它依赖整个 React 事件循环,和 Workerman 的 EventLoop 冲突;Ratchet 更是只做服务端。你在 Workerman 进程里 require 进 React 的 loop,会导致:
- 两个事件循环嵌套,CPU 100% 占用
-
Worker::runAll()启动后,React 的Loop::run()永远不会执行 - Composer autoload 冲突,
class_exists('React\EventLoop\Factory')可能返回 false
强行混合异步框架,不是选型,是给自己埋定时重启任务。
如果必须和 Workerman 共存,推荐进程间通信方案
Workerman 做业务逻辑主进程,另起一个轻量客户端进程(比如用 Python + websockets 库,或 Node.js + ws),通过 Unix Socket / Redis PubSub / MySQL 表轮询与 PHP 主进程通信:
- Workerman 收到 HTTP 请求 → 写一条待发送指令到
redis queue - Python 客户端监听该队列 → 拿到数据后通过 WebSocket 发出去 → 把响应写回
redis hash - Workerman 定时轮询或用
Redis::pSubscribe接收结果
这种解耦方式上线稳定、调试方便、扩容灵活;比在 PHP 里硬啃 WebSocket 协议靠谱得多。真正难的不是连上,而是连得稳、断得清、重连不丢状态。











