PHP客户端需手动发送标准WebSocket PING帧(0x89开头)维持长连接,频率设为服务端超时的2/3,配合读超时设置与非阻塞收发,并在握手完成后发送;推荐使用textalk/websocket等封装库简化开发。

PHP 客户端连接 WebSocket 后怎么维持长连接不被断开
WebSocket 连接被服务端主动关闭,多数不是因为网络问题,而是服务端设置了空闲超时(比如 30 秒无消息就踢掉),而 PHP 常用的 fsockopen 或 stream_socket_client 自身不支持自动心跳。你得自己发 PING 帧,且必须是 WebSocket 协议格式,不能只发普通字符串。
用 stream_socket_client 发送标准 WebSocket PING 帧要注意什么
WebSocket 的 PING 是二进制控制帧,首字节固定为 0x89,第二字节低7位表示 payload 长度(0~125),长度为 0 时 payload 为空。PHP 不会帮你封装,必须手动拼:
/* 示例:发送一个空 payload 的 PING */ $ping = "\x89\x00"; fwrite($fp, $ping);
-
fwrite返回 false 或 0 表示写失败,需检查feof($fp)和socket_get_status($fp) - 不要用
echo或print发送,它们可能带换行或缓冲干扰 - 服务端收到
PING后应返回PONG(0x8a开头),但很多服务端只认 PING、不回 PONG,所以重点是「发出去」,不是等回包 - 如果服务端要求带 payload(如 4 字节随机数),就得按 WebSocket RFC6455 拼 mask 和 payload,复杂度陡增——先确认服务端是否真需要
心跳频率和重连逻辑怎么配合才不崩
心跳太勤(如 1 秒一次)可能被限流;太懒(如 60 秒一次)大概率已超时。建议设为服务端超时时间的 2/3(如服务端 30 秒超时,客户端每 20 秒发一次):
- 用
stream_set_timeout($fp, 0, 500000)设置读超时为 500ms,避免fread卡死 - 心跳和收消息不能串行阻塞:收到数据就处理,没收到就计时,到点就发 PING,别等
fread返回再判断 - 发 PING 后若
fwrite失败,或紧接着fread立即返回空/EOF,说明连接已断,该关流重连了 - 重连前 sleep 1–3 秒,别疯狂循环 connect,否则服务端可能拉黑 IP
有没有更省事的替代方案
如果你只是想跑通逻辑、不追求极致轻量,直接换 ext-websocket 扩展或 textalk/websocket 这类 Composer 包。它们内部已封装好心跳定时器和帧编码,调用类似:
立即学习“PHP免费学习笔记(深入)”;
$client = new WebSocketClient('ws://example.com');
$client->setHeartbeatInterval(20); // 秒
$client->connect();但要注意:textalk/websocket 底层仍用 fsockopen,不支持 TLS 1.3 或某些自定义 header;而原生扩展(如 php-swoole 的 WebSocket\Client)性能更好,但要求 Swoole 环境——选哪个,取决于你部署环境是否可控。
真正容易被忽略的是:心跳帧必须在 WebSocket 连接建立握手完成之后才能发,也就是收到服务端返回的 HTTP/1.1 101 Switching Protocols 并完成密钥验证后。早一秒发,服务端当非法数据直接断连。











