Serveur Apache HTTP Version 2.4

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
`

### Directives

### Voir aussi

- Les variables d'environnement et le serveur HTTP Apache

## 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 est_un_robot
SetEnvIfNoCase User-Agent Robot est_un_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

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 est_un_robot
SetEnvIfNoCase User-Agent Robot est_un_robot
`

## 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.

### Example:

`SetEnvIf Request_URI "\.gif$" objet_est_une_image=gif
SetEnvIf Request_URI "\.jpg$" objet_est_une_image=jpg
SetEnvIf Request_URI "\.xbm$" objet_est_une_image=xbm
:
SetEnvIf Referer www\.mon-domaine\.example\.com référant_intra_site
:
SetEnvIf objet_est_une_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

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

- Les expressions dans le serveur HTTP Apache, pour une référence complète et davantage d'exemples.
- La directive `<If>` peut être utilisée pour obtenir des résultats similaires.
- `mod_filter`

## 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