php 获取请求头代码怎么写？常用函数与实例讲解！

发布日期： 2025-10-20 阅读量： 作者： admin

今天得空，正好把我前两天弄那个PHP获取请求头的事儿给记一下，省得以后忘了。

起因是这样的，最近在跟一个第三方服务对接，他们那边要求我们发请求的时候，要在请求头里塞点自定义的东西，类似啥身份令牌之类的玩意儿。发过去是简单，但我这边也得做个接收接口，得能把他们请求里带过来的头信息给读出来，特别是那个自定义的令牌，得拿到手验证一下。

摸索过程

我寻思PHP用了这么久，这获取请求头应该挺直接的。上网查了下，很多人都提到一个函数叫 getallheaders()。

看着挺对口，我就在我自己本地电脑上试了试。我本地是Apache环境，代码写上去跑了一下：

<?php $headers = getallheaders(); print_r($headers); ?>

真好使！ 刷刷刷把所有请求头都打出来了，一个数组，键名是头信息的名字，值就是对应的内容，我要的那个自定义令牌也在里面，清清楚楚。

心里想着这不就搞定了嘛挺简单。然后就把代码弄到我们测试服务器上去了。

遇到问题

结果往测试服务器一放，访问那个页面，直接报错，说 getallheaders() 这个函数未定义！我当时就有点懵。

赶紧又去查了查资料，这才发现，原来 getallheaders() 这个函数，它不是所有环境都支持的。它主要是Apache环境下才能用，或者是用PHP作为Apache模块运行时才行。我们那测试服务器用的是Nginx + PHP-FPM 的架构，根本没这个函数，难怪报错。

这就麻烦了，总不能为了这个函数把服务器环境给换了，那动静太大了。

寻找替代方案

没办法，只能继续找其他路子。我想，请求头这东西是HTTP协议里的基础玩意儿，PHP总不可能只有那一个函数能拿？

后来又是一通翻找，发现大部分信息都藏在PHP的一个超级全局变量里，就是那个大名鼎鼎的 $_SERVER。

这个 $_SERVER 变量里头存了一大堆东西，包括服务器信息、脚本路径、还有客户端的一些信息。仔细一看，很多请求头的信息，都被转换了一下格式放在这里面了。

规律大概是这样的：

所有来自请求头的键名，都会被加上 HTTP_ 前缀。
键名里的字母会全部变成大写。
键名里的横杠会被替换成下划线。

比如说，浏览器发过来一个头是 User-Agent: Mozilla/5.0...，在PHP里，你就可以通过 $_SERVER['HTTP_USER_AGENT'] 来拿到它的值。

如果人家发过来一个自定义的头，比如 X-Custom-Token: 12345abc，那对应的就是 $_SERVER['HTTP_X_CUSTOM_TOKEN']。

最终实现

搞明白了这点，事情就好办了。虽然没有 getallheaders() 那么直接一个函数拿到所有，但至少有办法了。

如果我知道我具体要哪个头，比如我就要那个 X-Custom-Token，直接写代码：

<?php $token = isset($_SERVER['HTTP_X_CUSTOM_TOKEN']) ? $_SERVER['HTTP_X_CUSTOM_TOKEN'] : null; echo $token; ?>

这就拿到了。注意要用 isset() 判断一下，免得人家请求没带这个头，代码直接读会报错。

如果我想拿到所有请求头，像 getallheaders() 那样，就得自己稍微处理一下了。得遍历一遍 $_SERVER 数组，把所有以 HTTP_ 开头的键值对都捞出来，然后再把键名处理一下（去掉 HTTP_ 前缀，下划线换回横杠，可能再转成小写或者首字母大写看着顺眼点）。

大概就像这样写个循环：

<?php $allHeaders = []; foreach ($_SERVER as $key => $value) { if (strpos($key, 'HTTP_') === 0) { $headerKey = str_replace('_', '-', substr($key, 5)); $headerKey = ucwords(strtolower($headerKey), '-'); // 可选：格式化一下键名 $allHeaders[$headerKey] = $value; } } print_r($allHeaders); ?>

这样处理一下，得到的结果就跟 getallheaders() 差不多了，而且这个方法不管是Apache还是Nginx都能用，通用性好多了。

还有些特殊的头，比如 Content-Type、Content-Length，它们可能不会加上 HTTP_ 前缀，而是直接存在 $_SERVER['CONTENT_TYPE'] 和 $_SERVER['CONTENT_LENGTH'] 里。这个得稍微注意一下，如果需要这些头，也要单独去取。

总结一下

我就是用的 $_SERVER 这个办法来获取我需要的那个自定义请求头。虽然比直接用 getallheaders() 稍微麻烦了点，要自己注意键名的转换规则，但胜在稳定可靠，不用担心服务器环境换了就不能用的问题。

就这么个小坑，折腾了一小会儿，记下来分享一下，希望能帮到可能遇到同样问题的朋友。

上一篇: 设计网站优化有哪些方法？提升网站流量看这几点！

下一篇: 给公司做个网站要多少钱？预算有限看这里省钱攻略分享。

php 获取请求头代码怎么写？常用函数与实例讲解！

随便看看