PHP curl_multi_info_read 读取已完成请求结果的处理方法
来源:17golang原创
时间:2026-11-20 10:20:39 156浏览 收藏
PHP 的 curl_multi_exec() 只负责推进多个传输,不能单独告诉你“哪个请求刚刚完成、结果是什么”。并发循环里应在每次推进后调用 curl_multi_info_read(),把完成消息逐条取空,再用消息里的句柄读取响应和错误。
官方地址:https://www.php.net/manual/en/function.curl-multi-info-read.php
msg关注是否为CURLMSG_DONE,result才是单个传输的 cURL 结果码。handle是已完成的CurlHandle,要用它取响应体和 HTTP 状态码。- 读取完结果后再
curl_multi_remove_handle(),最后关闭 easy handle,不能把 HTTP 200 当成业务成功。
先把已完成消息、结果码和句柄关系理顺
curl_multi_info_read($multi, $queuedMessages) 每调用一次,就从 multi handle 的消息队列取出一条信息;没有更多消息时返回 false。返回数组中的 msg 当前通常是 CURLMSG_DONE,result 是该传输对应的 CURLE_* 结果,handle 则指向具体 easy handle。
这里有三个容易混淆的层次:传输结果表示 DNS、连接、TLS 或读写是否完成;curl_getinfo() 得到的 HTTP 状态码表示服务器响应;响应体里的 JSON 或业务码还要由应用自己判断。只有把这三层分开,失败处理才不会漏掉 404、业务拒绝或超时。

用 curl_multi_info_read 收口每个已完成传输
调用 curl_multi_exec() 推进传输后,要用内层 while 把当前已经排队的完成消息全部取出。不能只读一次,否则多个请求同时完成时,剩余消息会留到下一轮,容易造成结果延迟或重复维护。
$curlResult,
'http_code' => (int) curl_getinfo($handle, CURLINFO_RESPONSE_CODE),
'body' => curl_multi_getcontent($handle),
'error' => $curlResult === CURLE_OK ? null : curl_error($handle),
];
// 结果已复制到数组后,再从 multi 中移除并关闭 easy handle。
curl_multi_remove_handle($multi, $handle);
curl_close($handle);
}
} while ($running > 0);
// $results 仍需按业务协议检查 HTTP 状态码和响应体。
?>
判断重点是 $message['result'],而不是 curl_multi_exec() 的返回值。后者描述 multi 调度本身,前者才对应某一个完成句柄;CURLE_OK 也只代表传输层成功。
移除句柄前保留响应和错误信息
curl_multi_info_read() 返回的句柄是后续取值的索引。先调用 curl_multi_getcontent() 取出响应体,再用 curl_getinfo() 读取 HTTP 状态码;如果 result 不是 CURLE_OK,同时保存 curl_error()。这些数据复制完成后,才执行 remove 和 close。
| 检查项 | 回答的问题 | 处理建议 |
|---|---|---|
msg | 消息是否代表传输完成 | 只对 CURLMSG_DONE 收口 |
result | 网络传输是否成功 | 非 CURLE_OK 记录错误并决定重试 |
| HTTP 状态码 | 服务器返回什么协议状态 | 单独处理 2xx、4xx、5xx |
| 响应体 | 业务操作是否成功 | 按 JSON 或业务字段解析,不能只看 200 |
一个常见坑是先 curl_multi_remove_handle() 再取结果。这样做会让后续的句柄状态和返回内容变得不可靠;尤其是打算把句柄复用到别的请求时,更要先完成结果入库。另一个坑是只检查 HTTP 200:网络成功不等于接口业务成功,响应体仍需解析。

常见问题
curl_multi_info_read 返回 false 是失败吗?
不一定。它也表示当前消息队列暂时没有更多完成消息;应结合 $running 判断是否还有传输,不能把 false 直接当成网络错误。
为什么 curl_errno 还是 0?
通过 multi 执行时,单个句柄的最终错误应以 curl_multi_info_read() 返回数组的 result 为准,再用 curl_error() 取文字描述。
HTTP 200 是否可以直接判定成功?
不可以。它只说明 HTTP 层返回了成功状态,接口 JSON 中的业务码、字段完整性和幂等结果仍需单独判断。
-
278 收藏
-
483 收藏
-
291 收藏
-
195 收藏
-
412 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习