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

Module Apache mod_env

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

Description:Modifie l'environnement transmis aux scripts CGI et aux pages SSI
Statut:Base
Identificateur de Module:env_module
Fichier Source:mod_env.c

Sommaire

Ce module permet de contrôler les variables d'environnement internes utilisées par divers modules du serveur HTTP Apache. Ces variables sont aussi accessibles aux scripts CGI en tant que variables d'environnement système natives, et disponibles dans les pages SSI. Les variables d'environnement peuvent être transmises depuis le shell qui a lancé le processus httpd. Elles peuvent également être définies ou supprimées au cours du processus de configuration.

Directives

Traitement des bugs

Voir aussi

top

Directive PassEnv

Description:Transmet des variables d'environnement depuis le shell
Syntaxe:PassEnv var-env [var-env] ...
Contexte:configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_env

Cette directive permet de spécifier quelles variables d'environnement système natives doivent être disponibles en tant que variables d'environnement internes pour les modules du serveur HTTP Apache, et propagées vers les scripts CGI et les pages SSI. Leurs valeurs sont issues de l'environnement natif de l'OS associé au shell qui a invoqué le processus httpd.

Exemple

PassEnv LD_LIBRARY_PATH
top

Directive SetEnv

Description:Définit des variables d'environnement
Syntaxe:SetEnv var-env [valeur]
Contexte:configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_env

Définit une variable d'environnement interne, cette dernière étant ensuite disponible pour les modules du serveur HTTP Apache et transmise aux scripts CGI et aux pages SSI.

Exemple

SetEnv SPECIAL_PATH /foo/bin

Si l'argument valeur est absent, la variable est définie à la valeur d'une chaîne vide.

Les variables d'environnement internes définies par cette directive le sont après l'exécution de la plupart des directives du traitement initial des requêtes, comme les contrôles d'accès et la mise en correspondance des URIs avec les noms de fichiers. Si la variable d'environnement est sensée intervenir au cours de cette phase initiale du traitement, par exemple pour la directive RewriteRule, vous devez plutôt utiliser la directive SetEnvIf pour définir cette variable.

Voir aussi

top

Directive SetEnvFromFile

Description:Définitions de variables d’environnement à partir d’un fichier
Syntaxe:SetEnvFromFile file-path
Contexte:configuration globale, serveur virtuel, répertoire
Statut:Base
Module:mod_env
Compatibilité:Disponible à partir de la version 2.5.1 du serveur HTTP Apache.

Cette directive permet de définir des variables d’environnement internes à partir d’un fichier ; ces dernières sont alors disponibles pour les modules du serveur HTTP Apache et passées aux scripts CGI et aux pages SSI. Mis à part le fait que les valeurs des variables sont enregistrées dans un fichier séparé, cette directive a le même effet qu’une liste de directives SetEnv directives, chacune d’entre elles définissant une variable.

file-path est soit un chemin absolu, soit un chemin relatif à la valeur de la directive ServerRoot. Le fichier est lu une seule fois lors de l’analyse de la configuration ; ses éventuelles modifications ne seront prises en compte qu’après un redémarrage du serveur.

Chaque ligne du fichier se présente sous la forme nom=valeur. Les lignes vides ou commençant par # sont ignorées, et les blancs en début et en fin de ligne sont supprimés. Si une ligne ne contient pas de signe =, la variable correspondante se voit affecter une chaîne vide. Une ligne se terminant par une controblique (\) continue à la ligne suivante, comme dans les fichiers de configuration principaux.

Exemple

SetEnvFromFile conf/app.env

Exemple de fichier (conf/app.env)

      # Application settings
      APP_MODE=production
      SPECIAL_PATH=/foo/bin

Comme pour la directive SetEnv, les variables sont définies après que la plupart des directives précoces de traitement des requêtes ont été exécutées, comme le contrôle d’accès et le mappage URI-Nom de fichier.

Sécurité

À la différence de SetEnv, cette directive lit le contenu d’un fichier vers l’environnement interne, où il peut être exposé par CGI, SSI, journalisation et autres consommateurs. Afin d’empêcher un utilisateur non fiable de divulguer le contenu de tout fichier lisible par le serveur (par exemple les fichiers de configuration ou de données d’authentification ailleurs sur l’hôte), la directive SetEnvFromFile n’est pas autorisée dans les fichiers .htaccess ; elle ne peut être utilisée que dans la configuration globale du serveur.

Voir aussi

top

Directive UnsetEnv

Description:Supprime des variables de l'environnement
Syntaxe:UnsetEnv var-env [var-env] ...
Contexte:configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_env

Supprime une ou plusieurs variables d'environnement internes parmi celles qui sont transmises aux scripts CGI et aux pages SSI.

Exemple

UnsetEnv LD_LIBRARY_PATH

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