答案:PHP中可通过getallheaders()或$_SERVER获取请求头,使用file_get_contents配合stream_context或cURL获取响应头,需注意环境兼容性与服务器配置。

在PHP开发中,获取HTTP请求头和响应头信息是处理API交互、身份验证、跨域控制等场景的常见需求。PHP提供了多种方式来读取这些头部信息,下面详细介绍如何正确获取请求头与响应头。
获取HTTP请求头信息
当客户端(如浏览器或App)向服务器发送请求时,会携带一系列请求头,比如User-Agent、Authorization、Content-Type等。PHP可以通过以下几种方式获取这些信息:
1. 使用 getallheaders() 函数
这是最简单直接的方法,该函数返回一个关联数组,包含全部请求头信息:
立即学习“PHP免费学习笔记(深入)”;
$headers = getallheaders();
if ($headers) {
foreach ($headers as $name => $value) {
echo "$name: $value
";
}
}
// 示例输出:
// User-Agent: Mozilla/5.0
// Authorization: Bearer xxxxx
// Content-Type: application/json
注意:getallheaders() 在CLI模式或某些SAPI环境下可能不可用(如PHP-FPM),需确保运行环境支持。
2. 通过 $_SERVER 超全局变量获取
所有HTTP请求头都会被转换为$_SERVER中的键名,格式为HTTP_前缀加全大写并用下划线代替短横线。例如:
- User-Agent → HTTP_USER_AGENT
- Content-Type → CONTENT_TYPE(特殊情况,不加HTTP_)
- Authorization → HTTP_AUTHORIZATION
$userAgent = $_SERVER['HTTP_USER_AGENT'] ?? ''; $authorization = $_SERVER['HTTP_AUTHORIZATION'] ?? ''; $contentType = $_SERVER['CONTENT_TYPE'] ?? $_SERVER['HTTP_CONTENT_TYPE'] ?? '';
这种方法兼容性更好,推荐在生产环境中使用。
获取HTTP响应头信息
当你作为客户端使用PHP发起HTTP请求(如调用第三方API),有时需要读取响应头,比如获取认证令牌、检查缓存策略或重定向地址。
1. 使用 file_get_contents() 配合 stream_context
通过设置上下文选项发送请求,并利用stream_get_meta_data()获取响应头:
$opts = [
'http' => [
'method' => 'GET',
'header' => "Authorization: Bearer token123\r\n" .
"User-Agent: MyApp/1.0\r\n"
]
];
$context = stream_context_create($opts);
$result = file_get_contents('https://api.example.com/user', false, $context);
// 获取响应头
$meta = stream_get_meta_data($http_response_header);
$responseHeaders = $http_response_header; // 此变量由PHP自动填充
foreach ($responseHeaders as $header) {
echo $header . "
";
}
注意:$http_response_header 是一个特殊变量,只有在使用file_get_contents等流函数时才会自动创建。
2. 使用 cURL 扩展(更灵活)
cURL允许你精确控制请求,并捕获响应头:
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, true); // 包含头信息
curl_setopt($ch, CURLOPT_NOBODY, false);
$response = curl_exec($ch);
$headerSize = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
$headers = substr($response, 0, $headerSize);
$body = substr($response, $headerSize);
// 解析响应头
foreach (explode("\r\n", $headers) as $header) {
if (strpos($header, ':') !== false) {
list($name, $value) = explode(': ', $header, 2);
echo "$name: $value
";
}
}
curl_close($ch);
常见问题与注意事项
- Authorization头缺失:某些服务器配置会过滤掉Authorization头,需在Nginx或Apache中启用传递(如Nginx加fastcgi_pass_header Authorization;)。
- 大小写敏感:虽然HTTP头本身不区分大小写,但PHP中$_SERVER的键名是固定的,应使用大写格式访问。
- 性能考虑:频繁解析大量头部时建议缓存结果或使用轻量方法。











