在 PHP 后端开发中，经常需要把运维或测试同学写在终端里的 curl 命令翻译成服务端代码，用来对接第三方接口、抓取页面或调试 Webhook。其中最棘手的一类场景是：目标地址返回 302 状态码，并且响应体里带有错误信息或临时页面内容。命令行下 curl 默认不跟随跳转时会直接打印这段 body，而 PHP 的 curl 扩展如果配置不当，要么只拿到空字符串，要么跟随跳转后丢失了中间响应。要精确模拟 curl 命令行为，必须先理解 libcurl 在 PHP 中的句柄生命周期与几个核心选项的作用。
理解 curl 命令与 PHP curl 扩展的对应选项
命令行 curl 的常用参数在 PHP 中都有一一对应的常量。例如 curl -v 对应 CURLOPT_VERBOSE 配合输出流，curl -X POST 对应 CURLOPT_CUSTOMREQUEST 或 CURLOPT_POST，curl -d 对应 CURLOPT_POSTFIELDS。最关键的是处理重定向的参数：curl -L 表示自动跟随 Location 头，在 PHP 里就是设置 CURLOPT_FOLLOWLOCATION 为 true；而 curl 默认不跟随时会把 302 的响应体输出到 stdout，PHP 中则需要 CURLOPT_RETURNTRANSFER 为 true 才能把 body 作为字符串返回。
很多开发者忽略的一点是，当 CURLOPT_FOLLOWLOCATION 为 false 时，libcurl 在收到 3xx 响应后并不会视为错误，curl_exec 会正常返回该响应的主体。但如果同时没开 CURLOPT_RETURNTRANSFER，返回值是 true 且内容被直接输出，在 CLI 模式外（如 FPM）就可能看不到。另一个坑是 CURLOPT_MAXREDIRS 默认是 0，开启跟随后若不显式设置，超过 0 次跳转会直接报错，这与命令行默认最多 50 次完全不同。
为了完整模拟包括捕获 302 响应内容的需求，我们通常要在一次请求里同时拿到：HTTP 状态码、响应头、响应主体，以及如果跟随跳转后的最终内容。下面通过对比不同配置组合来看差异。
三种模拟方案及其代码实现
第一种方案是不自动跟随跳转，手动读取 302 响应的 body 和 Location 头。这种方式最接近 curl 不带 -L 的行为，能确保你看到服务端在 302 时返回的任何内容。我们使用 CURLOPT_HEADER 为 true 把头信息并入返回字符串，再分割解析。
<?php
$ch = curl_init('http://example.ipipp.com/redirect.php');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, true);
curl_setopt($ch, CURLOPT_NOBODY, false);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, false);
$resp = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$headerSize = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
curl_close($ch);
$headerStr = substr($resp, 0, $headerSize);
$body = substr($resp, $headerSize);
echo "状态码: " . $httpCode . "n";
echo "响应体: " . $body . "n";
if (preg_match('/Location:s*(.+)/i', $headerStr, $m)) {
echo "跳转地址: " . trim($m[1]) . "n";
}
?>
第二种方案是开启自动跟随，但利用 CURLOPT_WRITEFUNCTION 或多次请求来记录每一次跳转的内容。libcurl 在跟随过程中默认只保留最后一次响应的 body，所以如果要捕获中间 302 的内容，就得借助回调函数把每次的传输都存下来。下面示例在跟随跳转时记录所有响应体。
<?php
$blocks = [];
$ch = curl_init('http://example.ipipp.com/redirect.php');
curl_setopt($ch, CURLOPT_RETURNTRANSFONT, false);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_MAXREDIRS, 5);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_WRITEFUNCTION, function($ch, $data) use (&$blocks) {
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$blocks[$code][] = $data;
return strlen($data);
});
curl_exec($ch);
curl_close($ch);
foreach ($blocks as $code => $parts) {
echo "HTTP $code 响应体长度: " . strlen(implode('', $parts)) . "n";
}
?>
第三种方案是结合命令行 curl 的 -L 与 --post302 等语义，在 PHP 中用 CURLOPT_POSTREDIR 控制跳转后是否继续发 POST。这在对接严格 API 时很重要，因为很多 302 来自鉴权中心，若盲目变 GET 会丢失参数。设置 CURLOPT_POSTREDIR 为 CURL_REDIR_POST_ALL 可模拟 curl 的 --post301 --post302 --post303 组合。
常见误区与服务器环境限制
一个广泛流传的误解是：只要 curl_exec 返回 false 就代表请求失败。实际上 302 配合 CURLOPT_FOLLOWLOCATION 为 false 时返回的是 true 且状态码是 302，只有网络层失败或超时才返回 false。用 curl_error 判断会得不到任何信息，正确做法永远是先用 curl_getinfo 取 CURLINFO_HTTP_CODE 再决定逻辑分支。
在共享虚拟主机或开启了 safe_mode 的老版本 PHP 中，CURLOPT_FOLLOWLOCATION 常被禁用，因为其内部会调用跳转后的 URL 且可能绕过 open_basedir。此时若强行设置该选项，curl_exec 会返回 false 并报“disabled by safe mode”类错误。解决办法就是采用第一种手动处理 Location 头的方案，用 PHP 的 parse_url 和独立的 curl 请求链来完成，既绕开限制又完全掌控每次响应内容。
还有一点关于 302 响应体的编码：部分服务在 302 时返回的页面是 HTML 表单自动提交脚本，含隐藏字段。如果业务需要捕获这些内容并提交，必须注意 CURLOPT_COOKIEJAR 与 CURLOPT_COOKIEFILE 的复用，否则跟随跳转后会话丢失，最终拿到的就不是预期页面。借助上述回调记录方案，你可以把每次的 Set-Cookie 头也解析出来，保持上下文连续。
PHPcurl302_redirect修改时间：2026-08-19 03:48:15