swoole_client同步模式会阻塞worker进程，异步模式需注册on('connect')/on('receive')/on('error')/on('close')回调，协程模式推荐使用swoole\coroutine\client以兼顾同步写法与异步性能。
swoole_client 同步模式会阻塞当前进程
同步模式下，swoole_client 的 connect()、send()、recv() 等调用全部是阻塞的。一旦发起连接或等待响应，整个 Worker 进程就卡住，无法处理其他请求或任务。
常见错误现象包括：
- 并发请求量稍高时，服务吞吐骤降，大量请求排队等待
- 遇到网络超时或服务端无响应，
recv()会一直挂起，直到超时或被 kill - 在 HTTP Server 的
on('request')回调里直接用同步 client，会导致整个 worker 被拖垮
典型写法：
$client = new swoole_client(SWOOLE_SOCK_TCP, SWOOLE_SYNC);
$client->connect('127.0.0.1', 9501);
$client->send("hello");
$recv = $client->recv(); // 这里阻塞，直到收到数据或超时
参数差异：第二个构造参数必须是 SWOOLE_SYNC（或省略，默认值），且不能注册任何 on 回调函数——否则会报错或被忽略。
swoole_client 异步模式必须注册全部关键回调
异步模式不阻塞，但代价是逻辑必须拆成事件驱动：连接成功、收到数据、出错、断开，每个环节都靠回调触发。漏掉任意一个，程序就“静默失败”。
必须注册的回调有：
-
on('connect')：连接建立后触发，send()必须放在这里 -
on('receive')：收到服务端数据时触发 -
on('error')：连接失败或系统级错误时触发（比如 DNS 解析失败） -
on('close')：连接关闭后触发（注意：不是每次send后自动触发）
典型错误写法：
$client = new swoole_client(SWOOLE_SOCK_TCP, SWOOLE_SOCK_ASYNC);
$client->connect('127.0.0.1', 9501); // 这行立即返回，但没注册 connect 回调 → 永远不会 send
echo "done"; // 这行立刻执行，但 client 实际没发出去
正确写法中，所有 I/O 操作都必须嵌套在对应回调内，不能跨回调访问 $client 实例的状态（比如在 connect 里 send，就不能指望 receive 里还能用同一个对象发第二次——除非你手动重连）。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
同步 client 可以复用，异步 client 不能跨事件循环复用
同步 swoole_client 实例可反复 connect → send → recv → close，只要不销毁对象，就能重复使用。
而异步 client 一旦触发 on('close') 或 on('error')，该实例就进入不可用状态。再次调用 connect() 会失败，必须新建实例。
容易踩的坑：
- 在
on('receive')里尝试对同一个$client再次send()，不报错但无效（除非服务端主动保持长连接且未关闭） - 把异步 client 实例存到全局变量或静态属性，在后续请求中复用 → 实际上它早已失效或属于另一个事件循环周期
- 忘记在
on('error')或on('close')中 unset 或置 null，导致内存泄漏
性能影响：同步 client 每次调用都独占线程；异步 client 共享 Reactor 线程，单个进程可支撑数千连接，但回调调度开销略高，不适合极低延迟场景（如高频金融行情推送）。
协程模式下应优先用 Swoole\Coroutine\Client 而非 swoole_client
如果你已在启用协程（Swoole\Runtime::enableCoroutine(true)），直接用 swoole_client 同步/异步模式是过时做法。协程 client 提供了同步写法 + 异步性能的组合：
$client = new Swoole\Coroutine\Client(SWOOLE_SOCK_TCP);
if ($client->connect('127.0.0.1', 9501)) {
$client->send("hello");
$data = $client->recv(); // 看似同步，实际不阻塞其他协程
}
关键区别：
-
swoole_client是面向进程/线程的底层封装，协程 client 是面向协程调度器的封装 - 协程 client 不需要注册回调，错误通过异常抛出，可用
try/catch统一处理 - 协程 client 支持
set(['timeout' => 3.0])精确控制超时，而传统swoole_client的超时依赖stream_set_timeout，行为不稳定
最容易被忽略的一点：协程 client 必须在协程环境里创建和使用。在 onWorkerStart 或普通脚本里直接 new，会退化为同步阻塞行为，且可能触发 warning。
