isEstablished 是唯一可靠判断 WebSocket 连接是否有效的方法，因 $server->connections 为废弃只读迭代器，无法保证 fd 有效性；需在 onMessage 等回调中传入整数 fd 调用，并配合 getClientList() 使用。
isEstablished 为什么不能直接用 $server->connections 遍历判断
因为 $server->connections 是一个只读迭代器（Swoole 4.1+ 起已标记为废弃），它返回的 fd 列表不保证连接仍有效——可能已断开、未完成握手，甚至根本没通过 WebSocket 协议升级。直接 foreach 遍历并 push，大概率触发 SWOOLE_ERROR_CLIENT_NO_CONNECTION 或静默失败。
而 isEstablished(int $fd): bool 是 Swoole 提供的**唯一可靠方式**：它内部检查 fd 是否存在、是否已完成 WebSocket 握手、是否处于 ESTABLISHED 状态（不是 TCP 连接刚建立但还没发 Upgrade 请求那种）。v4.3.0+ 后，exist($fd) 已退化为仅查 fd 是否在连接池中，不再等价于“可通信”，必须换用 isEstablished。
isEstablished 的典型使用位置和条件
它只能在 onMessage、onClose、onWorkerStart（配合定时任务）等回调里安全调用，且必须传入有效的整数 fd。常见误用包括：
- 在
onOpen回调里对刚进来的$req->fd调用 —— 实际上此时连接刚握手成功，isEstablished必然返回 true，没必要多此一举 - 把非整数（如字符串
"123"）或负数 fd 传进去 —— 返回 false，但不会报错，容易掩盖逻辑 bug - 在异步任务（
onTask）里调用时，未确认该 fd 在当前 worker 进程中是否仍有效 —— Swoole 的 fd 是进程局部的，跨 worker 查会失效
广播消息时怎么正确结合 isEstablished
想给所有在线客户端发消息，别写成这样：
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
foreach ($server->connections as $fd) {
$server->push($fd, $data); // ❌ 风险高，可能 push 到已断开或未握手的 fd
}
应该这样：
foreach ($server->getClientList() as $fd) {
if ($server->isEstablished($fd)) {
$server->push($fd, $data);
}
}
注意两点：
-
getClientList()返回的是当前 worker 进程内有效的 fd 列表（比connections更准），但它仍需配合isEstablished做最终校验 - 如果用了 task 进程做广播，必须先用
$server->sendMessage()把数据发到 worker 进程再执行推送，不能在 task 里直接调isEstablished
isEstablished 返回 false 的真实原因有哪些
它返回 false 不代表“一定断开了”，可能是以下任一情况：
- fd 对应的连接已关闭，但 Swoole 还没来得及从内存清理（尤其高频断连场景）
- 客户端完成了 TCP 连接，但没发 WebSocket Upgrade 请求（比如用 curl 直连 ws:// 地址，没走协议）
- 连接被
close()主动关闭，但onClose回调还没触发完，此时isEstablished可能短暂返回 true 或 false，取决于时机 - worker 进程重启后，旧 fd 在新进程中无效 —— 此时查任何 fd 都会返回 false
所以，不要把它当“心跳检测”用；真正需要保活，得靠 ping_interval/ping_timeout 配合客户端 pong 响应。
