PHP无法接收WebSocket消息的解决方法

一分耕耘，一分收获！既然都打开这篇《PHP无法接收WebSocket消息怎么解决？》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新文章相关的内容，希望对大家都有所帮助！

PHP接收不到WebSocket消息的根本原因在于未完成握手、未解析掩码帧或连接被中断；需严格实现HTTP/1.1 101响应、SHA1+base64计算Sec-WebSocket-Accept、手动解帧、常驻进程及心跳保活。

PHP 接收不到 WebSocket 消息，大概率不是“没收到”，而是根本没完成握手，或握手后没正确进入消息循环 —— 这是 PHP 原生 socket 实现中最常被忽略的断点。

WebSocket 握手失败：连接建立就卡住

浏览器控制台显示 net::ERR_CONNECTION_CLOSED 或直接报 WebSocket connection to 'ws://...' failed，说明客户端连请求都没发完，更谈不上收消息。核心问题在于服务器返回的握手响应不合规。

• 必须严格返回 HTTP/1.1 101 Switching Protocols（不能是 101 Web Socket Protocol Handshake，旧写法已过时）
• Sec-WebSocket-Accept 计算必须用 sha1($key . '258EAFA5-E914-47DA-95CA-C5AB0DC85B11', true)，第二个参数 true 不可省略，否则返回的是字符串而非原始二进制，base64 编码结果错误
• 响应头末尾必须有 \r\n\r\n（两个 CRLF），少一个都会导致客户端解析失败

function doHandshake($header, $clientSocket) {
    if (!preg_match('/Sec-WebSocket-Key: (.*)\r\n/', $header, $matches)) {
        socket_close($clientSocket);
        return false;
    }
    $key = trim($matches[1]);
    $accept = base64_encode(sha1($key . '258EAFA5-E914-47DA-95CA-C5AB0DC85B11', true));
    $response = "HTTP/1.1 101 Switching Protocols\r\n" .
                "Upgrade: websocket\r\n" .
                "Connection: Upgrade\r\n" .
                "Sec-WebSocket-Accept: {$accept}\r\n\r\n";
    socket_write($clientSocket, $response);
}

握手成功但收不到消息：没处理帧解析

很多开发者以为握手完就能直接 socket_read() 拿到明文数据，这是最大误区。WebSocket 协议规定所有客户端发来的消息都必须是「掩码帧（masked frame）」，且含固定帧头结构 —— PHP 原生 socket 不会自动解包。

• 直接 socket_read($client, 1024) 读到的是二进制帧数据，不是 UTF-8 字符串
• 必须手动解析帧头（至少前 2 字节）判断是否掩码、载荷长度、是否分片
• 若 payload length > 125，需继续读取扩展长度字段；若 MASK 位为 1，必须用 4 字节掩码对后续数据异或解密
• 跳过这一步，你读到的就是乱码或空内容，json_decode() 必然失败

PHP 脚本退出导致连接中断：长连接被主动关闭

PHP 默认以 CGI/FPM 模式运行，每个请求生命周期极短（通常几秒）。用 while(true) 写服务端，脚本一执行完进程就退出，连接立刻断开 —— 所以你“收不到后续消息”，其实是连接早被关了。

• 禁用超时：set_time_limit(0) 和 ini_set('max_execution_time', 0) 必须同时设
• 关闭输出缓冲：ob_end_flush() 和 flush() 防止响应卡在缓冲区
• 但更关键的是：不要用传统 PHP-FPM 启动 WebSocket 服务，应改用 Swoole 或 Ratchet 等支持常驻进程的方案
• 若坚持原生 socket，必须用 CLI 模式运行：php -S 不行，得 php your-server.php 后台常驻

防火墙 / 反向代理悄悄切断空闲连接

即使握手和帧解析都对，Nginx、Apache 或云厂商安全组也可能在 60 秒无数据交互后静默关闭连接，表现为“突然收不到新消息”。这不是 PHP 的错，但必须由 PHP 主动应对。

• Nginx 默认 proxy_read_timeout 是 60s，需在配置中显式加大：proxy_read_timeout 300;
• 客户端必须实现心跳（如每 30s 发 ping 帧），服务端收到后回 pong，维持活跃状态
• PHP 服务端要监听 opcode == 0x09（ping）并主动回复 0x0A（pong），不能忽略
• 用 telnet 127.0.0.1 8000 测试端口通不通，比看浏览器错误更有说服力

真正难的不是写握手，而是理解 WebSocket 是一个需要持续维护的双向通道 —— 它不像 HTTP 那样“发完就了事”。只要漏掉帧解析、心跳、常驻进程三者中任意一环，你看到的“收不到消息”，其实从连接建立那一刻起就已经注定。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。