docs/manual/env.html.fr

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>Apache et les variables d'environnement - Serveur Apache HTTP</title>
   9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
  13 <body id="manual-page"><div id="page-header">
  14 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
  15 <p class="apache">Serveur Apache HTTP Version 2.3</p>
  16 <img alt="" src="./images/feather.gif" /></div>
  17 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
  18 <div id="path">
  19 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Apache et les variables d'environnement</h1>
  20 <div class="toplang">
  21 <p><span>Langues Disponibles: </span><a href="./en/env.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  22 <a href="./fr/env.html" title="Français">&nbsp;fr&nbsp;</a> |
  23 <a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  24 <a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  25 <a href="./tr/env.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  26 </div>
  27
  28     <p>Le serveur HTTP Apache propose un mécanisme de stockage d'informations
  29     dans des variables appelées <em>variables d'environnement</em>. Ces
  30     informations peuvent servir à contrôler diverses opérations comme
  31     l'enregistrement des traces ou le contrôle d'accès. On utilise aussi ces
  32     variables dans le mécanisme de communication avec les programmes externes
  33     comme les scripts CGI. Ce document présente différentes méthodes pour
  34     manipuler et utiliser ces variables.</p>
  35
  36     <p>Bien que ces variables soient référencées comme <em>variables
  37     d'environnement</em>, il ne faut pas les confondre avec les variables
  38     d'environnement contrôlées par le système d'exploitation sous-jacent.
  39     En fait, ces variables sont stockées et manipulées dans une structure
  40     interne à Apache. Elles ne deviennent de véritables variables
  41     d'environnement du système d'exploitation que lorsqu'elles sont mises à la
  42     disposition de scripts CGI et de scripts inclus côté serveur (SSI). Si vous
  43     souhaitez manipuler l'environnement du système d'exploitation sous lequel
  44     le serveur s'exécute, vous devez utiliser les mécanismes standards de
  45     manipulation de l'environnement fournis par l'interpréteur de commandes
  46     (shell) de votre système d'exploitation.</p>
  47   </div>
  48 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#setting">Définition des variables d'environnement</a></li>
  49 <li><img alt="" src="./images/down.gif" /> <a href="#using">Utilisation des variables d'environnement</a></li>
  50 <li><img alt="" src="./images/down.gif" /> <a href="#special">Variables d'environnement à usage spécial</a></li>
  51 <li><img alt="" src="./images/down.gif" /> <a href="#examples">Exemples</a></li>
  52 </ul></div>
  53 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  54 <div class="section">
  55 <h2><a name="setting" id="setting">Définition des variables d'environnement</a></h2>
  56
  57     <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_env.html">mod_env</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li><li><code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#unsetenv">UnsetEnv</a></code></li></ul></td></tr></table>
  58
  59     <h3><a name="basic-manipulation" id="basic-manipulation">Manipulations de base de l'environnement</a></h3>
  60
  61
  62         <p>La méthode la plus élémentaire pour définir une variable
  63         d'environnement au niveau d'Apache consiste à utiliser la directive
  64         inconditionnelle <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code>. Les variables peuvent aussi être transmises depuis
  65         l'environnement du shell à partir duquel le serveur a été démarré en
  66         utilisant la directive
  67         <code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code>.</p>
  68
  69
  70     <h3><a name="conditional" id="conditional">Définitions conditionnelles en fonction des requêtes</a></h3>
  71
  72
  73         <p>Pour plus de souplesse, les directives fournies par le module
  74         <code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code> permettent de définir les
  75         variables d'environnement en tenant compte des caractéristiques
  76         de chaque requête. Par exemple, une
  77         variable pourrait n'être définie que lorsqu'un navigateur spécifique
  78         (User-Agent) a généré la requête, ou seulement quand un en-tête
  79         Referer particulier est présent. La directive
  80         <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> du module
  81         <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> qui utilise l'option
  82         <code>[E=...]</code> pour définir
  83         les variables d'environnement apporte encore plus de souplesse.</p>
  84
  85
  86     <h3><a name="unique-identifiers" id="unique-identifiers">Identifiants uniques</a></h3>
  87
  88
  89         <p>Finalement, le module <code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code> définit la variable
  90         d'environnement <code>UNIQUE_ID</code> pour chaque requête à une valeur
  91         qui est garantie unique parmi "toutes" les requêtes sous des
  92         conditions très spécifiques.</p>
  93
  94
  95     <h3><a name="standard-cgi" id="standard-cgi">Variables CGI standards</a></h3>
  96
  97
  98         <p>En plus de l'ensemble des variables d'environnement internes à la
  99         configuration d'Apache et de celles transmises depuis le shell,
 100         les scripts CGI et les pages SSI
 101         se voient affectés un ensemble de variables
 102         d'environnement contenant des méta-informations à propos de la requête
 103         comme préconisé dans la
 104         <a href="http://cgi-spec.golux.com/">spécification
 105         sur les CGIs</a>.</p>
 106
 107
 108     <h3><a name="caveats" id="caveats">Quelques mises en garde</a></h3>
 109
 110
 111         <ul>
 112           <li>Les directives de manipulation de l'environnement ne permettent
 113           pas de supplanter ou modifier les variables CGI standards.</li>
 114
 115           <li>Lorsqu'on utilise <code class="program"><a href="./programs/suexec.html">suexec</a></code> pour exécuter des
 116           scripts CGI, l'environnement est nettoyé et réduit à un ensemble de
 117           variables <em>sûres</em> avant l'exécution du script. La liste des
 118           variables <em>sûres</em> est définie à la compilation dans
 119           <code>suexec.c</code>.</li>
 120
 121           <li>Pour des raisons de portabilité, les noms des variables
 122           d'environnement ne peuvent contenir que des lettres, des chiffres, et
 123           le caractère "sousligné". En outre, le premier caractère ne doit pas
 124           être un chiffre. Les caractères qui ne satisfont pas à ces conditions
 125           seront remplacés par un caractère "sousligné" quand ils seront
 126           transmis aux scripts CGI et aux pages SSI.</li>
 127
 128           <li>La directive <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> s'exécute assez tard au
 129           cours du traitement de la requête, ce qui signifie que des
 130           directives telles que <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> et <code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> ne verront pas
 131           les variables qu'elle aura définies.</li>
 132         </ul>
 133
 134   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 135 <div class="section">
 136 <h2><a name="using" id="using">Utilisation des variables d'environnement</a></h2>
 137
 138
 139     <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authz_host.html#allow">Allow</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_authz_host.html#deny">Deny</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li></ul></td></tr></table>
 140
 141     <h3><a name="cgi-scripts" id="cgi-scripts">Scripts CGI</a></h3>
 142
 143
 144         <p>La communication d'informations aux scripts CGI constitue une des
 145         principales utilisations des variables d'environnement. Comme indiqué
 146         plus haut, l'environnement transmis aux scripts CGI comprend des
 147         méta-informations standards à propos de la requête, en plus des
 148         variables définies dans la configuration d'Apache. Pour plus de
 149         détails, se référer au
 150         <a href="howto/cgi.html">tutoriel CGI</a>.</p>
 151
 152
 153     <h3><a name="ssi-pages" id="ssi-pages">Pages SSI</a></h3>
 154
 155
 156         <p>Les documents inclus côté serveur (SSI) traités par le filtre
 157         <code>INCLUDES</code> du module <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>,
 158         peuvent afficher les
 159         variables d'environnement à l'aide de l'élément <code>echo</code>,
 160         et peuvent utiliser des variables d'environnement dans les éléments
 161         de contrôle de flux pour rendre certaines parties d'une page
 162         conditionnelles en fonction des caractéristiques de la requête.
 163         Apache fournit aussi les variables d'environnement CGI standards
 164         aux pages SSI
 165         comme indiqué plus haut. Pour plus de détails, se référer au
 166         <a href="howto/ssi.html">tutoriel SSI</a>.</p>
 167
 168
 169     <h3><a name="access-control" id="access-control">Contrôle d'accès</a></h3>
 170
 171
 172         <p>L'accès au serveur peut être contrôlé en fonction de la valeur de
 173         variables d'environnement à l'aide des directives
 174         <code>allow from env=</code> et <code>deny from env=</code>.
 175         En association avec la directive
 176         <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, ceci confère une
 177         grande souplesse au contrôle d'accès au serveur en fonction des
 178         caractéristiques du client. Par exemple, vous pouvez utiliser ces
 179         directives pour interdire l'accès depuis un navigateur particulier
 180         (User-Agent).
 181         </p>
 182
 183
 184     <h3><a name="logging" id="logging">Enregistrement conditionnel des traces</a></h3>
 185
 186
 187         <p>Les variables d'environnement peuvent être enregistrées dans le
 188         fichier de log des accès à l'aide de l'option <code>%e</code> de la
 189         directive <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>.
 190         En outre, la décision de tracer ou non les requêtes peut être prise
 191         en fonction de l'état de variables d'environnement en utilisant la
 192         forme conditionnelle de la directive
 193         <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>. En
 194         association avec la directive <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, ceci confère une grande souplesse au contrôle
 195         du traçage des requêtes. Par exemple, vous pouvez choisir de ne pas
 196         tracer les requêtes pour des noms de fichiers se terminant par
 197         <code>gif</code>, ou encore de ne tracer que les requêtes des clients
 198         n'appartenant pas à votre sous-réseau.</p>
 199
 200
 201     <h3><a name="response-headers" id="response-headers">En-têtes de réponse conditionnels</a></h3>
 202
 203
 204         <p>La directive <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code>
 205         peut se baser sur la présence ou l'absence d'une variable
 206         d'environnement pour décider si un certain en-tête HTTP sera placé
 207         dans la réponse au client. Ceci permet, par exemple, de n'envoyer un
 208         certain en-tête de réponse que si un en-tête correspondant est présent
 209         dans la requête du client.</p>
 210
 211
 212
 213     <h3><a name="external-filter" id="external-filter">Activation de filtres externes</a></h3>
 214
 215
 216         <p>Les filtres externes configurés par le module
 217         <code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> à l'aide de la directive <code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code> peuvent être
 218         activés de manière conditionnelle en fonction d'une variable
 219         d'environnement à l'aide des options
 220         <code>disableenv=</code> et <code>enableenv=</code>.</p>
 221
 222
 223     <h3><a name="url-rewriting" id="url-rewriting">Réécriture d'URL</a></h3>
 224
 225
 226         <p>La forme <code>%{ENV:<em>variable</em>}</code> de
 227         <em>TestString</em> dans la
 228         directive <code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
 229         permet au moteur de réécriture du module
 230         <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> de prendre des
 231         décisions conditionnées par des variables d'environnement.
 232         Notez que les variables accessibles dans
 233         <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> sans le préfixe
 234         <code>ENV:</code> ne sont pas de véritables variables
 235         d'environnement. Ce sont plutôt des variables spécifiques à
 236         <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
 237         qui ne sont pas accessibles pour les autres modules.</p>
 238
 239   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 240 <div class="section">
 241 <h2><a name="special" id="special">Variables d'environnement à usage spécial</a></h2>
 242
 243
 244         <p>Des problèmes d'interopérabilité ont conduit à l'introduction de
 245         mécanismes permettant de modifier le comportement d'Apache lorsqu'il
 246         dialogue avec certains clients. Afin de rendre ces mécanismes aussi
 247         souples que possible, ils sont invoqués en définissant des variables
 248         d'environnement, en général à l'aide de la directive
 249         <code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, bien que les
 250         directives <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> et
 251         <code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> puissent aussi être
 252         utilisées, par exemple.</p>
 253
 254     <h3><a name="downgrade" id="downgrade">downgrade-1.0</a></h3>
 255
 256
 257         <p>Ceci force le traitement d'une requête comme une requête HTTP/1.0
 258         même si elle a été rédigée dans un langage plus récent.</p>
 259
 260
 261     <h3><a name="force-gzip" id="force-gzip">force-gzip</a></h3>
 262
 263           <p>Si le filtre <code>DEFLATE</code> est activé, cette variable
 264           d'environnement ignorera les réglages accept-encoding de votre
 265           navigateur et enverra une sortie compressée inconditionnellement.</p>
 266
 267     <h3><a name="force-no-vary" id="force-no-vary">force-no-vary</a></h3>
 268
 269
 270         <p>Cette variable entraîne la suppression de tout champ
 271         <code>Vary</code> des en-têtes de la réponse avant que cette dernière
 272         soit renvoyée au client. Certains clients n'interprètent pas ce champ
 273         correctement, et la définition de cette variable permet de contourner
 274         ce problème, mais implique aussi la définition de
 275         <strong>force-response-1.0</strong>.</p>
 276
 277
 278     <h3><a name="force-response" id="force-response">force-response-1.0</a></h3>
 279
 280
 281       <p>Cette variable force une réponse en langage HTTP/1.0 aux clients
 282       qui envoient des requêtes dans le même langage. Elle fut implémentée à
 283       l'origine suite à des problèmes avec les mandataires d'AOL. Certains
 284       clients en langage HTTP/1.0 ne réagissent pas correctement face à une
 285       réponse en langage HTTP/1.1, et cette variable peut être utilisée pour
 286       assurer l'interopérabilité avec eux.</p>
 287
 288
 289
 290     <h3><a name="gzip-only-text-html" id="gzip-only-text-html">gzip-only-text/html</a></h3>
 291
 292
 293         <p>Positionnée à "1", cette variable désactive le filtre en sortie
 294         <code>DEFLATE</code> fourni par le module <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> pour les
 295         types de contenu autres que <code>text/html</code>. Si vous préférez
 296         utiliser des fichiers compressés statiquement,
 297         <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> évalue aussi la variable (non
 298         seulement pour gzip, mais aussi pour tous les encodages autres que
 299         "identity").</p>
 300
 301
 302     <h3><a name="no-gzip" id="no-gzip">no-gzip</a></h3>
 303
 304         <p>Quand cette variable est définie, le filtre <code>DEFLATE</code> du
 305         module <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> est désactivé, et
 306         <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> refusera de délivrer des ressources
 307         encodées.</p>
 308
 309
 310
 311     <h3><a name="no-cache" id="no-cache">no-cache</a></h3>
 312
 313         <p>Lorsque cette variable est définie,
 314         <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> ne sauvegardera pas de réponse
 315         susceptible d'être mise en cache. Cette variable d'environnement
 316         n'a aucune incidence sur le fait qu'une réponse déjà enregistrée
 317         dans la cache soit utilisée ou non pour la requête courante.</p>
 318
 319
 320
 321     <h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3>
 322
 323
 324         <p>Quand cette variable est définie, la directive
 325         <code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code> est désactivée.</p>
 326
 327
 328
 329     <h3><a name="prefer-language" id="prefer-language">prefer-language</a></h3>
 330
 331         <p>Cette variable modifie le comportement du module
 332         <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>. Si elle contient un symbole de
 333         langage (tel que <code>en</code>, <code>ja</code>
 334         ou <code>x-klingon</code>), <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> essaie de
 335         délivrer une variante dans ce langage. S'il n'existe pas de telle
 336         variante, le processus normal de
 337         <a href="content-negotiation.html">négociation</a> s'applique.</p>
 338
 339
 340
 341     <h3><a name="redirect-carefully" id="redirect-carefully">redirect-carefully</a></h3>
 342
 343
 344         <p>Cette variable force le serveur à être plus prudent lors de l'envoi
 345         d'une redirection au client. Elle est en général utilisée quand un
 346         client présente un problème connu avec les redirections. Elle fut
 347         implémentée à l'origine suite a un problème rencontré avec le logiciel
 348         WebFolders de Microsoft qui ne gère pas correctement les redirections
 349         vers des ressources de type répertoire via des méthodes DAV.</p>
 350
 351
 352
 353    <h3><a name="suppress-error-charset" id="suppress-error-charset">suppress-error-charset</a></h3>
 354
 355
 356     <p><em>Disponible dans les versions postérieures à 2.0.54</em></p>
 357
 358     <p>Quand Apache génère une redirection en réponse à une requête client,
 359     la réponse inclut un texte destiné à être affiché au cas où le client ne
 360     suivrait pas, ou ne pourrait pas suivre automatiquement la redirection.
 361     Habituellement, Apache marque ce texte en accord avec le jeu de caractères
 362     qu'il utilise, à savoir ISO-8859-1.</p>
 363     <p> Cependant, si la redirection fait référence à une page qui utilise un
 364     jeu de caractères différent, certaines versions de navigateurs obsolètes
 365     essaieront d'utiliser le jeu de caractères du texte de la redirection
 366     plutôt que celui de la page réelle.
 367     Ceci peut entraîner, par exemple, un rendu incorrect du Grec.</p>
 368     <p>Si cette variable d'environnement est définie, Apache omettra le jeu de
 369     caractères pour le texte de la redirection, et les navigateurs obsolètes
 370     précités utiliseront correctement celui de la page de destination.</p>
 371
 372     <div class="warning">
 373       <h3>Note concernant la sécurité</h3>
 374
 375       <p>L'envoi de pages d'erreur sans spécifier un jeu de caractères peut
 376       conduire à des attaques de type "cross-site-scripting" pour les
 377       navigateurs qui ne respectent pas la spécification HTTP/1.1 (MSIE) et
 378       tentent de déduire le jeu de caractères à partir du contenu. De tels
 379       navigateurs peuvent être facilement trompés et utiliser le jeu de
 380       caractères UTF-7 ; les contenus des données en entrée de type UTF-7
 381       (comme les URI de requête) ne seront alors plus protégés par les
 382       mécanismes d'échappement usuels conçus pour prévenir les attaques
 383       de type "cross-site-scripting".</p>
 384     </div>
 385
 386
 387
 388    <h3><a name="proxy" id="proxy">force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked,
 389    proxy-sendcl, proxy-chain-auth, proxy-interim-response, proxy-initial-not-pooled</a></h3>
 390
 391    <p>Ces directives modifient le comportement protocolaire du module
 392    <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>.  Voir la documentation sur
 393    <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> et <code class="module"><a href="./mod/mod_proxy_http.html">mod_proxy_http</a></code> pour plus de détails.</p>
 394
 395
 396   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 397 <div class="section">
 398 <h2><a name="examples" id="examples">Exemples</a></h2>
 399
 400
 401     <h3><a name="misbehaving" id="misbehaving">Modification du comportement protocolaire face à des clients
 402         réagissant de manière non conforme</a></h3>
 403
 404
 405         <p>Les versions antérieures recommandaient l'ajout de ces lignes dans
 406         httpd.conf pour tenir compte de problèmes connus avec certains clients.
 407         Comme les clients concernés sont maintenant très peu utilisés, cet
 408         ajout n'est pratiquement plus nécessaire.</p>
 409 <div class="example"><pre>
 410 #
 411 # The following directives modify normal HTTP response behavior.
 412 # The first directive disables keepalive for Netscape 2.x and browsers that
 413 # spoof it. There are known problems with these browser implementations.
 414 # The second directive is for Microsoft Internet Explorer 4.0b2
 415 # which has a broken HTTP/1.1 implementation and does not properly
 416 # support keepalive when it is used on 301 or 302 (redirect) responses.
 417 #
 418 BrowserMatch "Mozilla/2" nokeepalive
 419 BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
 420
 421 #
 422 # The following directive disables HTTP/1.1 responses to browsers which
 423 # are in violation of the HTTP/1.0 spec by not being able to grok a
 424 # basic 1.1 response.
 425 #
 426 BrowserMatch "RealPlayer 4\.0" force-response-1.0
 427 BrowserMatch "Java/1\.0" force-response-1.0
 428 BrowserMatch "JDK/1\.0" force-response-1.0</pre></div>
 429
 430
 431     <h3><a name="no-img-log" id="no-img-log">Ne pas tracer les requêtes pour des images dans le fichier de
 432         trace des accès</a></h3>
 433
 434
 435         <p>Dans cet exemple, les requêtes pour des images n'apparaissent pas
 436         dans le fichier de trace des accès. Il peut être facilement adapté pour
 437         empêcher le traçage de répertoires particuliers, ou de requêtes
 438         en provenance de certains hôtes.</p>
 439          <div class="example"><p><code>
 440            SetEnvIf Request_URI \.gif image-request<br />
 441            SetEnvIf Request_URI \.jpg image-request<br />
 442            SetEnvIf Request_URI \.png image-request<br />
 443            CustomLog logs/access_log common env=!image-request
 444          </code></p></div>
 445
 446
 447     <h3><a name="image-theft" id="image-theft">Prévention du "Vol d'image"</a></h3>
 448
 449
 450         <p>Cet exemple montre comment empêcher les utilisateurs ne faisant pas
 451         partie de votre serveur d'utiliser des images de votre serveur comme
 452         images en ligne dans leurs pages. Cette configuration n'est pas
 453         recommandée, mais elle peut fonctionner dans des circonstances bien
 454         définies. Nous supposons que toutes vos images sont enregistrées dans
 455         un répertoire nommé <code>/web/images</code>.</p>
 456     <div class="example"><p><code>
 457           SetEnvIf Referer "^http://www\.example\.com/" local_referal
 458           # Allow browsers that do not send Referer info
 459           SetEnvIf Referer "^$" local_referal
 460           &lt;Directory /web/images&gt;
 461           <span class="indent">
 462             Order Deny,Allow<br />
 463             Deny from all<br />
 464             Allow from env=local_referal
 465           </span>
 466           &lt;/Directory&gt;
 467         </code></p></div>
 468
 469         <p>Pour plus d'informations sur cette technique, voir le tutoriel sur
 470         ServerWatch
 471         "<a href="http://www.serverwatch.com/tutorials/article.php/1132731">Keeping Your Images from Adorning Other Sites</a>".</p>
 472
 473   </div></div>
 474 <div class="bottomlang">
 475 <p><span>Langues Disponibles: </span><a href="./en/env.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 476 <a href="./fr/env.html" title="Français">&nbsp;fr&nbsp;</a> |
 477 <a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 478 <a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 479 <a href="./tr/env.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 480 </div><div id="footer">
 481 <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Authorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 482 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div>
 483 </body></html>