PHP Conference Japan 2024

    apache_request_headers

    (PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

    apache_request_headers — 获取所有 HTTP 请求头

    描述

    apache_request_headers(): 数组

    从当前请求中获取所有 HTTP 请求头。在 Apache、FastCGI、CLI 和 FPM Web 服务器中均有效。

    参数

    此函数没有参数。

    返回值

    当前请求中所有 HTTP 头的关联数组。

    变更日志

    版本 描述
    7.3.0 此函数在 FPM SAPI 中可用。

    示例

    示例 #1 apache_request_headers() 示例

    <?php
    $headers     = apache_request_headers();

    foreach (    $headers as $header => $value) {
    echo     "$header: $value <br />\n";
    }
    ?>

    以上示例将输出类似以下内容

    Accept: */*
Accept-Language: en-us
Accept-Encoding: gzip, deflate
User-Agent: Mozilla/4.0
Host: www.example.com
Connection: Keep-Alive

    备注

    注意:

    您还可以通过从环境中读取它们来获取通用 CGI 变量的值，无论您是否将 PHP 作为 Apache 模块使用。使用 phpinfo() 查看所有可用 环境变量 的列表。

    参见

    发现问题？

    了解如何改进此页面 • 提交拉取请求 • 报告错误
    ＋添加注释

    用户贡献的笔记 5 个笔记

    12
    Tel
    5 年前
    虽然我们期望看到混合大小写的标头，但标准 RFC2616 要求“字段名称不区分大小写”。PHP 完全按原样传递标头，无论客户端以何种方式发送它们。您可能需要预期任何类型的 大写、小写或混合大小写。

    因此，如果您希望符合标准，则必须循环遍历每个键并以不区分大小写的方式检查它，而不是做显而易见的事情并将标头名称用作数组索引。
    10
    limalopex.eisfux.de
    18 年前
    我在 PHP::Compat (http://pear.php.net/package/PHP_Compat) 中找不到 apache_request_headers() 的替代品，所以我自己写了一个

    <?php
    if( !function_exists('apache_request_headers') ) {
    ///
    function apache_request_headers() {
    $arh = array();
    $rx_http = '/\AHTTP_/';
    foreach(    $_SERVER as $key => $val) {
    if(     preg_match($rx_http, $key) ) {
    $arh_key = preg_replace($rx_http, '', $key);
    $rx_matches = array();
    // 进行一些糟糕的字符串操作以恢复原始字母大小写
    // 在大多数情况下，这应该可以工作
    $rx_matches = explode('_', $arh_key);
    if(     count($rx_matches) > 0 and strlen($arh_key) > 2 ) {
    foreach(    $rx_matches as $ak_key => $ak_val) $rx_matches[$ak_key] = ucfirst($ak_val);
    $arh_key = implode('-', $rx_matches);
    }
    $arh[$arh_key] = $val;
    }
    }
    return(     $arh );
    }
    ///
    }
    ///
    ?>
    8
    callum85 at notspam dot msn dot com
    17 年前
    即使在 PHP 作为 CGI 运行时，也有一种简单的方法可以从 Apache 获取请求头。据我所知，这是在 apache_request_headers() 不可用时获取“If-Modified-Since”和“If-None-Match”标头的唯一方法。您需要 mod_rewrite，大多数 Web 主机似乎都启用了它。将此放在 Web 根目录中的 .htaccess 文件中

    RewriteEngine on
    RewriteRule .* - [E=HTTP_IF_MODIFIED_SINCE:%{HTTP:If-Modified-Since}]
    RewriteRule .* - [E=HTTP_IF_NONE_MATCH:%{HTTP:If-None-Match}]

    然后，PHP 中的标头可用作
    <?php
    $_SERVER    ['HTTP_IF_MODIFIED_SINCE'];
    $_SERVER['HTTP_IF_NONE_MATCH'];
    ?>

    我已经在 PHP/5.1.6 上测试了它，在 Apache/2.2.3/Win32 和 Apache/2.0.54/Unix 上都完美运行。

    注意：如果您已经使用 RewriteRules 进行干净的 URL，则需要将上述规则放在现有规则之后。
    5
    egocentryk
    9 年前
    所有用于缺少 getallheaders() 的补丁中使用的超级全局变量 $_SERVER 仅包含真正基本的标头。要将任何标头传递到任何 httpd 环境（包括 CGI/FCGI）中的 PHP 中，只需在 .htaccess 中添加规则（任意数量的规则）

    RewriteRule .* - [E=HTTP_MY_HEADER:%{HTTP:My-Header}]

    并且带有其值的标头将作为 PHP 中的
    <?php print $_SERVER['HTTP_MY_HEADER']; ?>

    并且... 无法控制。重写 $_SERVER 键以替换缺少的函数实际上不需要正则表达式、preg_matches 或 evals... 试试这个
    <?php
    function getallheaders() {
    foreach(    $_SERVER as $K=>$V){$a=explode('_' ,$K);
    if(    array_shift($a)=='HTTP'){
    array_walk($a,function(&$v){$v=ucfirst(strtolower($v));});
    $retval[join('-',$a)]=$V;}
    } return     $retval; }
    ?>
    1
    gilles at sdv dot fr
    1 年前
    函数 apache_request_headers 在 FCGI PHP-FPM 中不存在。

    使用此补丁： https://gist.github.com/rmpel/11583cfddfcc9705578428e3a2ee3dc1

    <?php
    // 当 apache_request_headers() 不可用时，替换为直接插入的代码

    if ( ! function_exists( 'apache_request_headers' ) ) {
    function     apache_request_headers() {
    static     $arrHttpHeaders;
    if ( !     $arrHttpHeaders ) {

    // 基于：http://www.iana.org/assignments/message-headers/message-headers.xml#perm-headers
    $arrCasedHeaders = array(
    // HTTP
    'Dasl' => 'DASL',
    'Dav' => 'DAV',
    'Etag' => 'ETag',
    'Mime-Version' => 'MIME-Version',
    'Slug' => 'SLUG',
    'Te' => 'TE',
    'Www-Authenticate' => 'WWW-Authenticate',
    // MIME
    'Content-Md5' => 'Content-MD5',
    'Content-Id' => 'Content-ID',
    'Content-Features' => 'Content-features',
    );
    $arrHttpHeaders = array();

    foreach (     $_SERVER as $strKey => $mixValue ) {
    if (     'HTTP_' !== substr( $strKey, 0, 5 ) ) {
    continue;
    }

    $strHeaderKey = strtolower( substr( $strKey, 5 ) );

    if (     0 < substr_count( $strHeaderKey, '_' ) ) {
    $arrHeaderKey = explode( '_', $strHeaderKey );
    $arrHeaderKey = array_map( 'ucfirst', $arrHeaderKey );
    $strHeaderKey = implode( '-', $arrHeaderKey );
    } else {
    $strHeaderKey = ucfirst( $strHeaderKey );
    }

    if (     array_key_exists( $strHeaderKey, $arrCasedHeaders ) ) {
    $strHeaderKey = $arrCasedHeaders[ $strHeaderKey ];
    }

    $arrHttpHeaders[ $strHeaderKey ] = $mixValue;
    }

    /** 如果您需要授权并且您的托管服务提供商尚未为您修复此问题：
    * VHOST-配置：
    * FastCgiExternalServer 行需要 -pass-header Authorization
    *
    * .htaccess 或 VHOST-配置文件需要：
    * SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
    * 将 Authorization 标头添加到环境中以进行进一步处理
    */
    if ( ! empty( $arrHttpHeaders['Authorization'] ) ) {
    // 如果有授权，但值没有正确传播，则执行此操作 :)
    if ( ! isset( $_SERVER['PHP_AUTH_USER'] ) ) {
    list(     $_SERVER['PHP_AUTH_USER'], $_SERVER['PHP_AUTH_PW'] ) = explode( ':', base64_decode( substr( $_SERVER['HTTP_AUTHORIZATION'], 6 ) ) );
    }
    }
    }

    return     $arrHttpHeaders;
    }

    // 立即执行，以便其他脚本几乎没有机会污染 $_SERVER 中的信息
    // 数据被缓存，因此多次检索标头不会对性能造成进一步影响。
    apache_request_headers();
    }
    ＋添加注释
    To Top