Workerman 5.2.3如何设置连接超时时间-php教程-PHP中文网

workerman 5.2.3 中连接超时需分协议实现：tcp 依赖手动记录时间戳+定时清理；websocket 推荐使用内置 ping_interval/ping_not_response_limit 心跳机制，兼顾兼容性与简洁性。

workerman 5.2.3如何设置连接超时时间

Workerman 5.2.3 中设置连接超时时间，核心不是靠单一参数“一刀切”，而是分场景、分协议（TCP / WebSocket）配合连接保活逻辑 + 主动清理机制来实现。直接设个 timeout 属性并不存在，必须手动组合关键步骤。

TCP 连接超时控制（推荐方式）

适用于纯 TCP 长连接服务（如自定义协议、IM底层通道）：

在 onConnect 中启用长连接并记录初始时间

$worker->onConnect = function ($connection) {
    $connection->keepConnection = true;           // 必须开启，否则发完即断
    $connection->lastMessageTime = time();       // 初始化活跃时间戳
};

在 onMessage 中更新时间戳

$worker->onMessage = function ($connection, $data) {
    $connection->lastMessageTime = time();       // 每次收消息就刷新
    // ……业务处理
};

启动定时器，每 55 秒扫描并关闭超时连接（阈值设为 60 秒）
```
Worker::addTimer(55, function () {
    $now = time();
    foreach (Worker::$connections as $connection) {
        if ($now - $connection->lastMessageTime > 60) {
            $connection->close();
        }
    }
});
```
⚠️ 注意：定时器间隔（55s）必须严格小于超时阈值（60s），否则可能误杀刚发完消息的连接。

头条号
头条号是一款AI文本写作工具，字节跳动推出的内容创作平台。

下载

WebSocket 连接超时（含心跳保活）

WebSocket 协议本身支持 ping/pong，Workerman 5.2.3 提供了更简洁的内置心跳配置：

直接设置 ping_interval 和 ping_not_response_limit

$ws_worker = new Worker('websocket://0.0.0.0:2000');
$ws_worker->ping_interval = 25;                // 每 25 秒发一次 ping
$ws_worker->ping_not_response_limit = 2;        // 连续 2 次没收到 pong 就断开

✅ 这种方式自动处理心跳帧收发与超时判定，兼容所有标准 WebSocket 客户端，无需手动解析 onMessage 中的 ping 帧。