本文详解 WebSocket 连接失败（如 ws://127.0.0.1:8080/ failed）的根本原因，重点指出原生 PHP socket 缺少标准 WebSocket 握手响应会导致浏览器拒绝连接，并提供可运行的握手实现代码与调试要点。
本文详解 websocket 连接失败（如 `ws://127.0.0.1:8080/ failed`）的根本原因，重点指出原生 php socket 缺少标准 websocket 握手响应会导致浏览器拒绝连接，并提供可运行的握手实现代码与调试要点。
WebSocket 并非简单的 TCP 连接，而是一套有严格协议规范的通信机制。当 JavaScript 客户端执行 new WebSocket('ws://127.0.0.1:8080') 时，浏览器会首先发送一个 HTTP 兼容的 Upgrade 请求（含 Upgrade: websocket、Sec-WebSocket-Key 等关键头），等待服务端返回符合 RFC 6455 规范的 101 Switching Protocols 响应——只有完成该握手，onopen 回调才会触发。否则，控制台将显示“connection failed”，且不会抛出具体错误细节。
你原始的 server.php 仅做了基础 socket 监听和原始数据读取，完全未解析 HTTP 握手请求，也未构造合法响应，导致浏览器在超时后直接中断连接。此外还需注意以下关键点：
✅ 协议一致性：客户端 URL 使用 ws://，则服务端不可监听 wss://（需 TLS）；反之亦然。错误日志中出现 wss://... failed 往往是因为页面本身通过 HTTPS 加载（现代浏览器禁止混用），此时必须改用 https:// 本地服务或使用 http:// 打开 client.html（推荐开发阶段用 http://localhost）。
✅ 握手核心三要素（缺一不可）：
立即学习“PHP免费学习笔记（深入）”；
- 读取并解析客户端 Sec-WebSocket-Key 头；
- 将其拼接固定 GUID 后进行 SHA-1 + Base64 编码，生成 Sec-WebSocket-Accept；
- 返回完整 HTTP 101 响应，包含 Upgrade: websocket 和 Connection: Upgrade。
以下是修正后的最小可行服务端（server.php），已封装握手逻辑，支持单次连接验证：
<?php
class WebsocketHelper {
public static function parseHeadersFromRequest(string $request): array {
$header_values = [];
$header_part = explode("\r\n\r\n", $request)[0] ?? '';
$header_lines = explode("\r\n", $header_part);
foreach ($header_lines as $line) {
if (strpos($line, ':') !== false) {
[$key, $value] = explode(':', $line, 2);
$header_values[trim($key)] = trim($value);
}
}
return $header_values;
}
public static function createAcceptFromKey(string $key): string {
$magic = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
return base64_encode(sha1($key . $magic, true));
}
public static function createResponse(string $acceptHash): string {
return "HTTP/1.1 101 Switching Protocols\r\n" .
"Upgrade: websocket\r\n" .
"Connection: Upgrade\r\n" .
"Sec-WebSocket-Accept: {$acceptHash}\r\n\r\n";
}
}
// 启动服务
$host = "127.0.0.1";
$port = 8080;
$socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP) or die("Socket create failed: " . socket_strerror(socket_last_error()));
socket_set_option($socket, SOL_SOCKET, SO_REUSEADDR, 1);
socket_bind($socket, $host, $port) or die("Socket bind failed: " . socket_strerror(socket_last_error()));
socket_listen($socket, 5) or die("Socket listen failed: " . socket_strerror(socket_last_error()));
echo "WebSocket server listening on ws://{$host}:{$port}...\n";
$client = socket_accept($socket);
if ($client === false) {
die("Socket accept failed: " . socket_strerror(socket_last_error()));
}
$request = socket_read($client, 2048);
if (!$request) {
die("No request received\n");
}
$headers = WebsocketHelper::parseHeadersFromRequest($request);
if (!isset($headers['Sec-WebSocket-Key'])) {
die("Invalid WebSocket handshake: missing Sec-WebSocket-Key\n");
}
$acceptHash = WebsocketHelper::createAcceptFromKey($headers['Sec-WebSocket-Key']);
$response = WebsocketHelper::createResponse($acceptHash);
socket_write($client, $response);
echo "Handshake completed. Connection established.\n";
// 此处可添加消息循环（需处理 WebSocket 帧格式）
// 为简化演示，连接成功后保持 30 秒活跃
sleep(30);
socket_close($client);
socket_close($socket);? 客户端注意事项（client.html）：
<!DOCTYPE html>
<html>
<head><title>WebSocket Test</title></head>
<body>
<script>
// 确保页面通过 http://（非 https://）访问，否则 ws:// 将被浏览器拦截
const conn = new WebSocket('ws://127.0.0.1:8080');
conn.onopen = () => console.log('✅ WebSocket connected');
conn.onerror = (e) => console.error('❌ WebSocket error:', e);
conn.onclose = () => console.log('? Connection closed');
</script>
</body>
</html>⚠️ 重要提醒：
- 此示例仅完成握手，不支持后续消息收发（需实现 WebSocket 帧解析/编码）；
- 生产环境请使用成熟库（如 Ratchet 或 ReactPHP），避免手动处理二进制帧；
- 调试时优先检查：① 页面是否为 http:// 协议；② 终端运行 php server.php 后无报错；③ 浏览器开发者工具 Network 标签中查看 WebSocket 请求状态码及响应头。
掌握握手原理是 WebSocket 开发的第一道门槛。理解“浏览器只认标准响应，不认裸 socket”这一本质，即可快速定位 90% 的连接失败问题。
