PHP获取HTTP状态码方法及判断技巧

本文深入解析了PHP中获取HTTP请求状态码的三种主流方法——cURL、get_headers()和stream_context_create()配合file_get_contents()，重点强调cURL是**最可靠、最可控**的方案，详细说明了正确调用时机（必须在curl_exec()之后、curl_close()之前）、常见陷阱（如误设CURLOPT_NOBODY、忽略重定向处理）及最佳实践；同时指出get_headers()虽轻量但兼容性差，仅适用于可信环境快速探测，而流上下文方式代码简洁却灵活性不足、存在版本和缓存隐患；最后提醒开发者摒弃“唯200论”，应根据业务场景合理识别2xx成功、3xx重定向、4xx客户端错误等各类状态码，提升接口调用的健壮性与可维护性。

用 curl_getinfo() 获取 HTTP 状态码最可靠

PHP 原生不提供直接“发请求+拿状态码”一步到位的函数，file_get_contents() 之类只会返回响应体，状态码被丢弃了。真正可控的方式是用 cURL：先 curl_exec() 发请求，再用 curl_getinfo($ch, CURLINFO_HTTP_CODE) 提取状态码。

常见错误是调用 curl_getinfo() 之前没执行 curl_exec()，此时返回 0；或者忘了 curl_close($ch)，导致句柄堆积。

• 必须在 curl_exec() 之后、curl_close() 之前调用 curl_getinfo()
• 建议显式设置 curl_setopt($ch, CURLOPT_NOBODY, false)（默认值），避免误设为 true 导致只取头不取体却还期望状态码
• 若需兼容重定向，加 curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true)，此时 CURLINFO_HTTP_CODE 返回的是最终响应的状态码

get_headers() 能快速取状态码但有局限

如果只是想简单探活、不关心响应体，get_headers($url, 1) 是轻量选择。它返回一个数组，第一项通常是类似 "HTTP/1.1 200 OK" 的字符串，可正则或 explode() 解析。

但它依赖远程服务器返回标准格式的 HTTP/ 开头行，有些 CDN 或代理会改写响应头（比如返回 "HTTP/2 200" 或干脆不带协议版本），导致解析失败；而且无法控制超时、UA、证书校验等细节。

• 只适合内网或可信接口的快速探测
• 务必检查返回数组是否非空，空数组代表 DNS 失败或连接被拒
• 使用时加 @ 抑制警告（如 @get_headers($url, 1)），否则网络不通时会报 Warning: get_headers(): failed to open stream

用 stream_context_create() 配合 file_get_contents() 拿状态码

虽然 file_get_contents() 默认不暴露状态码，但通过自定义流上下文，可以让它把响应头信息存进 $http_response_header 全局变量里，再从中提取。

这种方式代码短，但不如 cURL 灵活——比如不能轻易区分 301 和 302 重定向后的最终状态，也不能捕获连接层错误（如 Connection refused）。

• 必须在调用 file_get_contents() 前定义 $http_response_header = []，否则可能读到上一次残留值
• 状态码藏在 $http_response_header[0] 中，例如 "HTTP/1.1 404 Not Found"，需用 sscanf() 或正则提取数字部分
• 注意：该方式在 PHP 8.1+ 中，若启用了 opcache.enable_cli=1 且脚本重复运行，$http_response_header 可能未重置，建议每次显式初始化

判断状态码时别只盯 200，要分场景处理

很多脚本写成 if ($code === 200) { ... }，但实际业务中，304 Not Modified 表示缓存有效，201 Created 是正常创建成功，401 Unauthorized 和 403 Forbidden 含义也不同。硬判 200 容易掩盖逻辑问题。

• 对 API 请求，建议用范围判断：200 表示成功（含 201、204）
• 对健康检查，in_array($code, [200, 301, 302, 307, 308]) 更合理
• 遇到 0 状态码，基本是 cURL 未执行、DNS 失败或超时，不是 HTTP 层问题，得查网络或配置

cURL 是唯一能同时掌控请求过程、精准捕获各阶段状态的方案，其他方法都绕不开妥协。真要稳定判断，别省那几行代码。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~