curl_getinfo获取PHP请求信息有哪些

本文深入解析了PHP中curl_getinfo函数的使用要点，涵盖其返回的关键字段含义（如http_code、total_time、starttransfer_time等）、字段存在的条件依赖（如重定向配置、是否执行curl_exec）、常见误用陷阱（如未检查curl_exec返回值导致误判失败、HTTPS证书验证缺失引发http_code为0），并对比了CURLINFO_*常量与字符串键名两种调用方式的安全性差异，最后给出调试时高效获取请求/响应信息的实用建议，帮助开发者准确监控和诊断cURL请求性能与状态。

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

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

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

• url：最终实际请求的 URL（含重定向后地址）
• http_code：响应状态码（如 200、404），注意：若网络失败（如 DNS 解析失败、连接超时），该值为 0
• total_time：整个请求耗时（秒，浮点数），从 curl_exec 开始到结束
• namelookup_time：DNS 解析耗时
• connect_time：TCP 连接建立完成时间
• pretransfer_time：SSL 握手、认证等前置操作完成时间
• starttransfer_time：收到第一个字节响应的时间（即“首字节时间”）
• size_download：下载的响应体字节数（不含响应头）
• header_size：响应头总字节数（含所有重定向的头，若启用了 CURLOPT_HEADER 则会重复计入）
• request_size：发出的请求数据总字节数（含请求行、头、正文）
• redirect_count：实际发生的重定向次数（仅当 CURLOPT_FOLLOWLOCATION 为 true 且服务端返回 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_VERIFYPEER 为 false（不推荐）或配了 CURLOPT_CAINFO，请求会失败，http_code 为 0，但 curl_error 才是真实原因

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

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

• 用常量（如 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_HEADEROUT 为 true）
• 快速调试可这样写：

  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 反推响应头内容——它只是长度，不是内容快照。

  好了，本文到此结束，带大家了解了《curl_getinfo获取PHP请求信息有哪些》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！