©
This document uses PHP Chinese website manual Release
说明 | 允许通过配置文件控制任意的HTTP请求和应答头信息 |
---|---|
状态 | 扩展(E) |
模块名 | headers_module |
源文件 | mod_headers.c |
兼容性 |
RequestHeader 仅在 Apache 2.0 中有效 |
这个模块提供了一些指令用于控制和修改HTTP请求头和应答头。这些头可以被合并、替换、删除。
由mod_headers
提供的指令几乎可以出现在配置文件的任何部分。并可以封装在配置段中以限制其作用范围。
指令的处理顺序很重要,它取决于指令本身在配置文件中的位置和所属配置段在配置文件中的位置。下面的指令如果颠倒一下顺序将会导致完全不同的结果:
RequestHeader append MirrorID "mirror 12"
RequestHeader unset MirrorID
当前顺序下,MirrorID
头不会被设置。若颠倒一下顺序,MirrorID
头将被设为"mirror 12"。
mod_headers
可以应用在请求被处理之前或之后。通常的模式是"后处理",也就是在请求处理完毕之后、发送应答之前设置应答头。[原文:when Request Headers are set immediately before running the content generator and Response Headers just as the response is sent down the wire.]在实际工作的服务器上应当始终使用"后处理"模式。
"前处理"模式应当仅仅作为开发者使用的一种测试/调试辅助工具。可以在指令中使用early
关键字启用"前处理"模式,此时将在处理请求之前设置请求头。这样就可以模拟各种不同的请求以协助调试。
由于"前处理"模式的指令在将URL映射到文件系统之前就生效了,不能依赖于所请求的路径。所以"前处理"模式的指令只能用在主服务器和虚拟主机部分的配置中,而不能用于<Directory>
或<Location>
配置段中。
Header echo ^TS
MyHeader
头来包含服务端接受到请求的时间戳和经过多少时间以后才完成对该请求的处理并作出应答。这个头可以让客户端知道瓶颈位于服务端还是位于服务端和客户端之间的线路。
Header add MyHeader "%D %t"
上面的设置将会添加如下应答头内容:
MyHeader: D=3775428 t=991424704447256
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.
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
说明 | 配置HTTP应答头 |
---|---|
语法 | Header [condition] set|append|add|unset|echo header [value] [early|env=[!]variable] |
作用域 | server config, virtual host, directory, .htaccess |
覆盖项 | FileInfo |
状态 | 扩展(E) |
模块 | mod_headers |
这个指令可以替换、合并、删除HTTP应答头。应答头紧跟在内容处理器和输出过滤器完工之后生成,这时候才能对头进行修改。
condition选项可以是onsuccess
或always
。它决定了将对哪个内部头(internal header)表进行操作。onsuccess
表示"2xx
"状态码,always
表示所有状态码(包含"2xx
")。特别地,如果你想撤销由某个模块设置的头,你应当做做试验,以找到是那个表产生的影响。
该指令执行的动作是由第二个参数决定的。这个参数取值范围如下:
set
append
add
append
来代替它。unset
echo
这个参数后面必须要跟一个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 的内容 |
%{FOOBAR}s |
SSL环境变量FOOBAR 的内容(如果启用了mod_ssl ) |
"%s
"格式符仅在Apache 2.1及以后的版本中可用。它可以代替"%e
"以避免"SSLOptions +StdEnvVars
"带来的额外开销。如果因为别的原因必须开启"SSLOptions +StdEnvVars
",那么"%e
"将比"%s
"更加合适。
Header
后面可以跟一个用于指定生效条件的额外参数(或者用early
表示"前处理")。如果在"env=...
"参数中指定的环境变量存在(或用"env=!...
"表示不存在),那么Header
指令指定的动作将会生效,否则将不会生效。
除非使用early模式,否则Header
指令将在应答最后被发送到网络前处理。这意味着可以设置和改写绝大多数应答头,除了自己添加的应答头。
说明 | 配置HTTP请求头 |
---|---|
语法 | RequestHeader set|append|add|unset header [value] [early|env=[!]variable] |
作用域 | server config, virtual host, directory, .htaccess |
覆盖项 | FileInfo |
状态 | 扩展(E) |
模块 | mod_headers |
兼容性 | 仅在 Apache 2.0 中有效 |
这个指令可以替换、合并、删除HTTP应答头。请求头将会在内容处理器运行之前被修改。修改的动作由第一个参数决定,其取值范围如下:
set
append
add
append
来代替它。unset
这些参数后面必须要跟一个header名(结尾的冒号可要可不要,且大小写无关)。对于add
, append
, set
来说,value是第三个参数。如果value包含空格则必须用双引号(")括起来。对于unset
来说则不需要value参数。value可以是一个普通字符串或包含格式说明符的字符串,格式字符串的用法与Header
指令一样。
RequestHeader
后面可以跟一个用于指定生效条件的额外参数(或者用early
表示"前处理")。如果在"env=...
"参数中指定的环境变量存在(或用"env=!...
"表示不存在),那么RequestHeader
指令指定的动作将会生效,否则将不会生效。
除非使用early模式,否则RequestHeader
将在请求被处理之前生效。这样,由浏览器和Apache输入过滤器产生的请求头都可以被该指令处理。