Apache HTTP服务器V2.0
Apache HTTP服务器V2.0
| 说明 | 根据客户端请求的属性设置环境变量 |
|---|---|
| 状态 | Base |
| 模块名 | setenvif_module |
| 源文件 | mod_setenvif.c |
mod_setenvif模块允许根据请求的不同方面匹配指定的正则表达式来设置环境变量。这些环境变量可由服务器的其他部分使用。
指令按照他们在配置文件中出现的顺序生效。所以可以使用更多的复合序列，正如下例所示，如果浏览器是mozilla而非MSIE则会设置netscape。
BrowserMatch ^Mozilla netscape
BrowserMatch MSIE !netscape
| 说明 | 基于User-Agent头有条件地设置环境变量 |
|---|---|
| 语法 | BrowserMatch regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| 作用域 | server config, virtual host, directory, .htaccess |
| 覆盖项 | FileInfo |
| 状态 | Base |
| 模块 | mod_setenvif |
BrowserMatch只是SetEnvIf的一种特殊情况，基于User-Agent头有条件地设置环境变量。下面的两行具有相同的效果：
BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot
更多的例子：
BrowserMatch ^Mozilla forms jpeg=yes browser=netscape
BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript
BrowserMatch MSIE !javascript
| 说明 | 基于不区分大小写的User-Agent头有条件地设置环境变量 |
|---|---|
| 语法 | BrowserMatchNoCase regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| 作用域 | server config, virtual host, directory, .htaccess |
| 覆盖项 | FileInfo |
| 状态 | Base |
| 模块 | mod_setenvif |
BrowserMatchNoCase等同于BrowserMatch，仅仅是进行不区分大小写的匹配。例如：
BrowserMatchNoCase mac platform=macintosh
BrowserMatchNoCase win platform=windows
BrowserMatch和BrowserMatchNoCase只是SetEnvIf和SetEnvIfNoCase的一种特殊情况。下面的两行具有相同的效果：
BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot
| 说明 | 根据客户端请求属性设置环境变量 |
|---|---|
| 语法 | SetEnvIf attribute
regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| 作用域 | server config, virtual host, directory, .htaccess |
| 覆盖项 | FileInfo |
| 状态 | Base |
| 模块 | mod_setenvif |
SetEnvIf指令根据客户端的请求属性设置环境变量。第一个参数attribute必须是下列三种类别之一：
Host,
User-Agent, Referer, Accept-Language。可以用一个正则表达式来指定一组请求头。Remote_Host - 远程主机名(若可用)Remote_Addr - 远程主机IP地址Server_Addr - 接收到请求的服务器IP地址(2.0.43及以后版本)Request_Method - 所用的请求方法(GET, POST等等)Request_Protocol - 请求所使用的协议及其版本("HTTP/0.9", "HTTP/1.1"等)Request_URI - 在HTTP请求行中请求的资源 -- 通常是URL中去除协议、主机以及查询字符串后剩余的部分。SetEnvIf指令基于预先匹配的结果进行测试。只有那些由较早的SetEnvIf[NoCase]指令定义的环境变量才可以按照这种方式测试。"较早的"意思是它们在一个更上一层的作用域(比如全局范围)中被定义或者在同一作用域中较早出现。只有在请求的属性未能得到匹配并且attribute没有使用正则表达式的时候，环境变量才会被考虑。第二个参数regex是一个Perl兼容的正则表达式。如果regex是根据attribute进行匹配的，那么剩余的参数将被评估。剩余的参数给出了需要设置的变量名及其可选的值。格式如下：
varname!varnamevarname=value第一个格式，环境变量varname的值将设为"1"。第二个格式将删除给定的变量varname(若存在)。第三个格式将为环境变量varname设置value的字面值。从2.0.51版开始，Apache将能够识别value中出现的$1..$9，并将其替换为regex中对应的使用括号括起来的子模式。
SetEnvIf Request_URI "\.gif$" object_is_image=gif
SetEnvIf Request_URI "\.jpg$" object_is_image=jpg
SetEnvIf Request_URI "\.xbm$" object_is_image=xbm
:
SetEnvIf Referer www\.mydomain\.com intra_site_referral
:
SetEnvIf object_is_image xbm XBIT_PROCESSING=1
:
SetEnvIf ^TS* ^[a-z].* HAVE_TS
前面的三个将会设置object_is_image环境变量(如果请求的是图片)。第四个将会设置intra_site_referral环境变量(如果Referer头表明的页面来自于www.mydomain.com)。
最后一个将会设置环境变量HAVE_TS(如果包含任何以"TS"开始的请求头，并且该头的值是以小写字母[a-z]开头的)。
| 说明 | 根据大小写无关的客户端请求属性设置环境变量 |
|---|---|
| 语法 | SetEnvIfNoCase attribute regex
[!]env-variable[=value]
[[!]env-variable[=value]] ... |
| 作用域 | server config, virtual host, directory, .htaccess |
| 覆盖项 | FileInfo |
| 状态 | Base |
| 模块 | mod_setenvif |
| 兼容性 | Apache1.3及以后版本 |
SetEnvIfNoCase等同于SetEnvIf，仅仅是进行不区分大小写的匹配。例如：
SetEnvIfNoCase Host Apache\.Org site=apache
这会将环境变量site设置为"apache"(如果请求头Host:包含"Apache.Org"、"apache.org"等大小写变体)。