# Apache模块 mod_setenvif
| [说明](#calibre_link-11) | 根据客户端请求头字段设置环境变量 |
| --- | --- |
| [状态](#calibre_link-12) | 基本(B) |
| [模块名](#calibre_link-13) | setenvif_module |
| [源文件](#calibre_link-14) | mod_setenvif.c |
### 概述
`mod_setenvif`模块允许根据请求的不同方面匹配指定的正则表达式来设置环境变量。这些环境变量可由服务器的其他部分使用。
指令按照他们在配置文件中出现的顺序生效。所以可以使用更多的复合序列，正如下例所示，如果浏览器是mozilla而非MSIE则会设置`netscape` 。
```
BrowserMatch ^Mozilla netscape
BrowserMatch MSIE !netscape
```
## BrowserMatch 指令
| [说明](#calibre_link-18) | 基于User-Agent头有条件地设置环境变量 |
| --- | --- |
| [语法](#calibre_link-19) | `BrowserMatch _regex [!]env-variable_[=_value_] [[!]_env-variable_[=_value_]] ...` |
| [作用域](#calibre_link-20) | server config, virtual host, directory, .htaccess |
| [覆盖项](#calibre_link-66) | FileInfo |
| [状态](#calibre_link-21) | 基本(B) |
| [模块](#calibre_link-22) | 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 指令
| [说明](#calibre_link-18) | 基于不区分大小写的User-Agent头有条件地设置环境变量 |
| --- | --- |
| [语法](#calibre_link-19) | `BrowserMatchNoCase _regex [!]env-variable_[=_value_] [[!]_env-variable_[=_value_]] ...` |
| [作用域](#calibre_link-20) | server config, virtual host, directory, .htaccess |
| [覆盖项](#calibre_link-66) | FileInfo |
| [状态](#calibre_link-21) | 基本(B) |
| [模块](#calibre_link-22) | 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 指令
| [说明](#calibre_link-18) | 根据客户端请求属性设置环境变量 |
| --- | --- |
| [语法](#calibre_link-19) | `SetEnvIf _attribute regex [!]env-variable_[=_value_] [[!]_env-variable_[=_value_]] ...` |
| [作用域](#calibre_link-20) | server config, virtual host, directory, .htaccess |
| [覆盖项](#calibre_link-66) | FileInfo |
| [状态](#calibre_link-21) | 基本(B) |
| [模块](#calibre_link-22) | mod_setenvif |
`SetEnvIf`指令根据客户端的请求属性设置环境变量。第一个参数_attribute_必须是下列三种类别之一：
1. 一个HTTP请求头域(参见[RFC2616](http://www.rfc-editor.org/rfc/rfc2616.txt))；例如：`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兼容的正则表达式](#calibre_link-67 "see glossary")。如果_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环境变量](#calibre_link-232)，以获得更多例子。
## SetEnvIfNoCase 指令
| [说明](#calibre_link-18) | 根据大小写无关的客户端请求属性设置环境变量 |
| --- | --- |
| [语法](#calibre_link-19) | `SetEnvIfNoCase _attribute regex [!]env-variable_[=_value_] [[!]_env-variable_[=_value_]] ...` |
| [作用域](#calibre_link-20) | server config, virtual host, directory, .htaccess |
| [覆盖项](#calibre_link-66) | FileInfo |
| [状态](#calibre_link-21) | 基本(B) |
| [模块](#calibre_link-22) | mod_setenvif |
`SetEnvIfNoCase`等同于`SetEnvIf` ，仅仅是进行不区分大小写的匹配。例如：
```
SetEnvIfNoCase Host Apache\.Org site=apache
```
这会将环境变量`site`设置为"`apache`"(如果"`Host:`"请求头包含"`Apache.Org`"、"`apache.org`"等大小写变体)。
- Apache HTTP Server Version 2.2 文档 [最后更新：2006年3月21日]
- 版本说明
- 从1.3升级到2.0
- 从2.0升级到2.2
- Apache 2.2 新特性概述
- Apache 2.0 新特性概述
- The Apache License, Version 2.0
- 参考手册
- 编译与安装
- 启动Apache
- 停止和重启
- 配置文件
- 配置段(容器)
- 缓冲指南
- 服务器全局配置
- 日志文件
- 从URL到文件系统的映射
- 安全方面的提示
- 动态共享对象(DSO)支持
- 内容协商
- 自定义错误响应
- 地址和端口的绑定(Binding)
- 多路处理模块
- Apache的环境变量
- Apache处理器的使用
- 过滤器(Filter)
- suEXEC支持
- 性能方面的提示
- URL重写指南
- Apache虚拟主机文档
- 基于主机名的虚拟主机
- 基于IP地址的虚拟主机
- 大批量虚拟主机的动态配置
- 虚拟主机示例
- 深入研究虚拟主机的匹配
- 文件描述符限制
- 关于DNS和Apache
- 常见问题
- 经常问到的问题
- Apache的SSL/TLS加密
- SSL/TLS高强度加密：绪论
- SSL/TLS高强度加密：兼容性
- SSL/TLS高强度加密：如何...?
- SSL/TLS Strong Encryption: FAQ
- 如何.../指南
- 认证、授权、访问控制
- CGI动态页面
- 服务器端包含入门
- .htaccess文件
- 用户网站目录
- 针对特定平台的说明
- 在Microsoft Windows中使用Apache
- 在Microsoft Windows上编译Apache
- Using Apache With Novell NetWare
- Running a High-Performance Web Server on HPUX
- The Apache EBCDIC Port
- 服务器和支持程序
- httpd - Apache超文本传输协议服务器
- ab - Apache HTTP服务器性能测试工具
- apachectl - Apache HTTP服务器控制接口
- apxs - Apache 扩展工具
- configure - 配置源代码树
- dbmmanage - 管理DBM格式的用户认证文件
- htcacheclean - 清理磁盘缓冲区
- htdbm - 操作DBM密码数据库
- htdigest - 管理用于摘要认证的用户文件
- httxt2dbm - 生成RewriteMap指令使用的dbm文件
- htpasswd - 管理用于基本认证的用户文件
- logresolve - 解析Apache日志中的IP地址为主机名
- rotatelogs - 滚动Apache日志的管道日志程序
- suexec - 在执行外部程序之前切换用户
- 其他程序
- 杂项文档
- 与Apache相关的标准
- Apache模块
- 描述模块的术语
- 描述指令的术语
- Apache核心(Core)特性
- Apache MPM 公共指令
- Apache MPM beos
- Apache MPM event
- Apache MPM netware
- Apache MPM os2
- Apache MPM prefork
- Apache MPM winnt
- Apache MPM worker
- Apache模块 mod_actions
- Apache模块 mod_alias
- Apache模块 mod_asis
- Apache模块 mod_auth_basic
- Apache模块 mod_auth_digest
- Apache模块 mod_authn_alias
- Apache模块 mod_authn_anon
- Apache模块 mod_authn_dbd
- Apache模块 mod_authn_dbm
- Apache模块 mod_authn_default
- Apache模块 mod_authn_file
- Apache模块 mod_authnz_ldap
- Apache模块 mod_authz_dbm
- Apache模块 mod_authz_default
- Apache模块 mod_authz_groupfile
- Apache模块 mod_authz_host
- Apache模块 mod_authz_owner
- Apache模块 mod_authz_user
- Apache模块 mod_autoindex
- Apache模块 mod_cache
- Apache模块 mod_cern_meta
- Apache模块 mod_cgi
- Apache模块 mod_cgid
- Apache模块 mod_charset_lite
- Apache模块 mod_dav
- Apache模块 mod_dav_fs
- Apache模块 mod_dav_lock
- Apache模块 mod_dbd
- Apache模块 mod_deflate
- Apache模块 mod_dir
- Apache模块 mod_disk_cache
- Apache模块 mod_dumpio
- Apache模块 mod_echo
- Apache模块 mod_env
- Apache模块 mod_example
- Apache模块 mod_expires
- Apache模块 mod_ext_filter
- Apache模块 mod_file_cache
- Apache模块 mod_filter
- Apache模块 mod_headers
- Apache模块 mod_ident
- Apache模块 mod_imagemap
- Apache模块 mod_include
- Apache模块 mod_info
- Apache模块 mod_isapi
- Apache模块 mod_ldap
- Apache模块 mod_log_config
- Apache模块 mod_log_forensic
- Apache模块 mod_logio
- Apache模块 mod_mem_cache
- Apache模块 mod_mime
- Apache模块 mod_mime_magic
- Apache模块 mod_negotiation
- Apache模块 mod_nw_ssl
- Apache模块 mod_proxy
- Apache模块 mod_proxy_ajp
- Apache模块 mod_proxy_balancer
- Apache模块 mod_proxy_connect
- Apache模块 mod_proxy_ftp
- Apache模块 mod_proxy_http
- Apache模块 mod_rewrite
- Apache模块 mod_setenvif
- Apache模块 mod_so
- Apache模块 mod_speling
- Apache模块 mod_ssl
- Apache模块 mod_status
- Apache模块 mod_suexec
- Apache模块 mod_unique_id
- Apache模块 mod_userdir
- Apache模块 mod_usertrack
- Apache模块 mod_version
- Apache模块 mod_vhost_alias
- Developer Documentation for Apache 2.0
- Apache 1.3 API notes
- Debugging Memory Allocation in APR
- Documenting Apache 2.0
- Apache 2.0 Hook Functions
- Converting Modules from Apache 1.3 to Apache 2.0
- Request Processing in Apache 2.0
- How filters work in Apache 2.0
- Apache 2.0 Thread Safety Issues
- 词汇和索引
- 词汇表
- 指令索引
- 指令速查
- 模块索引
- 站点导航