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

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

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

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

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

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

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

立即学习“PHP免费学习笔记（深入）”；

Revealjs Presentations

创建、编辑并部署 reveal.js 演示文稿为单个 HTML 文件，可选自定义 CSS。适用于需要制作演示文稿、幻灯片或宣传材料时使用。

下载

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');
<p>// 查看已设置的响应头
var_dump(headers_list());</p>

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

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

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

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

4. 使用工具辅助调试

除了代码层面的调试，还可以借助外部工具验证请求与响应头：

• Postman / Apifox：查看接口请求和响应的详细头部信息
• Chrome 开发者工具 - Network 面板：点开具体请求，查看 Request Headers 和 Response Headers
• curl 命令：使用 -v 参数查看头部交互

curl -v http://your-api.com/test

• PHP 错误日志或自定义日志文件：将头部信息写入日志，避免影响正常输出

基本上就这些。关键是把请求头读清楚，响应头看明白，再结合工具验证，接口头部调试就不难了。