$root.getChild("name").getText()

Directives

#set ($alldirectives =3D $root.getChildren("directive")) #foreach ($directive in $alldirectives)

#set ($allSections =3D $root.getChild("module").getChildren("section")) #foreach ( $section in $allSections ) #section ($section 1) #end

#foreach ($directive in $alldirectives) #directive ($directive $root.getChild("name").getText() = $root.getChild("status").getText())

#end

Apache HTTP Server Version 2.0

Allows the setting of environment variables based=0A= on characteristics of the request

Status: =	Base
Module = Identifier:	setenvif_module

Summary

The mod_setenvif module allows you to set=0A= environment variables according to whether different aspects of=0A= the request match regular expressions you specify. These=0A= environment variables can be used by other parts of the server=0A= to make decisions about actions to be taken.

The directives are considered in the order they appear in=0A= the configuration files. So more complex sequences can be used,=0A= such as this example, which sets netscape if the=0A= browser is mozilla but not MSIE.



=0A=
  BrowserMatch ^Mozilla netscape
=0A=
  BrowserMatch MSIE !netscape
=0A=

For additional information, we provide a document on Environment Variables in Apache.

Directives

BrowserMatch

BrowserMatchNoCase

SetEnvIf

SetEnvIfNoCase

BrowserMatch directive

Description:	Sets = environment variables conditional on HTTP User-Agent=0A=
Syntax: =	BrowserMatch regex = env-variable[=3Dvalue]=0A= [env-variable[=3Dvalue]] ...
Default: =	none
Context: =	server config, virtual host, directory, = .htaccess
Override: =	FileInfo
Status: =	Base
Module: =	mod_setenvif
Compatibility: =	Apache 1.2 and=0A= above (in Apache 1.2 this directive was found in the=0A= now-obsolete mod_browser module)

The BrowserMatch directive defines environment variables=0A= based on the User-Agent HTTP request header field.=0A= The first argument should be a POSIX.2 extended regular=0A= expression (similar to an egrep-style regex). The=0A= rest of the arguments give the names of variables to set, and=0A= optionally values to which they should be set. These take the=0A= form of

varname, or
!varname, or
varname=3Dvalue

In the first form, the value will be set to "1". The second=0A= will remove the given variable if already defined, and the=0A= third will set the variable to the value given by=0A= value. If a User-Agent=0A= string matches more than one entry, they will be merged.=0A= Entries are processed in the order in which they appear, and=0A= later entries can override earlier ones.

For example:



=0A=
    BrowserMatch ^Mozilla forms jpeg=3Dyes browser=3Dnetscape
=0A=
    BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript
=0A=
    BrowserMatch MSIE !javascript
=0A=

Note that the regular expression string is=0A= case-sensitive. For case-INsensitive matching,=0A= see the BrowserMatchNoCase=0A= directive.

The BrowserMatch and=0A= BrowserMatchNoCase directives are special cases of=0A= the SetEnvIf and SetEnvIfNoCase=0A= directives. The following two lines have the same effect:



=0A=
   BrowserMatchNoCase Robot is_a_robot
=0A=
   SetEnvIfNoCase User-Agent Robot is_a_robot
=0A=

BrowserMatchNoCase directive

Description:	Sets = environment variables conditional on User-Agent without=0A= respect to case
Syntax: =	BrowserMatchNoCase regex = env-variable[=3Dvalue]=0A= [env-variable[=3Dvalue]] ...
Default: =	none
Context: =	server config, virtual host, directory, = .htaccess
Override: =	FileInfo
Status: =	Base
Module: =	mod_setenvif
Compatibility: =	Apache 1.2 and=0A= above (in Apache 1.2 this directive was found in the=0A= now-obsolete mod_browser module)

The BrowserMatchNoCase directive is=0A= semantically identical to the BrowserMatch directive.=0A= However, it provides for case-insensitive matching. For=0A= example:



=0A=
    BrowserMatchNoCase mac platform=3Dmacintosh
=0A=
    BrowserMatchNoCase win platform=3Dwindows
=0A=

The BrowserMatch and=0A= BrowserMatchNoCase directives are special cases of=0A= the SetEnvIf and SetEnvIfNoCase=0A= directives. The following two lines have the same effect:



=0A=
   BrowserMatchNoCase Robot is_a_robot
=0A=
   SetEnvIfNoCase User-Agent Robot is_a_robot
=0A=

SetEnvIf directive

