最可靠方式是用cURL:先curl_exec()再curl_getinfo($ch, CURLINFO_HTTP_CODE),须在curl_exec后、curl_close前调用,且避免误设CURLOPT_NOBODY为true;若curl_exec返回false,则状态码为0,需配合curl_errno()和curl_error()排查网络层错误。

用 curl_getinfo() 拿状态码最可靠
直接读响应头或靠 http_response_code() 都不准——前者可能没收到完整头,后者只返回 PHP 自己设的(比如你用 header("HTTP/1.1 404 Not Found") 才生效),跟实际 HTTP 请求无关。
真正要测接口返回状态,必须走 cURL 并在请求结束后调用 curl_getinfo($ch, CURLINFO_HTTP_CODE):
$ch = curl_init("https://api.example.com/data");
curl_setopt($ch, CURLOPT_NOBODY, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE); // ✅ 这才是真实状态码
curl_close($ch);
-
CURLOPT_NOBODY设为false(默认值),否则拿不到响应体,某些服务还会因此返回 204 或拒绝响应 - 别依赖
CURLOPT_HEADER开关来“解析状态行”,cURL 内部已解析好,curl_getinfo直接取最稳 - 如果
curl_exec()返回false,说明连接失败(如 DNS 错、超时),此时curl_getinfo(..., CURLINFO_HTTP_CODE)会是 0,需单独判断
遇到 0 状态码,先查 curl_error() 和 curl_errno()
状态码为 0 不代表接口返回了 0,而是 cURL 根本没发出去请求。常见原因有网络不通、域名无法解析、SSL 验证失败、超时等。
必须配合错误检查才能定位问题:
立即学习“PHP免费学习笔记(深入)”;
$ch = curl_init("https://api.example.com/data");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($response === false) {
$errno = curl_errno($ch);
$error = curl_error($ch);
// 例如:$errno === 7 → "Failed to connect to ..."
// $errno === 60 → "SSL certificate problem"
}
curl_close($ch);
-
curl_errno()比错误字符串更利于自动化判断,比如7是连接拒绝,28是超时,60是证书验证失败 - 若用自签名证书测试,加
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false)可绕过验证,但仅限开发环境 - 别把
0当成业务异常(如 404/500),它属于基础设施层失败,处理逻辑应和 HTTP 状态码分离
get_headers() 能用,但不推荐用于生产接口检测
它确实能快速拿到状态行,比如 get_headers("https://api.example.com/data")[0] 可能返回 "HTTP/1.1 200 OK",但隐患明显:
- 不支持 POST/PUT 等方法,只能发 GET
- 无法传
Authorization、Content-Type等关键头,很多 API 拒绝无头请求 - 默认不跟随重定向,
get_headers($url, 1)虽可开启,但返回结构混乱,状态码可能来自中间跳转而非最终响应 - 超时控制弱,默认 60 秒且无法细粒度设置连接/读取超时
除非只是临时调试一个公开 GET 接口,否则别把它当主力方案。
注意重定向对状态码的影响
cURL 默认会跟随 301/302,最终 curl_getinfo(..., CURLINFO_HTTP_CODE) 返回的是**最后一次响应的状态码**,不是初始请求的。这通常符合预期,但有些场景需要原始响应码。
- 禁用自动跳转:
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, false),此时 302 就真返回 302 - 想同时看跳转链路?启用
CURLOPT_HEADER+CURLOPT_NOBODY,再手动解析Location头,但复杂度陡增 - 部分 API 用 307/308 做临时重定向且要求保持方法(如 POST),此时
CURLOPT_FOLLOWLOCATION会把它转成 GET,导致后端报错——务必确认重定向行为是否符合协议
真实接口里,3xx 状态往往意味着鉴权失败或资源迁移,不能简单当成“成功”或“失败”处理,得结合 Location 头和业务规则判断。



















