必须使用swoole\coroutine\http\client发送http请求,原生curl会阻塞协程;get需在co\run中执行、正确设置ssl参数、检查statuscode再读body;post需手动设json头或配置超时;并发需独立client+channel;https须显式启用ssl并配置证书;recv()是确认响应送达的唯一可靠方式。

要在Swoole协程环境中发送HTTP请求,必须使用 Swoole\Coroutine\Http\Client,原生cURL或同步函数会阻塞协程调度,导致整个协程环境退化为串行执行,严重削弱并发能力。
基础GET请求发送
第一步:确保在 Co\run() 协程环境中执行,否则 go() 和客户端实例均无法正常工作。
第二步:创建客户端实例,注意端口与SSL参数——访问 HTTPS 站点时第三个参数必须为 【true】,否则连接将被拒绝或超时;HTTP站点则传 false 或省略。
第三步:调用 get() 方法并传入路径(如 '/api/status'),该方法为同步写法但底层完全异步,不阻塞当前协程。
第四步:检查 $client->statusCode 是否为 200,再读取 $client->getBody() 获取响应体;未检查状态码直接读 body 可能拿到空字符串或错误内容。
POST请求发送JSON数据
方法一:手动设置头 + json_encode 请求体
先调用 $client->setHeaders(['Content-Type' => 'application/json']),再把 PHP 数组用 json_encode($data, JSON_UNESCAPED_UNICODE) 转成字符串,最后传给 post('/api/user', $jsonString)。
方法二:用 set() 配置全局超时,避免默认 5 秒太长影响高并发场景——例如设 ['timeout' => 3.0],超时后 post() 返回 false,需主动判断。
注意:若服务端返回 4xx/5xx 状态码,post() 仍返回 true,仅表示请求已发出,不代表业务成功;必须靠 $client->statusCode 和 $client->getBody() 二次校验。
并发发起多个HTTP请求
① 初始化一个 chan = new Swoole\Coroutine\Channel(10),容量设为请求数量,防止协程写入阻塞。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版,它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构,内置 TCP/HTTP/WebSocket 服务器,能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
② 对每个 URL 启动独立协程:go(function () use ($url, $chan) { ... });,内部创建新 Client、发请求、recv 后将结果 $chan->push($result)。
③ 主协程循环 for ($i = 0; $i pop(); } 收集全部响应。
这一步不能复用同一个 Client 实例发多个请求——每个协程必须持有独立 Client,否则因共享状态引发 headers 污染或 body 错乱。复用连接应通过连接池实现,而非手动复用对象。
处理HTTPS请求的必要配置
创建客户端时必须显式传入 true 启用 SSL,例如:new Swoole\Coroutine\Http\Client('api.example.com', 443, true)。
若目标域名使用自签名证书或内网 CA,需额外调用 $client->set(['ssl_cert_file' => '/path/to/cert.pem', 'ssl_key_file' => '/path/to/key.pem']),否则连接直接失败且无明确报错。
跳过证书验证(仅限开发)可设 ['ssl_verify_peer' => false, 'ssl_allow_self_signed' => true],但生产环境【严禁使用】。
请求发出后如何确认已送达
调用 get() 或 post() 后,仅表示请求已写入内核 socket 缓冲区,不代表服务端已接收。
真正可靠的确认方式是调用 $client->recv() 并检查返回值:返回 true 表示完整响应已就绪;返回 false 且 $client->errCode === SWOOLE_ERROR_HTTP_CLIENT_EMPTY_RESPONSE 说明对端未返回任何数据。
若只发不管回包(如日志上报),应在独立协程中调用 recv(),避免主流程等待;不调 recv() 将导致连接长期挂起,最终耗尽连接池。