Description:	Sets = environment variables based on attributes of the request=0A=
Syntax: =	SetEnvIf attribute=0A= regex env-variable[=3Dvalue]=0A= [env-variable[=3Dvalue]] ...
Default: =	none
Context: =	server config, virtual host, directory, = .htaccess
Override: =	FileInfo
Status: =	Base
Module: =	mod_setenvif
Compatibility: =	Apache 1.3 and=0A= above; the Request_Protocol keyword and environment-variable=0A= matching are only available with 1.3.7 and = later

The SetEnvIf directive defines environment=0A= variables based on attributes of the request. These attributes=0A= can be the values of various HTTP request header fields (see RFC2616=0A= for more information about these), or of other aspects of the=0A= request, including the following:

Remote_Host - the hostname (if available) of=0A= the client making the request
Remote_Addr - the IP address of the client=0A= making the request
Remote_User - the authenticated username (if=0A= available)
Request_Method - the name of the method=0A= being used (GET, POST, et=0A= cetera)
Request_Protocol - the name and version of=0A= the protocol with which the request was made (e.g.,=0A= "HTTP/0.9", "HTTP/1.1", etc.)
Request_URI - the portion of the URL=0A= following the scheme and host portion

Some of the more commonly used request header field names=0A= include Host, User-Agent, and=0A= Referer.

If the attribute name doesn't match any of the=0A= special keywords, nor any of the request's header field names,=0A= it is tested as the name of an environment variable in the list=0A= of those associated with the request. This allows=0A= SetEnvIf directives to test against the result of=0A= prior matches.

Only those environment variables defined by earlier=0A= SetEnvIf[NoCase] directives are available for=0A= testing in this manner. 'Earlier' means that they were=0A= defined at a broader scope (such as server-wide) or=0A= previously in the current directive's scope.

attribute may be a regular expression when used to=0A= match a request header. If attribute is a regular=0A= expression and it doesn't match any of the request's header=0A= names, then attribute is not tested against the=0A= request's environment variable list.

Example:



=0A=
Example:=0A=
   SetEnvIf Request_URI "\.gif$" object_is_image=3Dgif
=0A=
   SetEnvIf Request_URI "\.jpg$" object_is_image=3Djpg
=0A=
   SetEnvIf Request_URI "\.xbm$" object_is_image=3Dxbm
=0A=
        :
=0A=
   SetEnvIf Referer www\.mydomain\.com intra_site_referral
=0A=
        :
=0A=
   SetEnvIf object_is_image xbm XBIT_PROCESSING=3D1
=0A=
        :
=0A=
   SetEnvIf ^TS*  ^[a-z].*  HAVE_TS
=0A=

The first three will set the environment variable=0A= object_is_image if the request was for an image=0A= file, and the fourth sets intra_site_referral if=0A= the referring page was somewhere on the=0A= www.mydomain.com Web site.

The last example will set environment variable=0A= HAVE_TS if the request contains any headers that=0A= begin with "TS" whose values begins with any character in the=0A= set [a-z].

SetEnvIfNoCase directive

Description:	Sets = environment variables based on attributes of the request=0A= without respect to case
Syntax: =	SetEnvIfNoCase attribute regex = env-variable[=3Dvalue]=0A= [env-variable[=3Dvalue]] ...
Default: =	none
Context: =	server config, virtual host, directory, = .htaccess
Override: =	FileInfo
Status: =	Base
Module: =	mod_setenvif
Compatibility: =	Apache 1.3 and above

The SetEnvIfNoCase is semantically identical to=0A= the SetEnvIf directive,=0A= and differs only in that the regular expression matching is=0A= performed in a case-insensitive manner. For example:



=0A=
   SetEnvIfNoCase Host Apache\.Org site=3Dapache=0A=

This will cause the site environment variable=0A= to be set to "apache" if the HTTP request header=0A= field Host: was included and contained=0A= Apache.Org, apache.org, or any other=0A= combination.

#if ($section.getAttributeValue("id")) $heading #else $heading #end

$thedirective.getChild("name").getText() directive

Apache HTTP Server Version 2.0

Apache Module $root.getChild("name").getText()

Summary

Directives

Apache HTTP Server Version 2.0

Apache HTTP Server Version 2.0

Apache Module mod_setenvif

Summary

Directives

BrowserMatch directive

BrowserMatchNoCase directive

SetEnvIf directive

SetEnvIfNoCase directive

Apache HTTP Server Version 2.0