PHP连接WebSocket版本兼容解决方案

PHP连接WebSocket时握手失败往往并非网络问题，而是因Sec-WebSocket-Key生成不合规、Sec-WebSocket-Version版本不匹配、HTTP头换行符错误（必须为\r\n\r\n且无BOM或多余空行）或服务端RFC 6455兼容性差异所致；cURL因设计局限无法维持升级后连接，必须使用stream_socket_client手动构造严格符合规范的握手请求，而Swoole协程客户端虽支持upgrade，但仍需自行处理底层socket和WebSocket帧解析——细节决定成败，调试务必抓包验证实际请求头。

PHP 客户端连接 WebSocket 时 handshake 失败的常见原因

PHP 本身不原生支持 WebSocket 客户端，绝大多数场景依赖 fsockopen 或 stream_socket_client 手动实现握手。失败往往不是“连不上”，而是服务端拒绝了 HTTP Upgrade 请求——核心在 WebSocket 协议版本（Sec-WebSocket-Version）和密钥（Sec-WebSocket-Key）是否符合 RFC 6455 规范。

• 旧版服务端（如早期 Socket.IO 0.x、自建 ws-server 用 draft-75/76）要求 Sec-WebSocket-Version: 13 以外的值，但现代 PHP 客户端默认只发 13
• Sec-WebSocket-Key 必须是恰好 16 字节随机数据 Base64 编码，少一位或多一位都会被拒绝
• HTTP 头必须以 \r\n\r\n 结尾，且不能有多余空行或 UTF-8 BOM

用 stream_socket_client 手动构造兼容 RFC 6455 的握手请求

这是最可控的方式，绕过 cURL 等封装对 WebSocket 头的忽略或错误处理。关键点在于严格控制请求头顺序、换行符和字段值：

$host = 'example.com';
$port = 8080;
$context = stream_context_create(['ssl' => ['verify_peer' => false]]);
$socket = stream_socket_client("tcp://{$host}:{$port}", $errno, $errstr, 5, STREAM_CLIENT_CONNECT, $context);

if (!$socket) {
    die("Connection failed: {$errstr} ({$errno})");
}

// 生成合法 Sec-WebSocket-Key（16 字节随机 + base64）
$key = base64_encode(random_bytes(16));

$request = "GET /ws HTTP/1.1\r\n";
$request .= "Host: {$host}:{$port}\r\n";
$request .= "Upgrade: websocket\r\n";
$request .= "Connection: Upgrade\r\n";
$request .= "Sec-WebSocket-Key: {$key}\r\n";
$request .= "Sec-WebSocket-Version: 13\r\n";
$request .= "\r\n"; // 注意：两个 \r\n，且无多余空格

fwrite($socket, $request);

// 读取响应（需解析 HTTP 状态码和 Sec-WebSocket-Accept）
$response = '';
while (!feof($socket) && strpos($response, "\r\n\r\n") === false) {
    $response .= fread($socket, 1024);
}

注意：fread 后要校验 HTTP/1.1 101 和 Sec-WebSocket-Accept 是否存在，否则说明握手未通过。

为什么 cURL 无法直接用于 WebSocket 连接

cURL 是 HTTP 客户端库，设计目标是完成一次请求-响应周期，不支持长连接升级后的二进制帧收发。即使强制设置 Upgrade: websocket，它也会在收到 101 响应后立即关闭连接，无法进入 WebSocket 数据交换阶段。

• 调用 curl_setopt($ch, CURLOPT_HTTPHEADER, [...]) 发送 Upgrade 头，服务端返回 101，但 cURL 不会保留 socket 句柄
• 尝试用 curl_exec 接收后续帧？不可能——连接已断开
• 某些扩展（如 php-websocket）底层仍是 stream_socket_client 封装，非真正 cURL 实现

PHP 8.1+ 使用 Swoole\Coroutine\Http\Client 的注意事项

如果你用的是 Swoole，并开启协程 HTTP 客户端，它虽支持 upgrade() 方法，但默认仍走 HTTP/1.1 握手流程。必须显式禁用自动重定向、设置超时、并手动处理 upgrade 后的 socket：

$client = new \Swoole\Coroutine\Http\Client('example.com', 8080, false);
$client->set(['timeout' => 5]);
$client->setHeaders([
    'Upgrade' => 'websocket',
    'Connection' => 'Upgrade',
    'Sec-WebSocket-Key' => base64_encode(random_bytes(16)),
    'Sec-WebSocket-Version' => '13',
]);
$client->upgrade('/ws');

if ($client->statusCode === 101) {
    // 此时 $client->getSocket() 返回原始 socket，可调用 recv()/send()
    $socket = $client->getSocket();
    // 后续需自己实现 WebSocket 帧解析（掩码、长度、opcode 等）
}

别指望 upgrade() 后还能用 $client->get()——那是 HTTP 模式；WebSocket 数据必须直操作 socket，且帧格式需自行处理，掩码（mask）在客户端发送时必须开启，服务端返回时不带掩码。

WebSocket 握手看着简单，但 Sec-WebSocket-Key 的生成方式、换行符类型、头字段大小写、以及服务端对 RFC 的遵守程度，任何一个细节偏差都会导致静默失败。调试时优先抓包看实际发出的请求头，而不是只查 PHP 报错。

理论要掌握，实操不能落！以上关于《PHP连接WebSocket版本兼容解决方案》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！