Swoole push方法怎么向指定fd发送消息-Swoole-PHP中文网

必须验证$fd有效性并正确设置opcode/flags：$fd需经isestablished()校验且仅websocket连接有效；push时文本用websocket_opcode_text（默认），二进制须显式指定websocket_opcode_binary；跨worker需共享映射或单worker处理。

swoole push方法怎么向指定fd发送消息

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

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);
    }
}