PHP用curl_getinfo取请求信息有哪些_PHP取信息项说明【详情】

10次阅读

curl_getinfo 返回字段包括 url、http_code、total_time、namelookup_time、connect_time、pretransfer_time、starttransfer_time、size_download、header_size、request_size、redirect_count 等,具体取决于请求状态和选项配置。

PHP用curl_getinfo取请求信息有哪些_PHP取信息项说明【详情】

curl_getinfo 返回哪些字段?关键信息项对照表

curl_getinfo 返回一个关联数组,字段取决于请求是否完成、是否启用某些选项。不是所有字段都始终存在——比如未调用 curl_exec 前调用它,多数值为 NULL;禁用了重定向(CURLOPT_FOLLOWLOCATION 设为 false),则 redirect_count 恒为 0,redirect_url""

常用且较稳定的信息项包括:

  • url:最终实际请求的 URL(含重定向后地址)
  • http_code:响应状态码(如 200404),注意:若网络失败(如 dns 解析失败、连接超时),该值为 0
  • total_time:整个请求耗时(秒,浮点数),从 curl_exec 开始到结束
  • namelookup_time:DNS 解析耗时
  • connect_time:TCP 连接建立完成时间
  • pretransfer_timessl 握手、认证等前置操作完成时间
  • starttransfer_time:收到第一个字节响应的时间(即“首字节时间”)
  • size_download:下载的响应体字节数(不含响应头)
  • header_size:响应头总字节数(含所有重定向的头,若启用了 CURLOPT_HEADER 则会重复计入)
  • request_size:发出的请求数据总字节数(含请求行、头、正文)
  • redirect_count:实际发生的重定向次数(仅当 CURLOPT_FOLLOWLOCATIONtrue 且服务端返回 3xx 才计数)

为什么 curl_getinfo 有时返回 null 或 0?常见误用场景

最常踩的坑是:在 curl_exec 之前或之后(且未捕获执行结果)调用 curl_getinfo,或忽略 curl_error 导致误判成功。

  • 未执行请求就取信息:调用 curl_init 后直接 curl_getinfo → 所有数值字段为 null
  • 请求失败但没检查返回值:curl_exec 返回 false 时,curl_getinfo($ch, CURLINFO_HTTP_CODE) 仍可能返回 0,不代表 HTTP 状态码是 0,而是“未得到有效响应”
  • 未开启 CURLOPT_RETURNTRANSFER 且未捕获输出:若设为 false(默认输出到 stdout),curl_exec 返回 true,但你拿不到响应内容,size_download 仍准确,但业务逻辑可能已错乱
  • https 请求未处理证书验证:若服务端证书异常且未设 CURLOPT_SSL_VERifYPEERfalse(不推荐)或配了 CURLOPT_CaiNFO,请求会失败,http_code0,但 curl_error 才是真实原因

CURLINFO_* 常量 vs 字符串键名:用哪个更稳妥?

两种写法都合法:curl_getinfo($ch, CURLINFO_HTTP_CODE)curl_getinfo($ch)['http_code']。但行为有差异:

立即学习PHP免费学习笔记(深入)”;

  • 用常量(如 CURLINFO_HTTP_CODE):只返回对应单个值,类型明确(如整型),且兼容性更好(php 5.5+ 都支持)
  • 用字符串键名(如 'http_code'):必须先获取完整数组,再取键;若该键不存在(如未启用重定向却访问 'redirect_url'),会触发 Notice(PHP 8+ 默认报 Warning
  • 推荐对关键指标用常量,尤其做条件判断时:if (curl_getinfo($ch, CURLINFO_HTTP_CODE) === 200)if ($info['http_code'] === 200) 更安全

调试时怎么快速打印完整 info?注意 header_size 的陷阱

开发中常需要 dump 全部 info 查问题,但要注意 header_size 容易被误解:

  • curl_setopt($ch, CURLOPT_HEADER, true) 会让响应体开头混入响应头文本,此时 header_size 是原始响应头长度,但你在 curl_exec 返回的字符串里看到的“头”可能被拼接、截断或含多次重定向头
  • 安全做法是分开获取头和体:curl_setopt($ch, CURLOPT_HEADER, false) + curl_setopt($ch, CURLOPT_NOBODY, false),再用 CURLINFO_HEADER_OUT 查发出去的请求头(需提前设 CURLOPT_HEADEROUTtrue
  • 快速调试可这样写:
    curl_setopt($ch, CURLOPT_HEADER, false); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_exec($ch); $info = curl_getinfo($ch); print_r($info); // 看整体耗时、状态、字节数 echo "Request headers sent:n" . curl_getinfo($ch, CURLINFO_HEADER_OUT) . "n";

    别依赖 header_size 反推响应头内容——它只是长度,不是内容快照。

text=ZqhQzanResources