Apache模块 mod_headers

说明	通过配置文件控制任意的HTTP请求和应答头
状态	Extension
模块名	headers_module
源文件	mod_headers.c
兼容性	`RequestHeader` is available only in Apache 2.0

概述

这个模块提供了一些指令用于控制和修改HTTP请求和应答头。这些头可以被合并、替换、删除。

处理顺序

由mod_headers提供的指令几乎可以出现在配置文件的任何部分。可以用于主服务器配置段、虚拟主机配置段、<Directory>, <Location>和<Files>配置段、.htaccess文件中。

这些指令按照以下顺序处理：

主服务器(main server)
虚拟主机(virtual host)
<Directory>配置段和.htaccess
<Files>
<Location>

这个处理顺序是非常重要的。下面的指令如果颠倒一下顺序将会导致完全不同的结果：

RequestHeader append MirrorID "mirror 12" RequestHeader unset MirrorID

当前顺序下，"MirrorID"头不会被设置。若颠倒一下顺序，"MirrorID"头将被设为"mirror 12"。

例子

将所有请求头中以"TS"开头的头复制到应答头中：
Header echo ^TS
在应答中添加一个"MyHeader"头来包含服务端接受到请求的时间戳和经过多少时间以后才完成对该请求的处理并作出应答。这个头可以让客户端知道瓶颈位于服务端还是位于服务端和客户端之间的线路。
Header add MyHeader "%D %t"

上面的设置将会添加如下应答头内容：

MyHeader: D=3775428 t=991424704447256
向Joe问好(Hello)：
Header add MyHeader "Hello Joe. It took %D microseconds \ for Apache to serve this request."

上面的设置将会添加如下应答头内容：

MyHeader: Hello Joe. It took D=3775428 microseconds for Apache to serve this request.
当且仅当"MyRequestHeader"出现在请求头中的时候才在应答中发送"MyHeader"头。这个对根据特定的客户端构造特定的应答头很有用。注意，下面的例子需要mod_setenvif模块的支持。
SetEnvIf MyRequestHeader value HAVE_MyRequestHeader Header add MyHeader "%D %t mytext" env=HAVE_MyRequestHeader

如果请求中出现"MyRequestHeader: value"头，应答中将会包含下面的头：

MyHeader: D=3775428 t=991424704447256 mytext

Header 指令

说明	配置HTTP应答头
语法	`Header [condition] set\|append\|add\|unset\|echo header [value] [env=[!]variable]`
作用域	server config, virtual host, directory, .htaccess
覆盖项	FileInfo
状态	Extension
模块	mod_headers
兼容性	`Condition` 只在2.0.51及以后版本中可用

这个指令可以替换、合并、删除HTTP应答头。应答头紧跟在内容处理器和输出过滤器完工之后生成，这时候才能对头进行修改。

condition选项可以是onsuccess或always。它决定了将对哪个内部头(internal header)表进行操作。onsuccess表示"2xx"状态码，always表示所有状态码(包含"2xx")。特别地，如果你想撤销由某个模块设置的头，你应当做做试验，以找到是那个表产生的影响。

该指令执行的动作是由第二个参数决定的。这个参数取值范围如下：

set: 设置新的或修改已经存在的同名应答头。value可以是一个格式字符串。
append: 向同名应答头添加新内容而不修改原来已经存在的旧内容。当向一个已经存在的头添加新值时，将用逗号与原来已经存在的旧值分开。这是向HTTP头赋以多个值的标准方法。
add: 向应答中添加新的头而不修改原来已经存在的头(即使同名)。这将可能导致有两个或更多的应答头具有相同的名字，从而导致意想不到的后果，所以通常不使用这种方法而用"append"来代替它。
unset: 去除应答中同名的头(若存在的话)。如果有多个头同名，则会被全部去除。
echo: 将请求中同名的头复制到应答中。header可以是一个正则表达式。

这个参数后面必须要跟一个header名字(结尾的冒号可要可不要)。set, append, add, unset是大小写无关的。用于echo的header名是大小写敏感的，并且可以是一个正则表达式。

对于add, append和set来说，value是第三个参数。如果value包含空格则必须用双引号(")括起来。value可以是一个普通字符串或包含格式说明符的字符串，value支持下列格式字符串：

`%t`	接收到请求的微秒时间戳(相对于1970-1-1 00:00:00 UCT)，外加一个"`t=`"前缀。
`%D`	从接收到请求到完成对该请求的处理并作出应答共花费了多少时间，外加一个"`D=`"前缀。
`%{FOOBAR}e`	环境变量`FOOBAR`的内容

当Header指令和add, append, set参数一起使用时，第四个参数可以用于指定在什么条件下才会采取这个动作。如果在"env=..."参数中指定的环境变量存在(或如果用"env=!..."表示不存在)，那么Header指令指定的动作将会生效，否则将不会生效。

Header指令在应答最后被发送到网络前处理。这意味着可以设置和改写绝大多数应答头，除了mod_headers本身添加的应答头。

RequestHeader 指令

说明	配置HTTP请求头
语法	`RequestHeader set\|append\|add\|unset header [value]`
作用域	server config, virtual host, directory, .htaccess
覆盖项	FileInfo
状态	Extension
模块	mod_headers

这个指令可以替换、合并、删除HTTP应答头。请求头将会在内容处理器动作之前被修改。修改的动作由第一个参数决定，其取值范围如下：

set: 设置新的或修改已经存在的同名请求头。
append: 向同名请求头添加新内容而不修改原来已经存在的旧内容。当向一个已经存在的头添加新值时，将用逗号与原来已经存在的旧值分开。这是向HTTP头赋以多个值的标准方法。
add: 向请求中添加新的头而不修改原来已经存在的头(即使同名)。这将可能导致有两个或更多的请求头具有相同的名字，从而导致意想不到的后果，所以通常不使用这种方法而用"append"来代替它。
unset: 去除请求中同名的头(若存在的话)。如果有多个头同名，则会被全部去除。

这些参数后面必须要跟一个header名字(结尾的冒号可要可不要，且大小写无关)。对于add, append和set来说，value是第三个参数。如果value包含空格则必须用双引号(")括起来。对于unset来说则不需要value参数。

RequestHeader指令在请求被设定的处理器处理之前生效。这意味着请求头的内容可以由浏览器产生并由Apache输入过滤器修改。