workerman/http-client 是 Workerman 5.0 官方推荐的原生协程 HTTP 客户端，需满足 workerman ≥ 5.0、http-client ≥ 2.0、revolt/event-loop 已安装、PHP ≥ 8.1 且正确引入 autoload；onMessage 中应每次新建 Client 实例以复用连接池，避免全局单例；配置 timeout、connect_timeout、max_connections 等参数需按场景调整；严禁混入 file_get_contents、sleep 等同步操作。
workerman/http-client 是 Workerman 5.0 官方推荐的协程 HTTP 客户端，它不是“模拟同步调用”的伪异步，而是在原生协程运行时（Revolt）下真正非阻塞、可复用连接池的实现。只要你的环境满足最低要求，就能直接 await 发请求，不卡主线程、不拖垮并发。
确认环境是否支持协程 HTTP 客户端
Workerman 5.0 的 http-client 依赖底层协程事件循环，不是装上包就能用。必须同时满足：
-
workerman/workerman≥ 5.0.0（检查composer show workerman/workerman） -
workerman/http-client≥ 2.0.0（旧版 1.x 不支持await） - 已安装
revolt/event-loop（composer require revolt/event-loop ^1.0） - PHP 版本 ≥ 8.1（需支持
fibers，JIT 关闭不影响） - 启动脚本顶部已引入自动加载：
require_once __DIR__ . '/vendor/autoload.php';
漏掉任意一项，await $client->get(...) 会直接报 Fiber not running 或 Call to undefined function Revolt\{...} —— 这类错误不是代码写错了，是环境没搭对。
在 onMessage 中正确创建和复用 Client 实例
Client 实例本身是轻量的，但它的连接池是全局共享的。你不该每次请求都 new Workerman\Http\Client()，也不该把它声明为全局变量或静态属性——这会破坏连接池隔离性，还可能引发协程上下文混乱。
正确做法是：在 onMessage 回调内按需实例化，且复用同一个实例处理多个请求（比如一个 API 网关要串行调用三个下游服务）：
$http_worker->onMessage = function ($connection, $request) {
// ✅ 每次请求新建 client，但内部自动复用连接池
$client = new Workerman\Http\Client();
try {
$resp1 = await $client->get('https://api.a.com/user');
$resp2 = await $client->post('https://api.b.com/log', ['data' => 'ok']);
$body = await $resp1->getBody();
$connection->send(json_encode(['user' => json_decode($body, true)]));
} catch (Exception $e) {
$connection->send(json_encode(['error' => $e->getMessage()]));
}
};
注意：Client 不是单例，也不需要手动管理生命周期；Workerman 5.0 的协程调度器会在请求结束时自动清理其关联的 Fiber 资源。
超时、重试、Header 和连接池参数怎么设？
Client 构造函数支持传入配置数组，关键参数有：
-
timeout：总超时（秒），默认 5.0。设太小容易误杀慢接口，设太大会拖住协程；建议根据下游 SLA 设为 8–15 秒 -
connect_timeout：TCP 建连超时，默认 3.0。公网调用建议 ≤ 5，内网可压到 1.0 -
max_connections：每个 host 的最大空闲连接数，默认 10。高并发场景（如 QPS > 500）可提到 30–50 -
max_idle_time：空闲连接存活时间（秒），默认 60。短连接多的场景建议调低至 30 -
headers：默认请求头，比如['User-Agent' => 'Workerman/5.0']，避免被风控
示例：
$client = new Workerman\Http\Client([
'timeout' => 10.0,
'connect_timeout' => 2.0,
'max_connections' => 20,
'headers' => ['Authorization' => 'Bearer xxx']
]);
重试需自行封装，http-client 不内置重试逻辑。简单场景可用 for + try/catch，复杂场景建议用 revolt/event-loop 的 sleep 配合指数退避。
别把同步函数混进协程流程里
常见翻车点：在 await 链中插入 file_get_contents、sleep、curl_exec、PDO 查询等同步操作。它们会彻底阻塞当前 Fiber，导致整个 Worker 进程卡死，其他连接全挂起。
必须替换为协程友好方案：
- 文件读取 → 用
revolt/filesystem或amphp/file（非file_get_contents） - 延时 → 用
Revolt\EventLoop\delay(1000)（毫秒），不是sleep(1) - 数据库 → 必须用
swoole_mysql、amphp/mysql或 Webman 自带的协程 PDO 封装 - Redis → 用
workerman/redis协程客户端，不是phpredis同步扩展
哪怕只有一行 sleep(0.1)，都会让该协程无法 yield，等于在高速公路上突然停车。
最易被忽略的是连接池复用边界：不同域名（如 api.a.com 和 api.b.com）的连接池是隔离的，不能指望一个 Client 实例能共享所有连接。如果大量调用分散在十几个子域名，要考虑 max_connections 是按 host 计的，别算错总连接数上限。
