PHP无法原生支持WebSocket客户端连接，需依赖textalk/websocket等第三方库；其适用场景限于CLI轮询、测试调试或跨语言指令推送，不适合长期维持连接。
PHP 本身不支持直接作为 WebSocket 客户端长期维持双向连接（没有原生 WebSocket 类），也不能像 Node.js 那样用 ws 库轻松发起并保持连接。想让 PHP 主动连接 WebSocket 服务，必须借助第三方库或绕过限制 —— 这是多数人踩坑的起点。
为什么不能直接用 fsockopen 或 cURL 连 WebSocket
WebSocket 协议不是简单 TCP 握手后发消息就行，它要求客户端发送符合 RFC 6455 的 Upgrade 请求头，并完成 Sec-WebSocket-Accept 签名校验。而 fsockopen 只能建裸 TCP 连接，cURL（截至 8.9）仍不支持 WebSocket 协议（curl_setopt($ch, CURLOPT_PROTOCOLS, CURLPROTO_WS) 无效）。
- 用
fsockopen手动拼 HTTP Upgrade 请求，容易漏掉随机Sec-WebSocket-Key、算错 base64 SHA1 值，服务端直接 400 或静默断连 - 即使握手成功，后续帧需要按 WebSocket 数据帧格式编码/解码（掩码、opcode、payload length 扩展等），PHP 原生无现成函数处理
- 没有心跳保活、重连机制，连接空闲几秒就被代理/Nginx 断掉
推荐方案：用 textalk/websocket 库（轻量、无依赖）
这是目前最稳定、最小巧的 PHP WebSocket 客户端实现，纯 PHP 编写，不依赖扩展，支持同步阻塞模式（适合 CLI 脚本或短时任务）。
- 安装：
composer require textalk/websocket - 基础连接示例（连接 echo server 并发一条消息）：
use WebSocket\Client;
try {
$client = new Client("ws://echo.websocket.org");
$client->send("hello");
echo $client->receive(); // 输出 "hello"
$client->close();
} catch (Exception $e) {
echo "连接失败：" . $e->getMessage();
}
- 注意：
textalk/websocket默认不自动重连，超时由构造参数控制，例如new Client("ws://...", ["timeout" => 5]) - 不支持并发多路复用（即不能同时监听多个连接），每个连接需独立实例
- 若服务端要求 token 鉴权，需在 URL 后拼 query（如
ws://api.example.com?token=abc123），无法在请求头中带Authorization
PHP 做 WebSocket 客户端的真实适用场景
别把它当长连接服务端用 —— PHP-FPM 模式下请求结束即销毁资源，根本 hold 不住连接。它的合理用途非常有限：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
立即学习“PHP免费学习笔记（深入）”；
- CLI 模式下轮询通知：比如定时脚本连接内部 WebSocket 网关，拉取一批待处理任务（
send→receive→ 关闭） - 测试调试：验证自研 WebSocket 服务是否响应正常，替代浏览器 console 或 wscat
- 与 Python/Node 后端桥接：PHP 接收 HTTP 请求后，用 WebSocket 向另一语言进程推送指令（注意控制生命周期，避免 fork 后子进程未关闭 client）
如果真需要 PHP 持久化连接（例如监听行情推送），必须脱离 FPM，改用 php -S + pcntl_fork + 守护进程管理，但稳定性、内存泄漏风险陡增 —— 大部分项目这时该换 Go 或 Rust 了。
真正难的从来不是“连上”，而是连上之后怎么应对网络抖动、服务端闪断、帧乱序、大 payload 分片、PONG 心跳超时这些细节。用 textalk/websocket 能省掉握手和编解码，但业务逻辑里的状态同步、消息去重、重试退避策略，还得自己一关关过。
