env.html.fr revision bbcf0849a87b48d6e116437100a2fbd78c8124db
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
bc8fd1b0b1afdf89b8d28eefa8cd74e26ba97986fielding XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb This file is generated from xml source: DO NOT EDIT
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<title>Apache et les variables d'environnement - Serveur Apache HTTP</title>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<link href="/images/favicon.ico" rel="shortcut icon" /></head>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<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>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Apache et les variables d'environnement</h1>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<p><span>Langues Disponibles: </span><a href="/en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<a href="/fr/env.html" title="Fran�ais"> fr </a> |
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<a href="/ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<a href="/ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<a href="/tr/env.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <p>Le serveur HTTP Apache propose un m�canisme de stockage d'informations
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb dans des variables appel�es <em>variables d'environnement</em>. Ces
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb informations peuvent servir � contr�ler diverses op�rations comme
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb l'enregistrement des traces ou le contr�le d'acc�s. On utilise aussi ces
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb variables dans le m�canisme de communication avec les programmes externes
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb comme les scripts CGI. Ce document pr�sente diff�rentes m�thodes pour
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb manipuler et utiliser ces variables.</p>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <p>Bien que ces variables soient r�f�renc�es comme <em>variables
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb d'environnement</em>, il ne faut pas les confondre avec les variables
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb d'environnement contr�l�es par le syst�me d'exploitation sous-jacent.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb En fait, ces variables sont stock�es et manipul�es dans une structure
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb interne � Apache. Elles ne deviennent de v�ritables variables
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb d'environnement du syst�me d'exploitation que lorsqu'elles sont mises � la
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb disposition de scripts CGI et de scripts inclus c�t� serveur (SSI). Si vous
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb souhaitez manipuler l'environnement du syst�me d'exploitation sous lequel
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb le serveur s'ex�cute, vous devez utiliser les m�canismes standards de
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb manipulation de l'environnement fournis par l'interpr�teur de commandes
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb (shell) de votre syst�me d'exploitation.</p>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#setting">D�finition des variables d'environnement</a></li>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<li><img alt="" src="/images/down.gif" /> <a href="#using">Utilisation des variables d'environnement</a></li>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<li><img alt="" src="/images/down.gif" /> <a href="#special">Variables d'environnement � usage sp�cial</a></li>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<li><img alt="" src="/images/down.gif" /> <a href="#examples">Exemples</a></li>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb<h2><a name="setting" id="setting">D�finition des variables d'environnement</a></h2>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <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>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <h3><a name="basic-manipulation" id="basic-manipulation">Manipulations de base de l'environnement</a></h3>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <p>La m�thode la plus �l�mentaire pour d�finir une variable
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb d'environnement au niveau d'Apache consiste � utiliser la directive
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb inconditionnelle <code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code>. Les variables peuvent aussi �tre transmises depuis
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb l'environnement du shell � partir duquel le serveur a �t� d�marr� en
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb utilisant la directive
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <code class="directive"><a href="/mod/mod_env.html#passenv">PassEnv</a></code>.</p>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <h3><a name="conditional" id="conditional">D�finitions conditionnelles en fonction des requ�tes</a></h3>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <p>Pour plus de souplesse, les directives fournies par le module
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code> permettent de d�finir les
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb variables d'environnement en tenant compte des caract�ristiques
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb de chaque requ�te. Par exemple, une
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb variable pourrait n'�tre d�finie que lorsqu'un navigateur sp�cifique
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb (User-Agent) a g�n�r� la requ�te, ou seulement quand un en-t�te
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb Referer particulier est pr�sent. La directive
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> du module
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> qui utilise l'option
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb les variables d'environnement apporte encore plus de souplesse.</p>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <h3><a name="unique-identifiers" id="unique-identifiers">Identifiants uniques</a></h3>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <p>Finalement, le module <code class="module"><a href="/mod/mod_unique_id.html">mod_unique_id</a></code> d�finit la variable
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb d'environnement <code>UNIQUE_ID</code> pour chaque requ�te � une valeur
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb qui est garantie unique parmi "toutes" les requ�tes sous des
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb conditions tr�s sp�cifiques.</p>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <h3><a name="standard-cgi" id="standard-cgi">Variables CGI standards</a></h3>
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz <p>En plus de l'ensemble des variables d'environnement internes � la
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz configuration d'Apache et de celles transmises depuis le shell,
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz les scripts CGI et les pages SSI
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz se voient affect�s un ensemble de variables
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz d'environnement contenant des m�ta-informations � propos de la requ�te
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz comme pr�conis� dans la
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz <a href="http://cgi-spec.golux.com/">sp�cification
4f9c22c4f27571d54197be9674e1fc0d528192aestriker <h3><a name="caveats" id="caveats">Quelques mises en garde</a></h3>
4f9c22c4f27571d54197be9674e1fc0d528192aestriker <li>Les directives de manipulation de l'environnement ne permettent
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb pas de supplanter ou modifier les variables CGI standards.</li>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <li>Lorsqu'on utilise <code class="program"><a href="/programs/suexec.html">suexec</a></code> pour ex�cuter des
4f9c22c4f27571d54197be9674e1fc0d528192aestriker scripts CGI, l'environnement est nettoy� et r�duit � un ensemble de
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb variables <em>s�res</em> avant l'ex�cution du script. La liste des
4f9c22c4f27571d54197be9674e1fc0d528192aestriker variables <em>s�res</em> est d�finie � la compilation dans
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <li>Pour des raisons de portabilit�, les noms des variables
4f9c22c4f27571d54197be9674e1fc0d528192aestriker d'environnement ne peuvent contenir que des lettres, des chiffres, et
4f9c22c4f27571d54197be9674e1fc0d528192aestriker le caract�re "souslign�". En outre, le premier caract�re ne doit pas
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb �tre un chiffre. Les caract�res qui ne satisfont pas � ces conditions
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe seront remplac�s par un caract�re "souslign�" quand ils seront
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe transmis aux scripts CGI et aux pages SSI.</li>
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe <li>La directive <code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code> s'ex�cute assez tard au
2d399cd7535887fceaa9f8f116eb98ce68ddd602trawick cours du traitement de la requ�te, ce qui signifie que des
c2cf53a40a9814eb91db2cdf820f97d943f21628coar 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
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe les variables qu'elle aura d�finies.</li>
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe<h2><a name="using" id="using">Utilisation des variables d'environnement</a></h2>
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe <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>
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe <h3><a name="cgi-scripts" id="cgi-scripts">Scripts CGI</a></h3>
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe <p>La communication d'informations aux scripts CGI constitue une des
3e392a5afd51526de3cb15d57ee46d8cb160ae65gregames principales utilisations des variables d'environnement. Comme indiqu�
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe plus haut, l'environnement transmis aux scripts CGI comprend des
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe m�ta-informations standards � propos de la requ�te, en plus des
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe variables d�finies dans la configuration d'Apache. Pour plus de
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe d�tails, se r�f�rer au
2a6e98ba4ffa30ded5d8831664c5cb2a170a56b6coar <h3><a name="ssi-pages" id="ssi-pages">Pages SSI</a></h3>
2a6e98ba4ffa30ded5d8831664c5cb2a170a56b6coar <p>Les documents inclus c�t� serveur (SSI) trait�s par le filtre
2a6e98ba4ffa30ded5d8831664c5cb2a170a56b6coar <code>INCLUDES</code> du module <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>,
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz peuvent afficher les
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz variables d'environnement � l'aide de l'�l�ment <code>echo</code>,
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe et peuvent utiliser des variables d'environnement dans les �l�ments
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe de contr�le de flux pour rendre certaines parties d'une page
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe conditionnelles en fonction des caract�ristiques de la requ�te.
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe Apache fournit aussi les variables d'environnement CGI standards
4f9c22c4f27571d54197be9674e1fc0d528192aestriker aux pages SSI
4f9c22c4f27571d54197be9674e1fc0d528192aestriker comme indiqu� plus haut. Pour plus de d�tails, se r�f�rer au
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe <h3><a name="access-control" id="access-control">Contr�le d'acc�s</a></h3>
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe <p>L'acc�s au serveur peut �tre contr�l� en fonction de la valeur de
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe variables d'environnement � l'aide des directives
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe <code>allow from env=</code> et <code>deny from env=</code>.
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe En association avec la directive
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe <code class="directive"><a href="/mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, ceci conf�re une
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe grande souplesse au contr�le d'acc�s au serveur en fonction des
4f9c22c4f27571d54197be9674e1fc0d528192aestriker caract�ristiques du client. Par exemple, vous pouvez utiliser ces
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe directives pour interdire l'acc�s depuis un navigateur particulier
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe (User-Agent).
4775dfc34c90fada8c7c4d6a57ed8a3114d55c2dtrawick <h3><a name="logging" id="logging">Enregistrement conditionnel des traces</a></h3>
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe <p>Les variables d'environnement peuvent �tre enregistr�es dans le
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe fichier de log des acc�s � l'aide de l'option <code>%e</code> de la
731344ed8f3677d1661c261ca5fcdd2ee3dbc74ccoar directive <code class="directive"><a href="/mod/mod_log_config.html#logformat">LogFormat</a></code>.
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe En outre, la d�cision de tracer ou non les requ�tes peut �tre prise
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe en fonction de l'�tat de variables d'environnement en utilisant la
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe forme conditionnelle de la directive
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe <code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code>. En
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe 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
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe du tra�age des requ�tes. Par exemple, vous pouvez choisir de ne pas
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe tracer les requ�tes pour des noms de fichiers se terminant par
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe <code>gif</code>, ou encore de ne tracer que les requ�tes des clients
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe n'appartenant pas � votre sous-r�seau.</p>
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe <h3><a name="response-headers" id="response-headers">En-t�tes de r�ponse conditionnels</a></h3>
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe <p>La directive <code class="directive"><a href="/mod/mod_headers.html#header">Header</a></code>
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe peut se baser sur la pr�sence ou l'absence d'une variable
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe d'environnement pour d�cider si un certain en-t�te HTTP sera plac�
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe dans la r�ponse au client. Ceci permet, par exemple, de n'envoyer un
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe certain en-t�te de r�ponse que si un en-t�te correspondant est pr�sent
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe dans la requ�te du client.</p>
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe <h3><a name="external-filter" id="external-filter">Activation de filtres externes</a></h3>
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe <p>Les filtres externes configur�s par le module
731344ed8f3677d1661c261ca5fcdd2ee3dbc74ccoar <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
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe activ�s de mani�re conditionnelle en fonction d'une variable
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe d'environnement � l'aide des options
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe <code>disableenv=</code> et <code>enableenv=</code>.</p>
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe <h3><a name="url-rewriting" id="url-rewriting">R��criture d'URL</a></h3>
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe directive <code class="directive"><a href="/mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz permet au moteur de r��criture du module
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> de prendre des
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz d�cisions conditionn�es par des variables d'environnement.
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe Notez que les variables accessibles dans
4f9c22c4f27571d54197be9674e1fc0d528192aestriker <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> sans le pr�fixe
c2cf53a40a9814eb91db2cdf820f97d943f21628coar d'environnement. Ce sont plut�t des variables sp�cifiques �
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz qui ne sont pas accessibles pour les autres modules.</p>
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe<h2><a name="special" id="special">Variables d'environnement � usage sp�cial</a></h2>
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe <p>Des probl�mes d'interop�rabilit� ont conduit � l'introduction de
4f9c22c4f27571d54197be9674e1fc0d528192aestriker m�canismes permettant de modifier le comportement d'Apache lorsqu'il
4f9c22c4f27571d54197be9674e1fc0d528192aestriker dialogue avec certains clients. Afin de rendre ces m�canismes aussi
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe souples que possible, ils sont invoqu�s en d�finissant des variables
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe d'environnement, en g�n�ral � l'aide de la directive
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz <code class="directive"><a href="/mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, bien que les
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz directives <code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code> et
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz <code class="directive"><a href="/mod/mod_env.html#passenv">PassEnv</a></code> puissent aussi �tre
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe utilis�es, par exemple.</p>
c2cf53a40a9814eb91db2cdf820f97d943f21628coar <h3><a name="downgrade" id="downgrade">downgrade-1.0</a></h3>
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz <p>Ceci force le traitement d'une requ�te comme une requ�te HTTP/1.0
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz m�me si elle a �t� r�dig�e dans un langage plus r�cent.</p>
4f9c22c4f27571d54197be9674e1fc0d528192aestriker <h3><a name="force-gzip" id="force-gzip">force-gzip</a></h3>
c2cf53a40a9814eb91db2cdf820f97d943f21628coar <p>Si le filtre <code>DEFLATE</code> est activ�, cette variable
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe d'environnement ignorera les r�glages accept-encoding de votre
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz navigateur et enverra une sortie compress�e inconditionnellement.</p>
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz <h3><a name="force-no-vary" id="force-no-vary">force-no-vary</a></h3>
fa06de8a28a737e8fbaad76d7f3ff67aaa5e4a09wrowe <p>Cette variable entra�ne la suppression de tout champ
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe <code>Vary</code> des en-t�tes de la r�ponse avant que cette derni�re
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe soit renvoy�e au client. Certains clients n'interpr�tent pas ce champ
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe correctement, et la d�finition de cette variable permet de contourner
4f9c22c4f27571d54197be9674e1fc0d528192aestriker ce probl�me, mais implique aussi la d�finition de
d4abb06ac220bb280ae996b6d21bbd257db51bb1jerenkrantz <h3><a name="force-response" id="force-response">force-response-1.0</a></h3>
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe <p>Cette variable force une r�ponse en langage HTTP/1.0 aux clients
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe qui envoient des requ�tes dans le m�me langage. Elle fut impl�ment�e �
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe l'origine suite � des probl�mes avec les mandataires d'AOL. Certains
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe clients en langage HTTP/1.0 ne r�agissent pas correctement face � une
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe r�ponse en langage HTTP/1.1, et cette variable peut �tre utilis�e pour
83a8dc5a596a8a1b9d14f063268287d123b9ed7ewrowe assurer l'interop�rabilit� avec eux.</p>
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe <h3><a name="gzip-only-text-html" id="gzip-only-text-html">gzip-only-text/html</a></h3>
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe <p>Positionn�e � "1", cette variable d�sactive le filtre en sortie
4f9c22c4f27571d54197be9674e1fc0d528192aestriker <code>DEFLATE</code> fourni par le module <code class="module"><a href="/mod/mod_deflate.html">mod_deflate</a></code> pour les
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe types de contenu autres que <code>text/html</code>. Si vous pr�f�rez
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe utiliser des fichiers compress�s statiquement,
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code> �value aussi la variable (non
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe seulement pour gzip, mais aussi pour tous les encodages autres que
0540a0b469147b52e858587270dba31c2aaa9e09wrowe "identity").</p>
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe <p>Quand cette variable est d�finie, le filtre <code>DEFLATE</code> du
4f9c22c4f27571d54197be9674e1fc0d528192aestriker module <code class="module"><a href="/mod/mod_deflate.html">mod_deflate</a></code> est d�sactiv�, et
4f9c22c4f27571d54197be9674e1fc0d528192aestriker <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code> refusera de d�livrer des ressources
4f9c22c4f27571d54197be9674e1fc0d528192aestriker encod�es.</p>
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe <h3><a name="no-cache" id="no-cache">no-cache</a></h3>
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe <p>Lorsque cette variable est d�finie,
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code> ne sauvegardera pas de r�ponse
a2b181763cb35fd899feb4a436aeadaa80bf91eabrianp susceptible d'�tre mise en cache. Cette variable d'environnement
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe n'a aucune incidence sur le fait qu'une r�ponse d�j� enregistr�e
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe dans la cache soit utilis�e ou non pour la requ�te courante.</p>
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe <h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3>
a2b181763cb35fd899feb4a436aeadaa80bf91eabrianp <p>Quand cette variable est d�finie, la directive
a2b181763cb35fd899feb4a436aeadaa80bf91eabrianp <code class="directive"><a href="/mod/core.html#keepalive">KeepAlive</a></code> est d�sactiv�e.</p>
a2b181763cb35fd899feb4a436aeadaa80bf91eabrianp <h3><a name="prefer-language" id="prefer-language">prefer-language</a></h3>
4f9c22c4f27571d54197be9674e1fc0d528192aestriker <p>Cette variable modifie le comportement du module
4f9c22c4f27571d54197be9674e1fc0d528192aestriker <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code>. Si elle contient un symbole de
4f9c22c4f27571d54197be9674e1fc0d528192aestriker ou <code>x-klingon</code>), <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code> essaie de
4f9c22c4f27571d54197be9674e1fc0d528192aestriker d�livrer une variante dans ce langage. S'il n'existe pas de telle
4f9c22c4f27571d54197be9674e1fc0d528192aestriker variante, le processus normal de
a2b181763cb35fd899feb4a436aeadaa80bf91eabrianp <a href="content-negotiation.html">n�gociation</a> s'applique.</p>
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe <h3><a name="redirect-carefully" id="redirect-carefully">redirect-carefully</a></h3>
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe <p>Cette variable force le serveur � �tre plus prudent lors de l'envoi
4f9c22c4f27571d54197be9674e1fc0d528192aestriker d'une redirection au client. Elle est en g�n�ral utilis�e quand un
a2b181763cb35fd899feb4a436aeadaa80bf91eabrianp client pr�sente un probl�me connu avec les redirections. Elle fut
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe impl�ment�e � l'origine suite a un probl�me rencontr� avec le logiciel
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe WebFolders de Microsoft qui ne g�re pas correctement les redirections
cc9582e53aead2a044077c4a92f3dfc3605590b3wrowe vers des ressources de type r�pertoire via des m�thodes DAV.</p>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <h3><a name="suppress-error-charset" id="suppress-error-charset">suppress-error-charset</a></h3>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <p><em>Disponible dans les versions post�rieures � 2.0.54</em></p>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <p>Quand Apache g�n�re une redirection en r�ponse � une requ�te client,
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb la r�ponse inclut un texte destin� � �tre affich� au cas o� le client ne
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb suivrait pas, ou ne pourrait pas suivre automatiquement la redirection.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb Habituellement, Apache marque ce texte en accord avec le jeu de caract�res
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb qu'il utilise, � savoir ISO-8859-1.</p>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <p> Cependant, si la redirection fait r�f�rence � une page qui utilise un
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb jeu de caract�res diff�rent, certaines versions de navigateurs obsol�tes
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb essaieront d'utiliser le jeu de caract�res du texte de la redirection
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb plut�t que celui de la page r�elle.
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb Ceci peut entra�ner, par exemple, un rendu incorrect du Grec.</p>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <p>Si cette variable d'environnement est d�finie, Apache omettra le jeu de
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb caract�res pour le texte de la redirection, et les navigateurs obsol�tes
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb pr�cit�s utiliseront correctement celui de la page de destination.</p>
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb <p>L'envoi de pages d'erreur sans sp�cifier un jeu de caract�res peut
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb conduire � des attaques de type "cross-site-scripting" pour les
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb navigateurs qui ne respectent pas la sp�cification HTTP/1.1 (MSIE) et
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb tentent de d�duire le jeu de caract�res � partir du contenu. De tels
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb navigateurs peuvent �tre facilement tromp�s et utiliser le jeu de
2d399cd7535887fceaa9f8f116eb98ce68ddd602trawick caract�res UTF-7 ; les contenus des donn�es en entr�e de type UTF-7
c2cf53a40a9814eb91db2cdf820f97d943f21628coar (comme les URI de requ�te) ne seront alors plus prot�g�s par les
c2cf53a40a9814eb91db2cdf820f97d943f21628coar m�canismes d'�chappement usuels con�us pour pr�venir les attaques
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb de type "cross-site-scripting".</p>
4f9c22c4f27571d54197be9674e1fc0d528192aestriker <h3><a name="proxy" id="proxy">force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked,
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe proxy-sendcl, proxy-chain-auth, proxy-interim-response, proxy-initial-not-pooled</a></h3>
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe <p>Ces directives modifient le comportement protocolaire du module
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>. Voir la documentation sur
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe <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>
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe <h3><a name="misbehaving" id="misbehaving">Modification du comportement protocolaire face � des clients
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe <p>Les versions ant�rieures recommandaient l'ajout de ces lignes dans
731344ed8f3677d1661c261ca5fcdd2ee3dbc74ccoar httpd.conf pour tenir compte de probl�mes connus avec certains clients.
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe Comme les clients concern�s sont maintenant tr�s peu utilis�s, cet
731344ed8f3677d1661c261ca5fcdd2ee3dbc74ccoar ajout n'est pratiquement plus n�cessaire.</p>
7c301a1818939f85da8f3629cc3e9b5588610ef0jerenkrantz# The following directives modify normal HTTP response behavior.
7c301a1818939f85da8f3629cc3e9b5588610ef0jerenkrantz# The first directive disables keepalive for Netscape 2.x and browsers that
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe# spoof it. There are known problems with these browser implementations.
659ad814f714e556bdd03e1d771cba156baab92ewrowe# The second directive is for Microsoft Internet Explorer 4.0b2
659ad814f714e556bdd03e1d771cba156baab92ewrowe# which has a broken HTTP/1.1 implementation and does not properly
659ad814f714e556bdd03e1d771cba156baab92ewrowe# support keepalive when it is used on 301 or 302 (redirect) responses.
731344ed8f3677d1661c261ca5fcdd2ee3dbc74ccoarBrowserMatch "Mozilla/2" nokeepalive
11fb2f3611e6ff9a541e10b13e3108934f828141gregamesBrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
7c301a1818939f85da8f3629cc3e9b5588610ef0jerenkrantz# The following directive disables HTTP/1.1 responses to browsers which
7c301a1818939f85da8f3629cc3e9b5588610ef0jerenkrantz# are in violation of the HTTP/1.0 spec by not being able to grok a
7c301a1818939f85da8f3629cc3e9b5588610ef0jerenkrantz# basic 1.1 response.
4f9c22c4f27571d54197be9674e1fc0d528192aestrikerBrowserMatch "RealPlayer 4\.0" force-response-1.0
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwroweBrowserMatch "Java/1\.0" force-response-1.0
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe <h3><a name="no-img-log" id="no-img-log">Ne pas tracer les requ�tes pour des images dans le fichier de
2f1949bb0e3c209db94c8d521cba7380b9d11421trawick <p>Dans cet exemple, les requ�tes pour des images n'apparaissent pas
731344ed8f3677d1661c261ca5fcdd2ee3dbc74ccoar dans le fichier de trace des acc�s. Il peut �tre facilement adapt� pour
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe emp�cher le tra�age de r�pertoires particuliers, ou de requ�tes
731344ed8f3677d1661c261ca5fcdd2ee3dbc74ccoar en provenance de certains h�tes.</p>
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe SetEnvIf Request_URI \.gif image-request<br />
4f9c22c4f27571d54197be9674e1fc0d528192aestriker SetEnvIf Request_URI \.jpg image-request<br />
4f9c22c4f27571d54197be9674e1fc0d528192aestriker SetEnvIf Request_URI \.png image-request<br />
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe <h3><a name="image-theft" id="image-theft">Pr�vention du "Vol d'image"</a></h3>
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe <p>Cet exemple montre comment emp�cher les utilisateurs ne faisant pas
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe partie de votre serveur d'utiliser des images de votre serveur comme
7c301a1818939f85da8f3629cc3e9b5588610ef0jerenkrantz images en ligne dans leurs pages. Cette configuration n'est pas
7c301a1818939f85da8f3629cc3e9b5588610ef0jerenkrantz recommand�e, mais elle peut fonctionner dans des circonstances bien
7c301a1818939f85da8f3629cc3e9b5588610ef0jerenkrantz d�finies. Nous supposons que toutes vos images sont enregistr�es dans
7c301a1818939f85da8f3629cc3e9b5588610ef0jerenkrantz un r�pertoire nomm� <code>/web/images</code>.</p>
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe SetEnvIf Referer "^http://www\.example\.com/" local_referal
290ecc1ddceca1ed49bc1a5338921264b5c3e07cwrowe # Allow browsers that do not send Referer info
b38846b15c8891c6dec44dcc4f96ca40721bf663rbb SetEnvIf Referer "^$" local_referal
700b96db75e7cfadb5219978c1735b710d583763wrowe Order Deny,Allow<br />
700b96db75e7cfadb5219978c1735b710d583763wrowe Deny from all<br />
700b96db75e7cfadb5219978c1735b710d583763wrowe Allow from env=local_referal
700b96db75e7cfadb5219978c1735b710d583763wrowe </Directory>
700b96db75e7cfadb5219978c1735b710d583763wrowe <p>Pour plus d'informations sur cette technique, voir le tutoriel sur
700b96db75e7cfadb5219978c1735b710d583763wrowe ServerWatch
700b96db75e7cfadb5219978c1735b710d583763wrowe "<a href="http://www.serverwatch.com/tutorials/article.php/1132731">Keeping Your Images from Adorning Other Sites</a>".</p>
700b96db75e7cfadb5219978c1735b710d583763wrowe<p><span>Langues Disponibles: </span><a href="/en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
700b96db75e7cfadb5219978c1735b710d583763wrowe<a href="/fr/env.html" title="Fran�ais"> fr </a> |
700b96db75e7cfadb5219978c1735b710d583763wrowe<a href="/ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
700b96db75e7cfadb5219978c1735b710d583763wrowe<a href="/ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
6964758306167dd898baedd21048bd1515dd9d30trawick<a href="/tr/env.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
700b96db75e7cfadb5219978c1735b710d583763wrowe<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>
700b96db75e7cfadb5219978c1735b710d583763wrowe<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>