Apache服务器中PHP的getallheaders()函数大小写问题咨询

首先明确：Apache 没有专门的配置项可以强制 getallheaders() 返回的所有请求头键名统一为首字母大写格式。

为什么会出现大小写不一致的情况？ #

getallheaders() 的返回结果依赖于 Apache 内部对请求头的处理逻辑：

• 对于 HTTP 标准头（比如 Content-Type、User-Agent），Apache 会自动规范化为「每个单词首字母大写、其余小写」的格式；
• 对于自定义请求头，Apache 通常会保留客户端发送时的大小写特征，或者按照连字符分割后每个单词首字母大写的规则转换，但不同 Apache 版本、模块可能存在细微差异，导致部分头的键名不符合预期。

解决办法 #

如果必须统一所有头键名的格式，只能通过代码处理实现，以下是两种常见方案：

1. 规范化所有头键名

遍历 getallheaders() 返回的数组，将每个键名转换为统一的首字母大写格式：

$rawHeaders = getallheaders();
$normalizedHeaders = [];

foreach ($rawHeaders as $key => $value) {
    // 将键名转为小写后，按连字符分割每个单词并首字母大写
    $normalizedKey = ucwords(strtolower($key), '-');
    $normalizedHeaders[$normalizedKey] = $value;
}

// 后续业务逻辑使用 $normalizedHeaders

2. 业务逻辑中忽略大小写（更推荐）

根据 HTTP 协议规范，请求头字段名是大小写不敏感的，因此更稳妥的做法是在判断头是否存在时，忽略大小写：

$headers = getallheaders();
// 将所有键名转为小写，方便统一判断
$lowercaseHeaders = array_change_key_case($headers, CASE_LOWER);

if (isset($lowercaseHeaders['x-custom-header'])) {
    // 处理自定义头的逻辑
}

这样既不用纠结键名的大小写格式，也符合 HTTP 协议的设计原则。

内容的提问来源于stack exchange，提问作者Aiwin