说明 基于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


说明 基于不区分大小写的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 attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... 作用域 server config, virtual host, directory, .htaccess 覆盖项 FileInfo 状态 基本(B) 模块 mod_setenvif

SetEnvIf指令根据客户端的请求属性设置环境变量。第一个参数attribute必须是下列三种类别之一：

1. 一个HTTP请求头域(参见RFC2616)；例如：Host, User-Agent, Referer, Accept-Language 。可以用一个正则表达式来进行匹配。
2. 下列请求属性之一：
   • 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中去除协议、主机以及查询字符串后剩余的部分)。
3. 列出的与该请求关联的环境变量名字中的一个。这将允许SetEnvIf指令基于预先匹配的结果进行测试。只有那些由较早的SetEnvIf[NoCase]指令定义的环境变量才可以按照这种方式测试。"较早的"意思是它们在更上层的作用域(比如全局范围)中被定义或者在同一作用域中较早出现。只有在请求的属性未能得到匹配并且attribute没有使用正则表达式的时候，环境变量才会被考虑。

第二个参数regex是一个Perl兼容的正则表达式。如果regex是根据attribute进行匹配的，那么剩余的参数将被评估。剩余的参数给出了需要设置的变量名及其可选的值。格式如下：

1. varname
2. !varname
3. varname=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 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"等大小写变体)。