php怎么调试接口头部信息_php接口请求头与响应头调试方法

雪夜 2025-11-20 00:00:00 次阅读

首先使用getallheaders()或$_SERVER获取请求头，再通过headers_list()查看响应头，结合输出缓冲与日志记录完整通信过程，最后用Postman、curl或浏览器开发者工具验证头部信息。

调试 PHP 接口的请求头和响应头，关键在于清晰地查看客户端发送了哪些头部信息，以及服务器返回了哪些头部内容。以下是一些实用的方法来帮助你高效调试。

1. 查看请求头信息（客户端发来的头部）

在 PHP 接口中，可以通过 getallheaders() 函数获取所有传入的请求头：

$headers = getallheaders();
print_r($headers);

这个函数会返回一个关联数组，包含所有请求头字段，比如 Authorization、Content-Type、User-Agent 等。

如果 getallheaders() 不可用（某些 SAPI 环境下可能受限），可以手动从 $_SERVER 中提取：

function getRequestHeaders() {
    $headers = [];
    foreach ($_SERVER as $key => $value) {
        if (strpos($key, 'HTTP_') === 0) {
            $headerName = str_replace(' ', '-', ucwords(strtolower(str_replace('_', ' ', substr($key, 5)))));
            $headers[$headerName] = $value;
        }
    }
    return $headers;
}
print_r(getRequestHeaders());

2. 调试响应头（服务器返回的头部）

使用 headers_list() 可以查看当前脚本已经设置但尚未发送的响应头：

// 设置一些响应头
header('Content-Type: application/json');
header('X-Debug: true');
// 查看已设置的响应头
var_dump(headers_list());

注意：这个函数只能在 header() 调用之后、输出之前使用，否则无法获取完整列表。

3. 捕获并分析实际发送的响应头

如果你想看到浏览器或客户端实际接收到的响应头，可以在服务端开启输出缓冲，并记录完整响应过程：

ob_start();
// 正常输出内容
echo json_encode(['status' => 'success']);
$responseBody = ob_get_clean();
// 获取即将发送的响应头
$sentHeaders = headers_list();
// 输出调试信息（建议写入日志，而不是直接输出）
error_log("Response Headers: " . print_r($sentHeaders, true));
error_log("Response Body: " . $responseBody);
// 发送响应
foreach ($sentHeaders as $header) {
header($header);
}
echo $responseBody;