本文深入探讨了自定义HTTP头部从Java客户端发送后，在PHP服务端$_SERVER超全局变量中名称发生变化的现象。核心在于PHP环境遵循RFC 3875（CGI 1.1规范）对HTTP头部进行标准化转换，即将头部名称转换为大写，连字符替换为下划线，并添加HTTP_前缀。文章提供了Java发送示例和PHP接收验证，并指导如何在PHP中正确访问这些转换后的头部信息。
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<HttpResponse> 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脚本中，你可以这样验证：
<?php// 打印所有 $_SERVER 变量，观察 HTTP 头部echo '';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_value
4. 在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()函数获取原始头部名称。理解这一转换机制对于构建稳定可靠的跨语言通信至关重要。
以上就是HTTP自定义头部在PHP中的命名转换：RFC 3875解析的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1322518.html
微信扫一扫 
支付宝扫一扫 
