mod_setenvif - Apache HTTP Server Version 2.2 中文文档
Apache模块 mod_setenvif
| 说明 | 根据客户端请求头字段设置环境变量 |
|---|---|
| 状态 | 基本(B) |
| 模块名 | setenvif_module |
| 源文件 | mod_setenvif.c |
概述
mod_setenvif模块允许根据请求的不同方面匹配指定的正则表达式来设置环境变量。这些环境变量可由服务器的其他部分使用。
指令按照他们在配置文件中出现的顺序生效。所以可以使用更多的复合序列，正如下例所示，如果浏览器是mozilla而非MSIE则会设置netscape 。
BrowserMatch ^Mozilla netscape
BrowserMatch MSIE !netscape
BrowserMatch 指令
| 说明 | 基于User-Agent头有条件地设置环境变量 |
|---|---|
| 语法 | BrowserMatch regex [!]env-variable[=value] [[!]env-variable[=value]] ... |
| 作用域 | server config, virtual host, directory, .htaccess |
| 覆盖项 | FileInfo |
| 状态 | 基本(B) |
| 模块 | 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
BrowserMatchNoCase 指令
| 说明 | 基于不区分大小写的User-Agent头有条件地设置环境变量 |
|---|---|
| 语法 | BrowserMatchNoCase regex [!]env-variable[=value] [[!]env-variable[=value]] ... |
| 作用域 | server config, virtual host, directory, .htaccess |
| 覆盖项 | FileInfo |
| 状态 | 基本(B) |
| 模块 | 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 指令
| 说明 | 根据客户端请求属性设置环境变量 |
|---|---|
| 语法 | SetEnvIf attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... |
| 作用域 | server config, virtual host, directory, .htaccess |
| 覆盖项 | FileInfo |
| 状态 | 基本(B) |
| 模块 | mod_setenvif |
SetEnvIf指令根据客户端的请求属性设置环境变量。第一个参数attribute必须是下列三种类别之一：
- 一个HTTP请求头域(参见RFC2616)；例如：
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.0", "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]开头的)。
参见
- Apache环境变量，以获得更多例子。
SetEnvIfNoCase 指令
| 说明 | 根据大小写无关的客户端请求属性设置环境变量 |
|---|---|
| 语法 | SetEnvIfNoCase attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... |
| 作用域 | server config, virtual host, directory, .htaccess |
| 覆盖项 | FileInfo |
| 状态 | 基本(B) |
| 模块 | mod_setenvif |
SetEnvIfNoCase等同于SetEnvIf ，仅仅是进行不区分大小写的匹配。例如：
SetEnvIfNoCase Host Apache\.Org site=apache
这会将环境变量site设置为"apache"(如果"Host:"请求头包含"Apache.Org"、"apache.org"等大小写变体)。