PHP WebSocket客户端发二进制数据必须用支持binary的库(如textalk/websocket)并调用send($data, 'binary'),或手动实现合规帧编码(含FIN、opcode=2、掩码等),原生fsockopen不支持。

PHP WebSocket 客户端怎么发二进制数据
PHP 原生 fsockopen 或 stream_socket_client 不支持 WebSocket 协议握手和帧封装,直接“连上就发二进制”会失败——服务端大概率收不到,或解析成乱码/关闭连接。必须手动实现 WebSocket 帧编码,或用可靠封装库。
用 Ratchet / ReactPHP 客户端发二进制最稳
推荐 textalk/websocket(轻量、专注客户端、支持 binary)或 reactphp/socket + 自定义帧逻辑。以 textalk/websocket 为例:
- 安装:
composer require textalk/websocket - 发送前确保连接已建立且状态为
OPEN,否则send()抛异常 - 二进制数据必须传
string类型的原始字节(如pack('N', 12345)、file_get_contents('img.bin')),不能传数组或对象 - 调用
$conn->send($binaryData, 'binary')—— 第二个参数'binary'是关键,缺了就当文本帧发,服务端收到的是 UTF-8 解码失败的垃圾
示例片段:
$conn = new WebSocket('ws://localhost:8080');
$conn->on('open', function ($conn) {
$bin = pack('C*', 0x01, 0x02, 0xFF, 0x00);
$conn->send($bin, 'binary'); // ← 必须显式指定 type
});
$conn->run();
自己手写 WebSocket 帧编码发二进制(不推荐但得知道)
仅限调试或极端受限环境。WebSocket 二进制帧格式含:FIN bit、opcode=2、payload length 编码、mask key(客户端必须掩码)、原始数据。漏掉 mask 或长度字段错一位,服务端直接断连。
立即学习“PHP免费学习笔记(深入)”;
- opcode 固定为
2(二进制帧),不是0x2字符串 - payload 长度 ≤ 125:直接写入第 2 字节;126–65535:写
126+ 2 字节大端;≥65536:写127+ 8 字节大端 - 客户端必须设 mask bit(第 1 字节 bit 8 = 1),并生成 4 字节随机
$mask,再对 payload 每字节异或$mask[$i % 4] - 用
fwrite($fp, $frame)发送,别用echo或缓冲输出
常见报错和对应检查点
发不出或服务端收不到二进制?盯这几个地方:
-
WebSocket connection to 'ws://...' failed: Error during WebSocket handshake→ 握手没过,检查 HTTP Upgrade 头、Sec-WebSocket-Key 计算、响应状态码是否为101 - 服务端 log 显示 “invalid frame opcode” → PHP 客户端发的帧 opcode 不是
2,或用了0x02字符串而非整数2 - 收到数据长度比预期少 4 字节 → 忘了 mask 异或,服务端解码时跳过了 mask key 区域
- 用
json_encode()包二进制再发 → 错!JSON 不支持二进制,会转成 base64 字符串,本质还是文本帧
二进制传输的关键不在“连”,而在“帧合规”。哪怕只差一个字节的掩码或 opcode,整个帧就被丢弃——这和 HTTP body 不同,没有容错余地。











