Apache HTTP Server Version 2.4
Apache HTTP Server Version 2.4
| Description: | Allows the setting of environment variables based on characteristics of the request |
|---|---|
| Status: | Base |
| Module Identifier: | setenvif_module |
| Source File: | mod_setenvif.c |
The mod_setenvif module allows you to set
internal environment variables according to whether different aspects of
the request match regular expressions you specify. These
environment variables can be used by other parts of the server
to make decisions about actions to be taken, as well as becoming
available to CGI scripts and SSI pages.
The directives are considered in the order they appear in
the configuration files. So more complex sequences can be used,
such as this example, which sets netscape if the
browser is mozilla but not MSIE.
BrowserMatch ^Mozilla netscape BrowserMatch MSIE !netscape
When the server looks up a path via an internal
subrequest such as looking
for a DirectoryIndex
or generating a directory listing with mod_autoindex,
per-request environment variables are not inherited in the
subrequest. Additionally,
SetEnvIf directives
are not separately evaluated in the subrequest due to the API phases
mod_setenvif takes action in.
| Description: | Sets environment variables conditional on HTTP User-Agent |
|---|---|
| Syntax: | BrowserMatch regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_setenvif |
The BrowserMatch is a special cases of the
SetEnvIf directive that
sets environment variables conditional on the
User-Agent HTTP request header. The following two
lines have the same effect:
BrowserMatch Robot is_a_robot SetEnvIf User-Agent Robot is_a_robot
Some additional examples:
BrowserMatch ^Mozilla forms jpeg=yes browser=netscape BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript BrowserMatch MSIE !javascript
| Description: | Sets environment variables conditional on User-Agent without respect to case |
|---|---|
| Syntax: | BrowserMatchNoCase regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
