登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  php教程

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、业务拒绝或超时。

PHP curl_multi_info_read 将完成消息、result 结果码、CurlHandle 与响应体连接起来的静态结构说明图
图1:消息字段结构说明图,展示完成消息、结果码、句柄和响应数据的职责边界;这是原创说明图,不是运行截图。

用 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:网络成功不等于接口业务成功,响应体仍需解析。

PHP CurlHandle 在读取响应体、HTTP状态码和传输错误后再移除并关闭的资源收口结构图
图2:结果与资源收口结构图,强调先复制响应和错误,再移除 easy handle;这是原创结构图,不是运行证据。

常见问题

curl_multi_info_read 返回 false 是失败吗?

不一定。它也表示当前消息队列暂时没有更多完成消息;应结合 $running 判断是否还有传输,不能把 false 直接当成网络错误。

为什么 curl_errno 还是 0?

通过 multi 执行时,单个句柄的最终错误应以 curl_multi_info_read() 返回数组的 result 为准,再用 curl_error() 取文字描述。

HTTP 200 是否可以直接判定成功?

不可以。它只说明 HTTP 层返回了成功状态,接口 JSON 中的业务码、字段完整性和幂等结果仍需单独判断。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>