当前位置:首页 > 文章列表 > 文章 > php教程 > PHP curl_multi_info_read 读取已完成请求结果的处理方法

PHP curl_multi_info_read 读取已完成请求结果的处理方法

来源:17golang原创 2026-11-20 10:20:39 0浏览 收藏

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删除
PHP DateTime 怎样处理创建时间和修改时间的时区PHP DateTime 怎样处理创建时间和修改时间的时区
上一篇
PHP DateTime 怎样处理创建时间和修改时间的时区
PHP Random\Randomizer 怎样注入可测试的随机源
下一篇
PHP Random\Randomizer 怎样注入可测试的随机源
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1140次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1124次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1300次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1238次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1091次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码