mod_setenvif - Apache 2.2 中文版参考手册

Apache HTTP Server 2.2

<-
   致谢 | 译者声明 | 本篇译者:金步国 | 本页最后更新:2006年1月29日 | 获取最新版本

Apache模块 mod_setenvif

说明根据客户端请求头字段设置环境变量
状态基本(B)
模块名setenvif_module
源文件mod_setenvif.c

概述

mod_setenvif模块允许根据请求的不同方面匹配指定的正则表达式来设置环境变量。这些环境变量可由服务器的其他部分使用。

指令按照他们在配置文件中出现的顺序生效。所以可以使用更多的复合序列,正如下例所示,如果浏览器是mozilla而非MSIE则会设置netscape

BrowserMatch ^Mozilla netscape
BrowserMatch MSIE !netscape

top

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

top

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

BrowserMatchBrowserMatchNoCase只是SetEnvIfSetEnvIfNoCase的一种特殊情况。下面的两行具有相同的效果:

BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot

top

SetEnvIf 指令

说明根据客户端请求属性设置环境变量
语法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]开头的)。

参见

top

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"等大小写变体)。