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

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']。但行为有差异:
立即学习“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_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反推响应头内容——它只是长度,不是内容快照。










