Workerman心跳包内容应该怎么设计-Workerman-PHP中文网

心跳包优先用纯"ping"字符串，tcp场景加换行符，websocket走标准ping帧；workerman空闲检测基于最后收发时间，需客户端心跳间隔小于$heartbeatidletime并预留网络余量。

workerman心跳包内容应该怎么设计

心跳包用 `ping` 还是自定义字符串？

Workerman 默认心跳检测依赖的是 onMessage 回调里对特定消息的识别，它本身不强制要求心跳内容格式，但必须能被服务端快速、无歧义地识别为“心跳”而非业务数据。用纯 "ping" 字符串最简单，也最安全——避免和业务协议冲突，解析开销最低。

如果已有二进制协议或 JSON 协议，可以复用相同结构，但必须加明确标识字段，比如 {"type":"heartbeat"} 或前缀 \x00\x01。别用 {"cmd":"ping"} 这类模糊字段，容易和登录、指令等业务消息混淆。

Websocket 场景下，优先走标准 Ping 帧（Workerman 会自动响应），不用自己发字符串
TCP 长连接场景下，"ping" + 换行符（"ping\n"）比无换行更稳妥，方便按行解析
别用空字符串或单个字节（如 \x01）做心跳，某些网络设备或代理可能截断或丢弃

`Worker::$heartbeatIdleTime` 和实际超时的关系

这个配置不是“多少秒没收到心跳就断开”，而是“最后一次收/发消息后，多久没任何通信就断开”。也就是说，即使客户端每秒发一次 "ping"，但服务端没调用 $connection->send() 或没收到任何数据，计时器仍会走完 $heartbeatIdleTime 后触发 onClose。

真正控制心跳频率的是客户端行为，Workerman 不主动发心跳，只被动响应或检测空闲。所以服务端断连逻辑和客户端心跳间隔要对齐：

设 Worker::$heartbeatIdleTime = 60，客户端心跳间隔就得 ≤ 45 秒，留出网络抖动余量
如果业务消息本身就频繁（如实时聊天），可设为 0 关闭空闲检测，靠业务包保活
修改该值必须在 Worker 实例启动前完成，运行中改无效

如何区分心跳包和业务包？

关键在 onMessage 里做轻量判断，别进复杂解析流程。Workerman 要求响应及时，阻塞或反序列化耗时操作会拖慢整个事件循环。

GPT Detector

Writefull GPT Detector是一款曾用于识别 GPT-3、ChatGPT 等模型生成文本的 AI 检测工具。

下载

推荐做法：用前几个字节或首行快速分流：

// 示例：TCP 文本协议
public function onMessage($connection, $data) {
    $data = trim($data);
    if ($data === 'ping') {
        $connection->send('pong');
        return;
    }
    // 其他业务逻辑...
}

避免用 json_decode($data) 判断 type 字段——万一传的是非法 JSON 就崩了
WebSocket 下，文本帧用上述字符串判断；二进制帧建议固定头 2 字节，如 \x00\x01 表示心跳
别在心跳响应里塞时间戳或随机数，增加无谓带宽和解析负担

客户端不按约定发心跳，服务端怎么兜底？

不能全指望客户端守约。真实环境中常有弱网、APP 后台冻结、代码 Bug 导致心跳停发。Workerman 提供 $connection->lastMessageTime，可结合定时器做二次校验。

例如，在 Worker::run() 启动后加一个每 10 秒执行的检查：

Timer::add(10, function() {
    foreach ($worker->connections as $connection) {
        if (time() - $connection->lastMessageTime > 75) {
            $connection->close();
        }
    }
});