正确姿势是用cURL配置CURLOPT_NOBODY=true发HEAD请求,禁用返回体和重定向,再用curl_getinfo($ch, CURLINFO_HTTP_CODE)获取真实状态码;遇405则改用GET+丢弃body。

PHP 用 cURL 获取远程文件状态码的正确姿势
直接用 file_get_contents() 或 get_headers() 拿不到真实 HTTP 状态码,尤其遇到重定向、403、404 时容易误判。必须用 cURL 显式控制请求行为才能拿到准确 http_code。
cURL 基础配置:禁用 body、只取 header
多数场景只需状态码,不下载文件内容,否则浪费带宽和时间。关键点是关掉 CURLOPT_RETURNTRANSFER(避免返回 body)+ 开启 CURLOPT_NOBODY(HEAD 请求)+ 设置 CURLOPT_HEADER 为 false(避免混入 header 字符串)。
$ch = curl_init('https://example.com/missing.jpg');
curl_setopt($ch, CURLOPT_NOBODY, true); // 发送 HEAD 请求
curl_setopt($ch, CURLOPT_RETURNTRANSFER, false); // 不要 body 内容
curl_setopt($ch, CURLOPT_HEADER, false); // 不要返回 header 字符串
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, false); // 防止重定向干扰状态码
curl_setopt($ch, CURLOPT_TIMEOUT, 5);
curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
// $httpCode 就是真实的响应状态码,如 200、404、302
处理重定向:要原始状态码还是最终状态码?
默认 cURL 会自动跟随 Location 头跳转,CURLINFO_HTTP_CODE 返回的是**最终响应**的状态码。如果要检查跳转链中某一步是否 301/302,必须关掉 CURLOPT_FOLLOWLOCATION,并手动解析 Location 头或用 CURLINFO_REDIRECT_COUNT 判断是否发生了跳转。
- 要原始响应码(含 301/302)→ 设
CURLOPT_FOLLOWLOCATION = false - 要目标地址最终状态(如跳转后是 200)→ 设
CURLOPT_FOLLOWLOCATION = true,但注意CURLINFO_HTTP_CODE只反映最后一次请求结果 - 想看跳转次数 → 用
curl_getinfo($ch, CURLINFO_REDIRECT_COUNT)
常见陷阱与兼容性提醒
有些服务器对 HEAD 请求返回 405(Method Not Allowed),而 GET 能正常访问。这时不能硬依赖 CURLOPT_NOBODY,得退回到 GET + CURLOPT_HEADER + CURLOPT_NOBODY = false,再用 CURLINFO_HTTP_CODE 提取状态码,同时设 CURLOPT_WRITEFUNCTION 丢弃 body 流以节省内存。
立即学习“PHP免费学习笔记(深入)”;
-
get_headers()在allow_url_fopen=off时直接失效,cURL 是更可靠的 fallback - HTTPS 请求失败常见于 CA 证书问题,加
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false)仅限调试,生产环境必须配好CURLOPT_CAINFO - 状态码为 0 通常意味着连接失败(DNS 解析失败、超时、拒绝连接),不是 HTTP 层错误,需检查
CURLE_OPERATION_TIMEDOUT或CURLE_COULDNT_RESOLVE_HOST
真正难的不是发请求,而是区分「连不上」、「服务器拒收 HEAD」、「返回了非标准状态码」这三类 0 或异常值 —— 它们对应完全不同的排查路径。
