PHP模拟POST请求与状态码检测方法

本文深入剖析了PHP中使用cURL模拟POST请求时极易被忽视的核心陷阱——HTTP状态码的正确获取与解读，强调必须在curl_exec()执行后立即调用curl_getinfo($ch, CURLINFO_HTTP_CODE)获取真实状态码，而非依赖curl_exec()的返回值或CURLOPT_FAILONERROR选项；同时系统梳理了状态码为0（网络层失败）与4xx/5xx（业务层错误）的本质区别及对应诊断方法，并指出Content-Type设置不当、数据编码错误等常见导致“200却失败”的深层原因，为开发者提供了一套健壮、可调试、语义清晰的HTTP请求实践方案。

用 curl_exec() 之前必须调用 curl_getinfo($ch, CURLINFO_HTTP_CODE)

PHP 的 curl_exec() 只返回响应体内容，**不返回状态码**。直接用 if ($res) { ... } 判断是否成功完全不可靠——哪怕服务器返回 500 或 404，只要网络通、响应有内容，curl_exec() 仍可能返回非 false 值。

正确做法是：执行后立刻用 curl_getinfo() 提取状态码：

$ch = curl_init('https://api.example.com/login');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['user' => 'a', 'pass' => 'b']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); // 关键：必须在这行获取
curl_close($ch);

if ($httpCode === 200) {
    // 成功处理 $res
} elseif ($httpCode >= 400) {
    // 错误响应，注意：401/403/404/500 都会进这里
}

别依赖 CURLOPT_FAILONERROR 自动失败

这个选项看似省事，但它只对 400–599 状态码触发 curl_exec() 返回 false，而实际开发中你往往需要区分 401（未登录）、403（无权限）、404（接口不存在）等语义——一旦开启 CURLOPT_FAILONERROR，这些状态全被“吞掉”，你拿不到原始响应体和具体状态码。

• 关闭它（默认就是关闭的），自己用 curl_getinfo(..., CURLINFO_HTTP_CODE) 判断
• 若需统一拦截错误状态，建议封装成函数，而不是依赖 cURL 自动终止
• 注意：开启后 curl_error($ch) 不一定包含 HTTP 状态信息，仅反映传输层错误

POST 失败但状态码是 200？检查 Content-Type 和数据格式

常见陷阱：后端返回 200，但响应体是 {"error":"invalid json"} 或空字符串。这通常不是 cURL 问题，而是请求发错了。

重点核对：

• 发送 JSON 时，必须显式设置 Content-Type: application/json，且用 json_encode() 编码数据，再传给 CURLOPT_POSTFIELDS
• 发送表单数据时，不要手动拼 key=val&key2=val2，优先用 http_build_query() 防止编码错误
• 某些 API 要求 Content-Type 后带 ; charset=utf-8，少这个可能导致后端解析失败但不报错

超时、DNS失败等场景下 curl_getinfo(..., CURLINFO_HTTP_CODE) 返回 0

状态码为 0 意味着请求根本没发出成功（如域名无法解析、连接超时、SSL 握手失败），此时 curl_error($ch) 和 curl_errno($ch) 才是关键线索。

健壮写法应同时检查：

$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($httpCode === 0) {
    $errno = curl_errno($ch);
    $error = curl_error($ch);
    // 例如：$errno === 6 表示无法解析主机名
    error_log("cURL error {$errno}: {$error}");
} else {
    // 正常处理 HTTP 状态码
}

忽略状态码为 0 的情况，容易把网络故障当成业务失败来处理。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP模拟POST请求与状态码检测方法》文章吧，也可关注golang学习网公众号了解相关技术文章。