Module Apache mod_setenvif

BrowserMatch Directive

La directive BrowserMatch est un cas particulier de la directive SetEnvIf, qui d�finit des variables d'environnement en fonction du contenu de l'en-t�te de requ�te HTTP User-Agent. Les deux lignes suivantes produisent le m�me effet :

BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot

Quelques exemples suppl�mentaires :

BrowserMatch ^Mozilla forms jpeg=yes browser=netscape
BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript
BrowserMatch MSIE !javascript

BrowserMatchNoCase Directive

La directive BrowserMatchNoCase est identique sur le plan s�mantique � la directive BrowserMatch. Elle permet cependant une comparaison insensible � la casse. Par exemple :

BrowserMatchNoCase mac platform=macintosh
BrowserMatchNoCase win platform=windows

Les directives BrowserMatch et BrowserMatchNoCase sont des cas particuliers des directives SetEnvIf et SetEnvIfNoCase. Ainsi, les deux lignes suivantes produisent le m�me effet :

BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot

SetEnvIf Directive

La directive SetEnvIf permet de d�finir des variables d'environnement en fonction des attributs de la requ�te. L'attribut sp�cifi� comme premier argument peut se pr�senter sous l'une des quatre formes suivantes :

1. Un champ d'en-t�te de requ�te HTTP (voir la RFC2616 pour plus d'information � leur propos) ; par exemple : Host, User-Agent, Referer, ou Accept-Language. Il est possible d'utiliser une expression rationnelle pour sp�cifier un jeu d'en-t�tes de requ�te.
2. Une des caract�ristiques de la requ�te suivantes :
   • Remote_Host - le nom d'h�te (s'il est disponible) du client qui effectue la requ�te
   • Remote_Addr - l'adresse IP du client qui effectue la requ�te
   • Server_Addr - l'adresse IP du serveur qui a re�u la requ�te (uniquement � partir des versions sup�rieures � 2.0.43)
   • Request_Method - Le nom de la m�thode HTTP utilis�e (GET, POST, et cetera...)
   • Request_Protocol - le nom et la version du protocole utilis� pour la requ�te (par exemple "HTTP/0.9", "HTTP/1.1", etc...)
   • Request_URI - la ressource demand�e dans la ligne de requ�te HTTP -- en g�n�ral la partie de l'URL suivant le protocole et le nom du serveur, sans la cha�ne d'arguments. Voir la directive RewriteCond du module mod_rewrite pour plus d'informations sur la mani�re de mettre en correspondance votre cha�ne d'arguments.
3. Le nom d'une variable d'environnement parmi la liste de celles qui sont associ�es � la requ�te. Ceci permet � la directive SetEnvIf d'effectuer des tests en fonction du r�sultat de comparaisons pr�c�dentes. Seules les variables d'environnement d�finies par des directives SetEnvIf[NoCase] pr�c�dentes sont disponibles pour effectuer des tests de cette mani�re. 'Pr�c�dentes' signifie qu'elles se trouvent � un niveau plus global de la configuration (par exemple au niveau du serveur principal), ou plus haut chronologiquement dans le contexte de la directive. Les variables d'environnement ne seront prises en compte que si aucune correspondance n'a �t� trouv�e parmi les caract�ristiques de la requ�te, et si attribut n'a pas �t� sp�cifi� sous la forme d'une expression rationnelle.

Le second argument (regex) est une expression rationnelle. Si regex correspond � l'attribut, les arguments suivants sont �valu�s.

Le reste des arguments constitue les noms des variables � d�finir, ainsi que les valeurs optionnelles qui doivent leur �tre affect�es. Ils peuvent se pr�senter sous les formes suivantes :

1. nom-variable, or
2. !nom-variable, or
3. nom-variable=valeur

Dans la premi�re forme, la valeur sera d�finie � "1". Dans la seconde forme, la variable sera supprim�e si elle a �t� d�finie au pr�alable, et dans la troisi�me forme, la variable sera d�finie � la valeur litt�rale sp�cifi�e par valeur. Depuis la version 2.0.51, Apache httpd reconna�t les occurrences de variables $1..$9 � l'int�rieur de valeur, et les remplace par les sous-expressions entre parenth�ses correspondantes de 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\.example\.com intra_site_referral
    
SetEnvIf object_is_image xbm XBIT_PROCESSING=1
    
SetEnvIf ^TS  ^[a-z]  HAVE_TS

Les trois premi�res lignes d�finissent la variable d'environnement objet_est_une_image si l'objet de la requ�te est un fichier image, et la quatri�me d�finit la variable r�f�rant_intra_site si la page r�f�rante se trouve quelque part dans le site web www.mon-domaine.example.com.

La derni�re ligne d�finit la variable d'environnement HAVE_TS si la requ�te contient un en-t�te dont le nom commence par "TS" et dont la valeur commence par tout caract�re du jeu [a-z].

Voir aussi

• Les variables d'environnement et le serveur HTTP Apache pour des exemples suppl�mentaires.

SetEnvIfExpr Directive

La directive SetEnvIfExpr permet de d�finir des variables d'environnement en fonction d'une expression <If> ap_expr. Cette expression est �valu�e � l'ex�cution, et utilise les variables d'environnement env-variable de la m�me mani�re que la directive SetEnvIf.

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

Dans cet exemple, la variable d'environnement iso_delivered est d�finie chaque fois que notre application tente de l'envoyer via X-Sendfile.

Il pourrait �tre plus utile de d�finir une variable rfc1918 si l'adresse IP distante est une adresse priv�e au sens de la RFC 1918 :

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

Voir aussi

• Les expressions dans le serveur HTTP Apache, pour une r�f�rence compl�te et davantage d'exemples.
• La directive <If> permet d'obtenir des r�sultats similaires.
• mod_filter

SetEnvIfNoCase Directive

La directive SetEnvIfNoCase est identique d'un point de vue s�mantique � la directive SetEnvIf, et ne s'en distingue que par le fait que la comparaison des expressions rationnelles est effectu�e sans tenir compte de la casse. Par exemple :

SetEnvIfNoCase Host Example\.Org site=apache

Cette ligne va d�finir la variable d'environnement site avec la valeur "example" si le champ d'en-t�te de requ�te HTTP Host: est pr�sent et contient Example.Org, example.org, ou une autre combinaison des m�mes caract�res, sans tenir compte de la casse.