Apache 模块 mod_setenvif

Description: 允许根据请求的 Feature 设置环境变量
Status: Base
Module Identifier: setenvif_module
Source File: mod_setenvif.c

Summary

mod_setenvif模块允许您根据请求的不同方面是否匹配您指定的正则表达式来设置内部环境变量。服务器的其他部分可以使用这些环境变量来决定要采取的措施，以及可以用于 CGI 脚本和 SSI 页面。

指令按照在配置文件中出现的 Sequences 进行考虑。因此，可以使用更复杂的序列，例如本示例，如果浏览器是 mozilla 而不是 MSIE，则它将设置netscape。

BrowserMatch ^Mozilla netscape
BrowserMatch MSIE !netscape

当服务器通过内部subrequest查找路径(例如查找DirectoryIndex或使用mod_autoindex生成目录列表)时，在子请求中不会继承每个请求的环境变量。此外，由于 API 阶段mod_setenvif会采取行动，因此在子请求中不会单独评估SetEnvIf指令。

BrowserMatch Directive

Description: 设置以 HTTP User-Agent 为条件的环境变量
Syntax: BrowserMatch regex [!]env-variable[=value] [[!]env-variable[=value]] ...
Context: 服务器配置，虚拟主机，目录，.htaccess
Override: FileInfo
Status: Base
Module: mod_setenvif

BrowserMatch是SetEnvIf指令的特殊情况，该指令将环境变量设置为以User-Agent HTTP 请求 Headers 为条件。以下两行具有相同的效果：

BrowserMatch Robot is_a_robot
SetEnvIf 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 Directive

Description: 设置环境变量以用户代理为条件，不考虑大小写
Syntax: BrowserMatchNoCase regex [!]env-variable[=value] [[!]env-variable[=value]] ...
Context: 服务器配置，虚拟主机，目录，.htaccess
Override: FileInfo
Status: Base
Module: 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 Directive

Description: 根据请求的属性设置环境变量
Syntax: SetEnvIf attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ...
Context: 服务器配置，虚拟主机，目录，.htaccess
Override: FileInfo
Status: Base
Module: mod_setenvif

SetEnvIf伪指令基于请求的属性定义环境变量。在第一个参数中指定的* attribute *可以是以下四项之一：

第二个参数(* regex )是regular expression。如果 regex 与 attribute *相匹配，则将评估其余参数。

其余参数提供要设置的变量的名称，以及可选的应设置变量的值。这些采取的形式

在第一种形式中，该值将设置为“ 1”。第二个将删除给定变量(如果已定义)，第三个将将该变量设置为value给定的 Literals 值。从 2.0.51 版开始，Apache httpd 将识别值中出现的$1 .. $9并将其替换为正则表达式的带括号的子表达式。 $0提供对该模式匹配的整个字符串的访问。

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\.example\.com intra_site_referral
    
SetEnvIf object_is_image xbm XBIT_PROCESSING=1
    
SetEnvIf Request_URI "\.(.*)$" EXTENSION=$1

SetEnvIf ^TS  ^[a-z]  HAVE_TS

如果请求是针对图像文件，则前三个将设置环境变量object_is_image，如果引用页面位于www.mydomain.example.com网站上的某个位置，则前四个将设置intra_site_referral。

如果请求包含以“ TS”开头的任何 Headers，且其值以集合[a-z]中的任何字符开头，则最后一个示例将设置环境变量HAVE_TS。

See also

SetEnvIfExpr Directive

Description: 根据 ap_expr 表达式设置环境变量
Syntax: SetEnvIfExpr expr [!]env-variable[=value] [[!]env-variable[=value]] ...
Context: 服务器配置，虚拟主机，目录，.htaccess
Override: FileInfo
Status: Base
Module: mod_setenvif

SetEnvIfExpr指令基于<If> ap_expr定义环境变量。这些表达式将在运行时求值，并以与SetEnvIf相同的方式应用* env-variable *。

SetEnvIfExpr "tolower(req('X-Sendfile')) == 'd:\images\very_big.iso')" iso_delivered

每当我们的应用程序尝试通过X-Sendfile发送环境变量iso_delivered时，就会设置环境变量iso_delivered

一个更有用的示例是，如果远程 IP 地址是根据 RFC 1918 的私有地址，则设置变量 rfc1918：

SetEnvIfExpr "-R '10.0.0.0/8' || -R '172.16.0.0/12' || -R '192.168.0.0/16'" rfc1918

See also

SetEnvIfNoCase Directive

Description: 根据请求的属性设置环境变量，而不考虑大小写
Syntax: SetEnvIfNoCase attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ...
Context: 服务器配置，虚拟主机，目录，.htaccess
Override: FileInfo
Status: Base
Module: mod_setenvif

SetEnvIfNoCase在语义上与SetEnvIf伪指令相同，不同之处仅在于，正则表达式匹配以不区分大小写的方式执行。例如：

SetEnvIfNoCase Host Example\.Org site=example

如果 HTTP 请求 Headers 字段Host:被包含并包含Example.Org，example.org或任何其他组合，则这将导致site环境变量设置为“ example”。

首页