PHP不原生支持WebSocket客户端，需依赖第三方库（如textalk/websocket）或手动实现复杂协议逻辑；手动实现易出错，涉及握手验证、掩码解码、opcode识别等，生产环境推荐使用成熟库而非裸socket。
PHP 本身不原生支持 WebSocket 客户端（fsockopen 或 stream_socket_client 只能做基础 TCP 连接，无法自动处理 WebSocket 握手和帧解析），直接用 PHP 连 WebSocket 并解析 JSON 数据，得靠第三方库或手动实现协议逻辑——多数情况下，这不是推荐路径。
为什么不用纯 PHP 写 WebSocket 客户端？
WebSocket 协议包含：HTTP 升级握手、掩码校验、帧分片、长度编码、opcode 解析等。PHP 没有内置 WebSocketClient 类，自己实现容易出错，比如：
- 握手失败但没检查
Sec-WebSocket-Accept值是否匹配 - 收到带掩码的帧却没解码，导致 JSON 解析失败（
json_decode返回null） - 二进制帧（opcode=2）误当文本帧（opcode=1）处理，
json_decode直接报错 - 长连接中未处理 ping/pong，服务端主动断连
推荐方案：用 rluders/websocket-client 或 textalk/websocket
这两个是 Composer 可安装、维护较活跃的轻量客户端。以 textalk/websocket 为例：
composer require textalk/websocket
简单连接 + JSON 解析示例：
立即学习“PHP免费学习笔记（深入）”；
PHP5学习对象教程
下载
PHP5学习对象教程由美国人古曼兹、贝肯、瑞桑斯编著，简张桂翻译，电子工业出版社于2007年12月1日出版的关于PHP5应用程序的技术类图书。该书全面介绍了PHP 5中的新功能、编程方法及设计模式，还分析阐述了PHP 5中新的数据库连接处理、错误处理和XML处理等机制，帮助读者系统了解、熟练掌握和高效应用PHP。
$client = new \Textalk\WebSocket\Client("ws://echo.websocket.org");
$client->send('{"action":"ping","data":123}');
$response = $client->receive();
$data = json_decode($response, true);
if (json_last_error() !== JSON_ERROR_NONE) {
// 注意：这里 $response 可能是空字符串、二进制乱码，或未关闭的流
}
关键点：
- 确保服务端返回的是合法 UTF-8 文本帧（opcode=1），否则
json_decode必然失败 -
$client->receive()是阻塞调用，超时需靠set_time_limit()或库自身 timeout 参数控制 - 若服务端发来多条消息，
receive()每次只取一条，需循环调用
如果必须用原生 socket（如嵌入式环境无 Composer）
最小可行握手 + 接收单条文本帧的要点：
- 构造正确握手头：
Sec-WebSocket-Key必须是 base64 编码的 16 字节随机值 - 读响应头直到遇到
\r\n\r\n，验证状态码为101且含Upgrade: websocket - 接收帧时，先读 2 字节：第 1 字节低 4 位是 opcode（
0x1表示文本），第 2 字节 bit 7 是 mask 标志 - 若 mask == 1，接下来 4 字节是掩码 key，之后所有 payload 需按字节异或该 key 才能得到真实数据
- 最终得到的 payload 才能传给
json_decode；若返回null，立刻查json_last_error_msg()
真正难的不是连接，而是持续通信中的帧边界判断、重连、心跳、错误恢复——这些在生产环境里几乎没法靠几段 PHP 脚本稳住。如果只是偶尔拉一次数据，不如让前端 WebSocket 发给后端 API；如果必须 PHP 主动连，优先选封装好的客户端库，别碰裸帧。
