1. HTTP头部命名转换机制解析
当从客户端（如java应用程序）发送自定义http头部到php服务端时，开发者可能会发现原始头部名称在php的$_server超全局变量中发生了变化。例如，一个名为x-auth-hmac的头部会变为http_x_auth_hmac。这种转换并非偶然或错误，而是遵循了cgi 1.1规范（rfc 3875）中的标准行为。
根据RFC 3875的第4.1.18节规定：
那些以HTTP_开头的元变量包含从客户端请求头部字段读取的值，如果使用的协议是HTTP。HTTP头部字段名会被转换为大写，所有出现的连字符-会被替换为下划线_，并预先添加HTTP_以形成元变量名。
这意味着，所有非标准（即非Content-Type、Content-Length等）的HTTP请求头部，在通过CGI或FastCGI接口传递给PHP时，都会经过以下三步转换：
- 添加前缀：在头部名称前加上HTTP_。
- 转换为大写：将整个头部名称（不含前缀）转换为大写。
- 替换连字符：将头部名称中的所有连字符-替换为下划线_。
因此，X-Auth-HMAC头部在PHP的$_SERVER中最终会以HTTP_X_AUTH_HMAC的形式出现。
2. Java客户端发送自定义HTTP头部示例
以下是一个使用Java HttpClient发送自定义X-Auth-HMAC头部的示例代码：
立即学习“PHP免费学习笔记（深入）”；
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.concurrent.CompletableFuture;
public class HttpClientExample {
public static void main(String[] args) {
HttpClient client = HttpClient.newBuilder().build();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("http://php-fpm:80")) // 替换为你的PHP服务地址
.header("Content-Type", "application/json")
.header("X-Auth-HMAC", "test_hmac_header_value") // 自定义头部
.POST(HttpRequest.BodyPublishers.ofString("{\"message\":\"hello from java\"}"))
.build();
CompletableFuture> responseFuture = client.sendAsync(
request,
HttpResponse.BodyHandlers.ofString()
);
responseFuture.thenAccept(response -> {
System.out.println("Status Code: " + response.statusCode());
System.out.println("Response Body: " + response.body());
}).join(); // 等待异步操作完成
}
} 在这个示例中，我们明确地设置了一个名为X-Auth-HMAC的头部，其值为test_hmac_header_value。
3. PHP服务端接收与验证
当上述Java客户端请求到达PHP服务端时，PHP可以通过$_SERVER超全局变量访问到这些头部信息。然而，正如前面所解释的，X-Auth-HMAC将变为HTTP_X_AUTH_HMAC。
在PHP脚本中，你可以这样验证：
'; print_r($_SERVER); echo ''; // 直接访问转换后的头部 if (isset($_SERVER['HTTP_X_AUTH_HMAC'])) { $hmacHeader = $_SERVER['HTTP_X_AUTH_HMAC']; echo "从 \$ _SERVER 获取的 X-Auth-HMAC 值: " . $hmacHeader . "\n"; } else { echo "HTTP_X_AUTH_HMAC 头部未找到。\n"; } // 进一步展示其他获取头部的方法 echo "\n--- 使用 getallheaders() 获取所有头部 ---\n"; if (function_exists('getallheaders')) { $headers = getallheaders(); print_r($headers); if (isset($headers['X-Auth-HMAC'])) { echo "从 getallheaders() 获取的 X-Auth-HMAC 值: " . $headers['X-Auth-HMAC'] . "\n"; } } else { echo "getallheaders() 函数不可用 (例如在某些 PHP SAPI 环境下)。\n"; } ?>
运行上述PHP脚本，你将会在$_SERVER的输出中看到类似以下内容：
[
...
"HTTP_HOST" => "php-fpm:80",
"HTTP_CONTENT_TYPE" => "application/json",
"HTTP_X_AUTH_HMAC" => "test_hmac_header_value", // 转换后的自定义头部
...
]
从 $_SERVER 获取的 X-Auth-HMAC 值: test_hmac_header_value
--- 使用 getallheaders() 获取所有头部 ---
Array
(
[Host] => php-fpm:80
[Content-Type] => application/json
[X-Auth-HMAC] => test_hmac_header_value // 原始名称的自定义头部
)
从 getallheaders() 获取的 X-Auth-HMAC 值: test_hmac_header_value4. 在PHP中获取HTTP头部的方法
在PHP中，主要有两种方式来获取HTTP请求头部：
-
$_SERVER 超全局变量： 这是最常见且始终可用的方法。如前所述，自定义头部会经过RFC 3875的转换规则，即添加HTTP_前缀，转换为大写，并用下划线替换连字符。
- 优点：普遍可用，无需额外配置。
- 缺点：头部名称被转换，需要开发者了解并适应这种命名规则。
- 使用场景：绝大多数情况下的首选方法。
-
getallheaders() 函数： 这个函数会返回一个关联数组，其中键是原始的HTTP头部名称（例如X-Auth-HMAC），值是对应的头部内容。
- 优点：获取到的头部名称与客户端发送时保持一致，更直观。
- 缺点：该函数并非在所有PHP SAPI（Server API）中都可用。例如，在某些PHP-FPM配置下，可能无法直接使用，或者需要Web服务器（如Apache）特定的模块支持。对于Nginx + PHP-FPM组合，通常需要确保Nginx正确地将所有头部传递给PHP-FPM。
- 使用场景：当你需要获取原始头部名称且确认当前环境支持时。
5. 注意事项与最佳实践
- 理解标准行为：PHP中HTTP头部的命名转换是CGI规范的一部分，并非PHP自身的错误。理解这一机制是正确处理HTTP请求的关键。
- 统一访问策略：为了代码的健壮性和可移植性，建议在PHP代码中统一访问HTTP头部的方式。如果依赖于$_SERVER，则始终预期并处理其命名转换。如果项目对原始头部名称有强需求，且环境允许，可以使用getallheaders()，但要做好兼容性检查。
- Web服务器配置：在使用Nginx + PHP-FPM时，确保Nginx的fastcgi_param配置正确地将所有请求头部传递给PHP-FPM。例如，fastcgi_pass_header指令可以用来确保自定义头部被传递。通常，Nginx默认会将所有以HTTP_开头的头部传递给PHP-FPM，但如果遇到问题，值得检查相关配置。
总结
自定义HTTP头部在从Java客户端发送到PHP服务端时，其名称在$_SERVER超全局变量中发生变化，是遵循RFC 3875（CGI 1.1规范）的标准化行为。具体表现为添加HTTP_前缀、转换为大写、并将连字符替换为下划线。开发者在PHP中访问这些头部时，应根据$_SERVER的命名规则进行匹配，或在确认环境支持的情况下，使用getallheaders()函数获取原始头部名称。理解这一转换机制对于构建稳定可靠的跨语言通信至关重要。
