granicus.if.org Git - apache/blob - docs/manual/mod/mod_env.xml.fr

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision : 1673947 -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- Reviewed by : Vincent Deffontaines -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <modulesynopsis metafile="mod_env.xml.meta">
  26
  27 <name>mod_env</name>
  28 <description>Modifie l'environnement transmis aux scripts CGI et aux
  29 pages SSI</description>
  30 <status>Base</status>
  31 <sourcefile>mod_env.c</sourcefile>
  32 <identifier>env_module</identifier>
  33 <summary>
  34     <p>Ce module permet de contr&ocirc;ler les variables d'environnement
  35     internes utilis&eacute;es par divers modules du serveur HTTP Apache. Ces
  36     variables sont aussi accessibles aux scripts CGI en tant que
  37     variables d'environnement syst&egrave;me natives, et disponibles dans les
  38     pages SSI. Les variables d'environnement peuvent
  39     &ecirc;tre transmises depuis le shell qui a lanc&eacute; le processus
  40     <program>httpd</program>. Elles peuvent &eacute;galement &ecirc;tre d&eacute;finies ou
  41     supprim&eacute;es au cours du processus de configuration.</p>
  42 </summary>
  43 <seealso><a href="../env.html">Variables d'environnement</a></seealso>
  44 <seealso><directive module="mod_setenvif">SetEnvIf</directive></seealso>
  45
  46 <directivesynopsis>
  47 <name>PassEnv</name>
  48 <description>Transmet des variables d'environnement depuis le
  49 shell</description>
  50 <syntax>PassEnv <var>var-env</var> [<var>var-env</var>]
  51 ...</syntax>
  52 <contextlist><context>server config</context><context>virtual host</context>
  53 <context>directory</context><context>.htaccess</context></contextlist>
  54 <override>FileInfo</override>
  55
  56 <usage>
  57     <p>Cette directive permet de sp&eacute;cifier quelles variables
  58     d'environnement syst&egrave;me natives doivent &ecirc;tre disponibles en tant que
  59     variables d'environnement internes pour les modules du serveur HTTP
  60     Apache, et propag&eacute;es vers les scripts CGI et les pages SSI. Leurs
  61     valeurs sont issues de l'environnement natif de l'OS associ&eacute; au
  62     shell qui a invoqu&eacute; le processus <program>httpd</program>.</p>
  63
  64     <example><title>Exemple</title>
  65     <highlight language="config">
  66       PassEnv LD_LIBRARY_PATH
  67       </highlight>
  68     </example>
  69 </usage>
  70 </directivesynopsis>
  71
  72 <directivesynopsis>
  73 <name>SetEnv</name>
  74 <description>D&eacute;finit des variables d'environnement</description>
  75 <syntax>SetEnv <var>var-env</var> [<var>valeur</var>]</syntax>
  76 <contextlist><context>server config</context><context>virtual host</context>
  77 <context>directory</context><context>.htaccess</context></contextlist>
  78 <override>FileInfo</override>
  79
  80 <usage>
  81     <p>D&eacute;finit une variable d'environnement interne, cette derni&egrave;re &eacute;tant
  82     ensuite disponible pour les modules du serveur HTTP Apache et
  83     transmise aux scripts CGI et aux pages SSI.</p>
  84
  85     <example><title>Exemple</title>
  86     <highlight language="config">
  87       SetEnv SPECIAL_PATH /foo/bin
  88       </highlight>
  89     </example>
  90
  91     <p>Si l'argument <var>valeur</var> est absent, la variable est
  92     d&eacute;finie &agrave; la valeur d'une cha&icirc;ne vide.</p>
  93
  94     <note><p>Les variables d'environnement internes d&eacute;finies par cette
  95     directive le sont <em>apr&egrave;s</em> l'ex&eacute;cution de la plupart des
  96     directives du traitement initial des requ&ecirc;tes, comme les contr&ocirc;les
  97     d'acc&egrave;s et la mise en correspondance des URIs avec les noms de
  98     fichiers. Si la variable d'environnement est sens&eacute;e intervenir au
  99     cours de cette phase initiale du traitement, par exemple pour la
 100     directive <directive module="mod_rewrite">RewriteRule</directive>,
 101     vous devez plut&ocirc;t utiliser la directive <directive
 102     module="mod_setenvif">SetEnvIf</directive> pour d&eacute;finir cette
 103     variable.</p>
 104     </note>
 105
 106 </usage>
 107 <seealso><a href="../env.html">Variables d'environnement</a></seealso>
 108 </directivesynopsis>
 109
 110 <directivesynopsis>
 111 <name>UnsetEnv</name>
 112 <description>Supprime des variables de l'environnement</description>
 113 <syntax>UnsetEnv <var>var-env</var> [<var>var-env</var>]
 114 ...</syntax>
 115 <contextlist><context>server config</context><context>virtual host</context>
 116 <context>directory</context><context>.htaccess</context></contextlist>
 117 <override>FileInfo</override>
 118
 119 <usage>
 120     <p>Supprime une ou plusieurs variables d'environnement internes parmi celles
 121     qui sont transmises aux scripts CGI et aux pages SSI.</p>
 122
 123     <example><title>Exemple</title>
 124     <highlight language="config">
 125       UnsetEnv LD_LIBRARY_PATH
 126       </highlight>
 127     </example>
 128 </usage>
 129 </directivesynopsis>
 130
 131 </modulesynopsis>
 132