Webman中Guzzle的sendAsync()默认不真正异步，因其依赖事件循环但Webman未启用curl_multi handler，且常因调用wait()或未配置连接池（默认pool=1）而退化为同步阻塞；真异步需依托Workerman事件驱动，配合PDrive等协程引擎及then链式处理。
Webman 中直接用 Guzzle 的 sendAsync() 不会真正异步——它只是返回 Promise，但没配事件循环，wait() 一调就又变同步阻塞了。真要非阻塞并发，得靠 Webman 底层的 Workerman 事件驱动能力，而不是靠 Guzzle 自身的“伪异步”。
为什么 sendAsync() 在 Webman 里默认不 work
Guzzle 的 sendAsync() 本质是返回一个 Promise，但它依赖底层 handler（如 CurlMultiHandler）配合事件循环才能真正并发执行。Webman 默认用的是 PHP-FPM 风格的同步 handler，sendAsync() 只是“看起来异步”，实际仍会卡在 wait() 或隐式等待上，进程照样被占住。
- 常见错误现象：
sendAsync()后立刻echo 'done'，但页面仍要等几秒才输出全部内容 - 根本原因：没启用
curl_multihandler，也没注入 Workerman 的事件循环 - 兼容性影响：PHP
用 Psc\Drive\Workerman\PDrive 替换事件循环
这是目前 Webman 生态里最轻量、侵入最小的方案，不需要改 Guzzle 接口，只换 handler 和事件循环。
- 安装：
composer require cclilshy/p-ripple-drive - 配置
config/server.php，取消注释并设为：'event_loop' => \Psc\Drive\Workerman\PDrive::class - 代码中别再手动 new
Client，统一用插件入口：\P\Plugin::Guzzle() - 关键点：不要调
->wait()，所有请求必须用->then()链式处理，否则又掉回阻塞
webman-php/openai 这类专用客户端怎么选
如果你主要对接 OpenAI/Azure/通义千问这类大模型 API，直接用 webman-php/openai 比自己封装 Guzzle 更稳——它已经把流式响应、重试、超时、token 统计这些细节全包进异步流程了。
立即学习“PHP免费学习笔记（深入）”；
- 优势：自动适配 Webman 生命周期，支持
stream+async混合模式，错误码映射更准 - 注意点：它不兼容原生 Guzzle 的中间件和日志插件，调试时得看它自己的
Logger配置项 - 性能差异：比裸 Guzzle + PDrive 略高 5–8%，因为跳过了 PSR-7 request/response 转换开销
- 别踩的坑：初始化 client 时传
['timeout' => 60]是无效的，得走http_options子键
并发数量与连接池的实际控制
很多人以为开了异步就能无限制并发，其实 Workerman 的连接池和系统文件描述符数才是瓶颈。默认 PDrive 的 HTTP 连接池大小是 1，意味着 100 个请求仍是串行发出去的。
- 必须显式配置连接池：
$handle = new \Psc\Plugins\Guzzle\PHandler(['pool' => 20]) - 同时检查系统限制：
ulimit -n至少要 > 并发数 × 2，否则会报Too many open files - 真实场景建议：单 worker 并发控制在 10–30，靠横向扩 worker 数来提升吞吐，比堆单 worker 并发更稳
- 容易被忽略的地方：DNS 解析也走连接池，如果批量请求不同域名，得额外调大
dns_cache_size
