首先使用getallheaders()或$_SERVER获取请求头，再通过headers_list()查看响应头，结合输出缓冲与日志记录完整通信过程，最后用Postman、curl或浏览器开发者工具验证头部信息。
调试 PHP 接口的请求头和响应头，关键在于清晰地查看客户端发送了哪些头部信息，以及服务器返回了哪些头部内容。以下是一些实用的方法来帮助你高效调试。
1. 查看请求头信息（客户端发来的头部）
在 PHP 接口中，可以通过 getallheaders() 函数获取所有传入的请求头：
$headers = getallheaders(); print_r($headers);
这个函数会返回一个关联数组，包含所有请求头字段，比如 Authorization、Content-Type、User-Agent 等。
如果 getallheaders() 不可用（某些 SAPI 环境下可能受限），可以手动从 $_SERVER 中提取：
立即学习“PHP免费学习笔记（深入）”；
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 参数查看头部交互
- PHP 错误日志或自定义日志文件：将头部信息写入日志，避免影响正常输出
curl -v http://your-api.com/test
基本上就这些。关键是把请求头读清楚，响应头看明白，再结合工具验证，接口头部调试就不难了。
