Swoole 不提供按时间自动清理过期连接的独立配置，而是通过 heartbeat_check_interval 和 heartbeat_idle_time 协同检测并关闭无响应的死连接；需配合主动 ping/pong 与时间戳管理，否则幽灵连接将持续占用资源。
直接说结论：Swoole 本身不提供“按时间自动清理过期连接”的独立配置项，而是靠 heartbeat_check_interval 和 heartbeat_idle_time 两个参数协同实现——它不是清理“过期”，而是清理“无响应”的死连接。
为什么不能只靠 timeout 配置？
Swoole 的 timeout（如 tcp_keepidle）是操作系统级的 TCP 层保活，不可控、延迟高、且默认关闭；而应用层需要更灵敏、可编程的判断逻辑。你看到的“连接超时”现象，绝大多数其实是客户端断网后没发 FIN，服务端还傻等，形成幽灵连接。
- 仅设
timeout不生效：Swoole Server 的timeout配置（如worker_timeout）控制的是 worker 进程空闲退出，和连接生命周期无关 -
tcp_keepalive开启了也靠不住：Linux 默认 2 小时才探测一次，远超业务容忍范围 - 真正起作用的是心跳机制：必须主动 ping + 客户端 pong + 定时扫描三者配合
必须配的两个核心参数
这两个参数是 Swoole 底层内置的心跳检测开关，写在 $server->set() 里：
-
heartbeat_check_interval：心跳检查周期（秒），建议设为 30～60。值太小增加 CPU 负载，太大延迟发现死连接 -
heartbeat_idle_time：连接空闲超时时间（秒），必须 >heartbeat_check_interval，建议设为 90～180。超过这个时间没收到任何数据（包括 pong），Swoole 会直接调用close并触发close回调
示例：
$server->set([
'heartbeat_check_interval' => 45,
'heartbeat_idle_time' => 120,
]);
注意：heartbeat_idle_time 是“最后收包时间”起算，不是连接建立时间。只要客户端持续发消息（哪怕只是空帧），就不会被踢。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
为什么还要自己写定时器发 ping？
因为 Swoole 底层心跳只检测“有没有数据进来”，不区分业务消息和心跳响应。如果你的协议里没有显式 pong，或者客户端漏回 pong，底层无法判断它是“忙于处理”还是“已经挂了”。这时候就得自己加一层主动探测：
- 用
Swoole\Timer::tick()每 30 秒遍历$server->connections - 对每个 fd 调用
$server->push($fd, 'ping') - 在
message回调里捕获'pong'并更新时间戳 - 定时器内检查时间戳，超 90 秒未 pong 就
$server->disconnect($fd)
这个逻辑不能省——否则客户端静默卡死，你永远等不到它自己断开。
容易被忽略的坑
最常踩的三个点：
- 没在
open回调里初始化时间戳：新连接进来不记时间，第一次 ping 就可能误判超时 - 在
close回调里忘了unset($lastPong[$fd])：内存泄漏 + 后续定时器访问已释放 fd 报 warning - 客户端 pong 消息体带空格或换行（如
"pong\n"）：===判断失败，时间戳不更新，连接很快被踢
真正的清理难点不在配置，而在“怎么定义一个连接是否还活着”。TCP 连接本身没有状态反馈，你得靠协议层约定 + 主动探测 + 时间窗口三重确认。少一环，幽灵连接就悄悄占着 FD 和内存。
