Workerman怎么调用外部API？异步HTTP客户端使用教程-php教程-PHP中文网

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怎么调用外部api？异步http客户端使用教程

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']，避免被风控

示例：

Kroto.one

一款面向视频教程和分步指南制作的AI工具，能够帮助用户将知识内容整理成结构清晰的视频教程。

下载

$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 配合指数退避。