PHP原生无WebSocket客户端保活机制,需用pcntl_fork+stream_select实现轻量守护或选用Workerman/Swoole;关键要处理心跳、重连、close帧及握手校验。

PHP 本身没有原生的 WebSocket 客户端长连接保活机制,直接用 fsockopen 或 stream_socket_client 建连后,不主动收发数据、不处理心跳,连接大概率会在 30–120 秒内被中间代理(Nginx、负载均衡)或服务端主动断开。所谓“后台运行”和“守护进程”,本质是让 PHP 进程持续存活并维持 WebSocket 连接状态 —— 但这在标准 PHP CLI 模式下极难稳定做到。
为什么 php -f client.php & 不算真正的守护进程
这种后台启动只是把进程丢到 shell 后台,没做 PID 管理、异常重启、日志隔离、信号处理,一旦脚本报错、连接中断或内存溢出,进程就静默退出,毫无感知。更关键的是:PHP 默认不支持异步 I/O,单线程阻塞式 stream_socket_recvfrom 会卡死整个脚本,无法同时监听消息 + 发送心跳 + 处理业务逻辑。
- 进程无守护能力:崩溃即消失,无自动拉起
- 无连接状态监控:断连后不会重连,也不会触发回调
- 无心跳保活逻辑:多数 WebSocket 服务端要求每 30–45 秒发一次
PING帧 - STDIN/STDOUT 未重定向:日志混在终端,无法追踪问题
用 pcntl_fork + stream_select 实现轻量级保活(仅限 Linux)
这是最贴近“纯 PHP 守护”的方案,绕过扩展依赖,但要求 PHP 编译时启用 pcntl 和 posix 扩展,且只能跑在 CLI 模式。
- 主进程
pcntl_fork出子进程后,父进程退出,子进程调用posix_setsid()脱离终端 - 用
stream_socket_client建连,设stream_set_timeout($socket, 0, 500000)避免 recv 长阻塞 - 核心是
stream_select($read, $write, $except, 0, 500000):每 500ms 检查 socket 是否可读,避免死等 - 收到数据就解析帧;空闲超 30 秒就手动发
\x89\x00(PING 帧),服务端会回PONG - 捕获
SIGTERM信号做优雅关闭,写 PID 到/var/run/myws.pid
示例片段:
立即学习“PHP免费学习笔记(深入)”;
$socket = stream_socket_client("tcp://ws.example.com:8080", $errno, $errstr, 5);
stream_set_timeout($socket, 0, 500000);
while (true) {
$read = [$socket]; $write = []; $except = [];
if (stream_select($read, $write, $except, 0, 500000) > 0 && in_array($socket, $read)) {
$data = fread($socket, 2048);
if ($data === false || feof($socket)) { /* 重连逻辑 */ break; }
// 解析 WebSocket 帧...
}
// 每 30 秒发 PING
if (time() - $last_ping > 30) {
fwrite($socket, "\x89\x00");
$last_ping = time();
}
}推荐方案:用 Workerman 或 Swoole 替代原生 PHP
硬扛原生 PHP 做 WebSocket 客户端守护,等于在泥地里修高铁。Workerman 的 Worker::daemonize() + Connection 对象天然支持重连、心跳、多进程管理;Swoole 的 Swoole\Coroutine\Http\Client 支持协程 WebSocket,go 启动后自动后台化,错误可 catch,内存自动回收。
- Workerman 示例中,
$client->onClose = function() { $this->connect(); }一行就搞定断线重连 - Swoole 中
$client->set(['websocket_mask' => true])必须显式开启掩码,否则服务端可能拒收 - 两者都需用
nohup php start.php start -d启动,-d 参数才是真后台,不是& - 别用
php-fpm运行 —— 它专为 HTTP 短连接设计,WebSocket 长连接会迅速耗尽 worker 进程
最容易被忽略的三个点
第一,WebSocket 握手必须带正确的 Sec-WebSocket-Key 和 Upgrade: websocket,用 curl 或原生 socket 手写 HTTP 头时极易漏字段,导致 400 错误;第二,服务端返回的响应头若含 Sec-WebSocket-Accept 校验失败,连接会静默关闭,建议先用 wscat -c ws://... 测试通路;第三,所有方案都必须处理 close 帧(opcode 0x08),不能只等 EOF,否则服务端发 close 后连接卡在 half-close 状态,防火墙会主动 kill。











