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']。但行为有差异: