<-
Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_setenvif

Langues Disponibles:  en  |  fr  |  ja  |  ko  |  tr 

Description:Permet de d�finir des variables d'environnement en fonction de caract�ristiques de la requ�te
Statut:Base
Identificateur�de�Module:setenvif_module
Fichier�Source:mod_setenvif.c

Sommaire

Le module mod_setenvif vous permet de d�finir des variables d'environnement internes en fonction du fait que telle ou telle caract�ristique de la requ�te correspond ou non aux expressions rationnelles que vous sp�cifiez. Ces variables d'environnement peuvent �tre utilis�es par d'autres parties du serveur pour prendre des d�cisions quant aux actions � entreprendre, et pour d�terminer si les scripts CGI et les pages SSI doivent pouvoir y acc�der.

Les directives sont interpr�t�es selon l'ordre dans lequel elles appara�ssent dans les fichiers de configuration. Ainsi, des s�quences plus complexes peuvent �tre utilis�es, comme dans cet exemple qui d�finit netscape si le navigateur est Mozilla et non MSIE.

BrowserMatch ^Mozilla netscape
BrowserMatch MSIE !netscape

Lorsque le serveur cherche un chemin via une sous-requ�te interne (par exemple la recherche d'un DirectoryIndex), ou lorsqu'il g�n�re un listing du contenu d'un r�pertoire via le module mod_autoindex, la sous-requ�te n'h�rite pas des variables d'environnement sp�cifiques � la requ�te. En outre, � cause des phases de l'API auxquelles mod_setenvif prend part, les directives SetEnvIf ne sont pas �valu�es s�par�ment dans la sous-requ�te.

Directives

Voir aussi

top

BrowserMatch Directive

Description:D�finit des variables d'environnement en fonction du contenu de l'en-t�te HTTP User-Agent
Syntaxe:BrowserMatch regex [!]env-variable[=valeur] [[!]env-variable[=valeur]] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_setenvif

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
top

BrowserMatchNoCase Directive

Description:D�finit des variables d'environnement en fonction du contenu de l'en-t�te HTTP User-Agent sans tenir compte de la casse
Syntaxe:BrowserMatchNoCase regex [!]env-variable[=valeur] [[!]env-variable[=valeur]] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_setenvif

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
top

SetEnvIf Directive

Description:D�finit des variables d'environnement en fonction des attributs de la requ�te
Syntaxe:SetEnvIf attribut regex [!]env-variable[=valeur] [[!]env-variable[=valeur]] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_setenvif

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

top

SetEnvIfExpr Directive

Description:D�finit des variables d'environnement en fonction d'une expression ap_expr
Syntaxe:SetEnvIfExpr expr [!]env-variable[=valeur] [[!]env-variable[=valeur]] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_setenvif

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

top

SetEnvIfNoCase Directive

Description:D�finit des variables d'environnement en fonction des attributs de la requ�te sans tenir compte de la casse
Syntaxe:SetEnvIfNoCase attribut regex [!]env-variable[=valeur] [[!]env-variable[=valeur]] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_setenvif

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.

Langues Disponibles:  en  |  fr  |  ja  |  ko  |  tr 

top

Commentaires

Notice:
This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.