必须验证$fd有效性并正确设置opcode/flags：$fd需经isEstablished()校验且仅WebSocket连接有效；push时文本用WEBSOCKET_OPCODE_TEXT（默认），二进制须显式指定WEBSOCKET_OPCODE_BINARY；跨Worker需共享映射或单Worker处理。
push 方法必须传入有效的 $fd 才能发消息
直接调用 $server->push($fd, $data) 前，得确认这个 $fd 真的是当前活跃的 WebSocket 连接 ID。Swoole 不会自动校验连接状态，传入已断开、未完成握手或根本不是 WebSocket 的 $fd，都会静默失败（返回 false），但不会抛异常。
常见错误现象：$server->push(123, "hello") 返回 false，但日志没报错，客户端收不到；或者误把 HTTP 请求的 $request->fd 当作 WebSocket $fd 用（HTTP 连接不能 push）。
-
$fd只在onOpen、onMessage、onClose回调里由 Swoole 提供，且仅对 WebSocket 连接有效 - 不能从 URL 参数、数据库字段、Redis 值里直接读出来就用，必须先验证：用
$server->isEstablished($fd)检查是否仍为有效 TCP 连接 - 更稳妥的做法是配合心跳或
onClose回调清理记录 —— 比如用 Redis Hash 存swoole:fds，断开时删掉对应$fd字段
v4.4.12+ 版本的 $opcode 和 $flags 参数容易混淆
新版 push 签名是 push(int $fd, string $data, int $opcode = WEBSOCKET_OPCODE_TEXT, int $flags = SWOOLE_WEBSOCKET_FLAG_FIN)，旧文档里写的 $binary = false 或 $finish = true 已废弃。不注意这点会导致二进制数据被当文本解析，或帧被截断。
使用场景举例：推送图片 Base64 字符串，应该用 WEBSOCKET_OPCODE_BINARY；推送超长日志分片，需手动控制 SWOOLE_WEBSOCKET_FLAG_FIN 标志位。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- 文本消息：默认即可，
$server->push($fd, "ok")等价于$server->push($fd, "ok", WEBSOCKET_OPCODE_TEXT, SWOOLE_WEBSOCKET_FLAG_FIN) - 二进制消息：必须显式传
WEBSOCKET_OPCODE_BINARY，否则浏览器onmessage收到的是乱码 ArrayBuffer -
$flags一般不用动，除非你要发分片帧（罕见），否则硬写0可能导致接收端卡住
向单个 fd 推送时，别忽略连接可能正在关闭
即使 $server->isEstablished($fd) 返回 true，也不能 100% 保证下一行 push 就成功 —— 因为网络延迟、客户端崩溃、浏览器标签页被强制关闭等，都可能让连接在毫秒级内失效。
所以生产环境务必检查返回值：
if (!$server->push($fd, $msg)) {
// 记录日志，或触发清理逻辑
\Swoole\Coroutine::sleep(0.01); // 避免密集重试
if (!$server->isEstablished($fd)) {
// 确认已断开，从在线列表中移除
$redis->hDel('swoole:fds', $fd);
}
}
- 不要假设
push一定成功，尤其在高并发或弱网环境下 - 避免在循环里无条件重试，容易拖垮 Worker
- 如果业务要求“必达”，得结合 ACK 机制（客户端收到后回一个确认帧）
fd 是进程内临时 ID，跨 Worker 不能直接用
每个 Worker 进程维护自己的连接表，$fd 只在当前 Worker 内有效。如果你用多 Worker（worker_num > 1），而消息来自另一个 Worker（比如 HTTP 请求触发的推送），就不能直接 push($fd)。
典型错误：HTTP 接口收到请求，想推给某个 $fd，但该 $fd 不在当前 Worker 的连接池里 —— 此时 push 必然失败，isEstablished 也返回 false。
- 解决方案一：用
Swoole\Table或 Redis 共享连接映射，再通过sendMessage转发到目标 Worker - 解决方案二：强制所有 WebSocket 连接只由一个 Worker 处理（设
worker_num = 1），适合中小流量场景 - 别尝试用
getWorkerIdByFd这类非公开方法，Swoole 官方不承诺兼容性
$fd 的生命周期管理 —— 它不像数据库 ID 那样稳定，而是一个瞬态连接句柄。存它、查它、用它，每一步都得带状态校验，否则看似简单的 push 就会变成玄学问题。 
