env.html.fr revision a8c35ec6f8811732d20d218531750ef139bde308
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny This file is generated from xml source: DO NOT EDIT
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<title>Apache et les variables d'environnement - Serveur Apache HTTP</title>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<script src="/style/scripts/prettify.min.js" type="text/javascript">
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<link href="/images/favicon.ico" rel="shortcut icon" /></head>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<p class="apache">Serveur Apache HTTP Version 2.5</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<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.5</a></div><div id="page-content"><div id="preamble"><h1>Apache et les variables d'environnement</h1>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<p><span>Langues Disponibles: </span><a href="/en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<a href="/fr/env.html" title="Fran�ais"> fr </a> |
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<a href="/ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<a href="/ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
b58460076fe843c11d736ae244c1ac979a6473a4Simo Sorce<a href="/tr/env.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Deux types de variables d'environnement affectent le serveur
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny HTTP Apache.</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Le premier type correspond aux variables d'environnement
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce contr�l�es par le syst�me d'exploitation sous-jacent et d�finies
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny avant le d�marrage du serveur. Leurs valeurs peuvent �tre utilis�es
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny directement dans les fichiers de configuration, et peuvent
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny �ventuellement �tre transmises aux scripts CGI et SSI via la
b58460076fe843c11d736ae244c1ac979a6473a4Simo Sorce directive PassEnv.</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Le second type correspond aux variables nomm�es appel�es aussi
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <em>variables d'environnement</em> dans lesquelles le serveur HTTP
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny Apache stocke des informations via un m�canisme sp�cial. Ces
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny informations peuvent servir � contr�ler diverses op�rations comme
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny l'enregistrement des traces ou le contr�le d'acc�s. On utilise aussi ces
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny variables dans le m�canisme de communication avec les programmes externes
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny comme les scripts CGI. Ce document pr�sente diff�rentes m�thodes pour
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny manipuler et utiliser ces variables.</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Bien que ces variables soient r�f�renc�es comme <em>variables
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny d'environnement</em>, il ne faut pas les confondre avec les variables
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny d'environnement contr�l�es par le syst�me d'exploitation sous-jacent.
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny En fait, ces variables sont stock�es et manipul�es dans une structure
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny interne � Apache. Elles ne deviennent de v�ritables variables
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny d'environnement du syst�me d'exploitation que lorsqu'elles sont mises � la
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny disposition de scripts CGI et de scripts inclus c�t� serveur (SSI). Si vous
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny souhaitez manipuler l'environnement du syst�me d'exploitation sous lequel
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny le serveur s'ex�cute, vous devez utiliser les m�canismes standards de
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny manipulation de l'environnement fournis par l'interpr�teur de commandes
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny (shell) de votre syst�me d'exploitation.</p>
6a8999bf933f72923a271831d85a01ef88a81f39Jakub Hrozek<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#setting">D�finition des variables d'environnement</a></li>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<li><img alt="" src="/images/down.gif" /> <a href="#using">Utilisation des variables d'environnement</a></li>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<li><img alt="" src="/images/down.gif" /> <a href="#special">Variables d'environnement � usage sp�cial</a></li>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<li><img alt="" src="/images/down.gif" /> <a href="#examples">Exemples</a></li>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
b58460076fe843c11d736ae244c1ac979a6473a4Simo Sorce<h2><a name="setting" id="setting">D�finition des variables d'environnement</a></h2>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <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_cache.html">mod_cache</a></code></li><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>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <h3><a name="basic-manipulation" id="basic-manipulation">Manipulations de base de l'environnement</a></h3>
7fe69bb6ec70bce439c6b975a9a0044c98ff502bSimo Sorce <p>La m�thode la plus �l�mentaire pour d�finir une variable
7fe69bb6ec70bce439c6b975a9a0044c98ff502bSimo Sorce d'environnement au niveau d'Apache consiste � utiliser la directive
7fe69bb6ec70bce439c6b975a9a0044c98ff502bSimo Sorce inconditionnelle <code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code>. Les variables peuvent aussi �tre transmises depuis
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny l'environnement du shell � partir duquel le serveur a �t� d�marr� en
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny utilisant la directive
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <code class="directive"><a href="/mod/mod_env.html#passenv">PassEnv</a></code>.</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <h3><a name="conditional" id="conditional">D�finitions conditionnelles en fonction des requ�tes</a></h3>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Pour plus de souplesse, les directives fournies par le module
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code> permettent de d�finir les
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce variables d'environnement en tenant compte des caract�ristiques
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce de chaque requ�te. Par exemple, une
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce variable pourrait n'�tre d�finie que lorsqu'un navigateur sp�cifique
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce (User-Agent) a g�n�r� la requ�te, ou seulement quand un en-t�te
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce Referer particulier est pr�sent. La directive
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> du module
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> qui utilise l'option
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce les variables d'environnement apporte encore plus de souplesse.</p>
7fe69bb6ec70bce439c6b975a9a0044c98ff502bSimo Sorce <h3><a name="unique-identifiers" id="unique-identifiers">Identifiants uniques</a></h3>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Finalement, le module <code class="module"><a href="/mod/mod_unique_id.html">mod_unique_id</a></code> d�finit la variable
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny d'environnement <code>UNIQUE_ID</code> pour chaque requ�te � une valeur
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny qui est garantie unique parmi "toutes" les requ�tes sous des
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny conditions tr�s sp�cifiques.</p>
7fe69bb6ec70bce439c6b975a9a0044c98ff502bSimo Sorce <h3><a name="standard-cgi" id="standard-cgi">Variables CGI standards</a></h3>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>En plus de l'ensemble des variables d'environnement internes � la
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny configuration d'Apache et de celles transmises depuis le shell,
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny les scripts CGI et les pages SSI
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny se voient affect�s un ensemble de variables
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny d'environnement contenant des m�ta-informations � propos de la requ�te
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny comme pr�conis� dans la
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <a href="http://www.ietf.org/rfc/rfc3875">sp�cification
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <h3><a name="caveats" id="caveats">Quelques mises en garde</a></h3>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <li>Les directives de manipulation de l'environnement ne permettent
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny pas de supplanter ou modifier les variables CGI standards.</li>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <li>Lorsqu'on utilise <code class="program"><a href="/programs/suexec.html">suexec</a></code> pour ex�cuter des
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny scripts CGI, l'environnement est nettoy� et r�duit � un ensemble de
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny variables <em>s�res</em> avant l'ex�cution du script. La liste des
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny variables <em>s�res</em> est d�finie � la compilation dans
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <li>Pour des raisons de portabilit�, les noms des variables
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny d'environnement ne peuvent contenir que des lettres, des chiffres, et
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny le caract�re "souslign�". En outre, le premier caract�re ne doit pas
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny �tre un chiffre. Les caract�res qui ne satisfont pas � ces conditions
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny seront remplac�s par un caract�re "souslign�" quand ils seront
b58460076fe843c11d736ae244c1ac979a6473a4Simo Sorce transmis aux scripts CGI et aux pages SSI.</li>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <li>Les contenus d'en-t�tes HTTP transmis aux scripts de type
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce CGI ou autre via des variables d'environnement constituent un
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny cas particulier (voir plus loin). Leur nom est converti en
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny majuscules et seuls les tirets sont remplac�s par des
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny caract�res '_' ("soulign�") ; si le format du nom de l'en-t�te
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny n'est pas valide, celui-ci est ignor�. Voir <a href="#fixheader">plus loin</a> pour une solution de
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny contournement du probl�me.</li>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <li>La directive <code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code> s'ex�cute assez tard au
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny cours du traitement de la requ�te, ce qui signifie que des
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny 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
b58460076fe843c11d736ae244c1ac979a6473a4Simo Sorce les variables qu'elle aura d�finies.</li>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <li>Lorsque le serveur cherche un chemin via une <a class="glossarylink" href="/glossary.html#subrequest" title="voir glossaire">sous-requ�te</a> interne (par exemple la
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny recherche d'un <code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>), ou lorsqu'il g�n�re un
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny listing du contenu d'un r�pertoire via le module
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code>, la sous-requ�te n'h�rite pas des
0754ff886f909f0404038eb9c99dd61be1acf5b9Simo Sorce variables d'environnement sp�cifiques � la requ�te. En outre, � cause
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny des phases de l'API auxquelles <code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code> prend
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny part, les directives <code class="directive"><a href="/mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> ne sont pas �valu�es
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny s�par�ment dans la sous-requ�te.</li>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny<h2><a name="using" id="using">Utilisation des variables d'environnement</a></h2>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <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_core.html#require">Require</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_access_compat.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>
cb388d52f49f54963379cc20a25e14d17fe6e9a3Simo Sorce <h3><a name="cgi-scripts" id="cgi-scripts">Scripts CGI</a></h3>
cb388d52f49f54963379cc20a25e14d17fe6e9a3Simo Sorce <p>La communication d'informations aux scripts CGI constitue une des
cb388d52f49f54963379cc20a25e14d17fe6e9a3Simo Sorce principales utilisations des variables d'environnement. Comme indiqu�
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny plus haut, l'environnement transmis aux scripts CGI comprend des
cb388d52f49f54963379cc20a25e14d17fe6e9a3Simo Sorce m�ta-informations standards � propos de la requ�te, en plus des
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny variables d�finies dans la configuration d'Apache. Pour plus de
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny d�tails, se r�f�rer au
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <h3><a name="ssi-pages" id="ssi-pages">Pages SSI</a></h3>
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <p>Les documents inclus c�t� serveur (SSI) trait�s par le filtre
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <code>INCLUDES</code> du module <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>,
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce peuvent afficher les
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce variables d'environnement � l'aide de l'�l�ment <code>echo</code>,
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce et peuvent utiliser des variables d'environnement dans les �l�ments
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce de contr�le de flux pour rendre certaines parties d'une page
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny conditionnelles en fonction des caract�ristiques de la requ�te.
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny Apache fournit aussi les variables d'environnement CGI standards
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny aux pages SSI
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny comme indiqu� plus haut. Pour plus de d�tails, se r�f�rer au
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <h3><a name="access-control" id="access-control">Contr�le d'acc�s</a></h3>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <p>L'acc�s au serveur peut �tre contr�l� en fonction de la valeur de
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny variables d'environnement � l'aide des directives
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <code>allow from env=</code> et <code>deny from env=</code>.
fc0e15ef667a7263787afdc8fc59c61f5bdd6d00Sumit Bose En association avec la directive
fc0e15ef667a7263787afdc8fc59c61f5bdd6d00Sumit Bose <code class="directive"><a href="/mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, ceci conf�re une
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny grande souplesse au contr�le d'acc�s au serveur en fonction des
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny caract�ristiques du client. Par exemple, vous pouvez utiliser ces
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny directives pour interdire l'acc�s depuis un navigateur particulier
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny (User-Agent).
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <h3><a name="logging" id="logging">Enregistrement conditionnel des traces</a></h3>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <p>Les variables d'environnement peuvent �tre enregistr�es dans le
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny fichier de log des acc�s � l'aide de l'option <code>%e</code> de la
0754ff886f909f0404038eb9c99dd61be1acf5b9Simo Sorce directive <code class="directive"><a href="/mod/mod_log_config.html#logformat">LogFormat</a></code>.
b58460076fe843c11d736ae244c1ac979a6473a4Simo Sorce En outre, la d�cision de tracer ou non les requ�tes peut �tre prise
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny en fonction de l'�tat de variables d'environnement en utilisant la
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny forme conditionnelle de la directive
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code>. En
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny 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
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny du tra�age des requ�tes. Par exemple, vous pouvez choisir de ne pas
b58460076fe843c11d736ae244c1ac979a6473a4Simo Sorce tracer les requ�tes pour des noms de fichiers se terminant par
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <code>gif</code>, ou encore de ne tracer que les requ�tes des clients
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny n'appartenant pas � votre sous-r�seau.</p>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <h3><a name="response-headers" id="response-headers">En-t�tes de r�ponse conditionnels</a></h3>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <p>La directive <code class="directive"><a href="/mod/mod_headers.html#header">Header</a></code>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny peut se baser sur la pr�sence ou l'absence d'une variable
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny d'environnement pour d�cider si un certain en-t�te HTTP sera plac�
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny dans la r�ponse au client. Ceci permet, par exemple, de n'envoyer un
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny certain en-t�te de r�ponse que si un en-t�te correspondant est pr�sent
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny dans la requ�te du client.</p>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <h3><a name="external-filter" id="external-filter">Activation de filtres externes</a></h3>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <p>Les filtres externes configur�s par le module
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <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
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny activ�s de mani�re conditionnelle en fonction d'une variable
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny d'environnement � l'aide des options
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <code>disableenv=</code> et <code>enableenv=</code>.</p>
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <h3><a name="url-rewriting" id="url-rewriting">R��criture d'URL</a></h3>
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <p>La forme <code>%{ENV:<em>variable</em>}</code> de
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce directive <code class="directive"><a href="/mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce permet au moteur de r��criture du module
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> de prendre des
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce d�cisions conditionn�es par des variables d'environnement.
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce Notez que les variables accessibles dans
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> sans le pr�fixe
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <code>ENV:</code> ne sont pas de v�ritables variables
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce d'environnement. Ce sont plut�t des variables sp�cifiques �
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce qui ne sont pas accessibles pour les autres modules.</p>
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny<h2><a name="special" id="special">Variables d'environnement � usage sp�cial</a></h2>
7fe69bb6ec70bce439c6b975a9a0044c98ff502bSimo Sorce <p>Des probl�mes d'interop�rabilit� ont conduit � l'introduction de
7fe69bb6ec70bce439c6b975a9a0044c98ff502bSimo Sorce m�canismes permettant de modifier le comportement d'Apache lorsqu'il
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny dialogue avec certains clients. Afin de rendre ces m�canismes aussi
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny souples que possible, ils sont invoqu�s en d�finissant des variables
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny d'environnement, en g�n�ral � l'aide de la directive
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <code class="directive"><a href="/mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, bien que les
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny directives <code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code> et
7616a65d63d3bd0f669a871fd0ed89185956e9ceSimo Sorce <code class="directive"><a href="/mod/mod_env.html#passenv">PassEnv</a></code> puissent aussi �tre
7616a65d63d3bd0f669a871fd0ed89185956e9ceSimo Sorce utilis�es, par exemple.</p>
c03b28a38b14fdb59f74864ae4dc56affe256508Simo Sorce <h3><a name="downgrade" id="downgrade">downgrade-1.0</a></h3>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <p>Ceci force le traitement d'une requ�te comme une requ�te HTTP/1.0
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny m�me si elle a �t� r�dig�e dans un langage plus r�cent.</p>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <h3><a name="force-gzip" id="force-gzip">force-gzip</a></h3>
c929c213c91b2f9d55f96d6964b9390636178991Simo Sorce <p>Si le filtre <code>DEFLATE</code> est activ�, cette variable
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny d'environnement ignorera les r�glages accept-encoding de votre
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny navigateur et enverra une sortie compress�e inconditionnellement.</p>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <h3><a name="force-no-vary" id="force-no-vary">force-no-vary</a></h3>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <p>Cette variable entra�ne la suppression de tout champ
7616a65d63d3bd0f669a871fd0ed89185956e9ceSimo Sorce <code>Vary</code> des en-t�tes de la r�ponse avant que cette derni�re
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny soit renvoy�e au client. Certains clients n'interpr�tent pas ce champ
c03b28a38b14fdb59f74864ae4dc56affe256508Simo Sorce correctement, et la d�finition de cette variable permet de contourner
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny ce probl�me, mais implique aussi la d�finition de
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <h3><a name="force-response" id="force-response">force-response-1.0</a></h3>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <p>Cette variable force une r�ponse en langage HTTP/1.0 aux clients
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny qui envoient des requ�tes dans le m�me langage. Elle fut impl�ment�e �
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny l'origine suite � des probl�mes avec les mandataires d'AOL. Certains
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny clients en langage HTTP/1.0 ne r�agissent pas correctement face � une
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny r�ponse en langage HTTP/1.1, et cette variable peut �tre utilis�e pour
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny assurer l'interop�rabilit� avec eux.</p>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <h3><a name="gzip-only-text-html" id="gzip-only-text-html">gzip-only-text/html</a></h3>
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <p>Positionn�e � "1", cette variable d�sactive le filtre en sortie
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <code>DEFLATE</code> fourni par le module <code class="module"><a href="/mod/mod_deflate.html">mod_deflate</a></code> pour les
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny types de contenu autres que <code>text/html</code>. Si vous pr�f�rez
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny utiliser des fichiers compress�s statiquement,
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code> �value aussi la variable (non
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny seulement pour gzip, mais aussi pour tous les encodages autres que
84c611c1b7c04cc7735ab54d4e5f48284b79e6fbJan Zeleny "identity").</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <h3><a name="no-gzip" id="no-gzip">no-gzip</a></h3>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Quand cette variable est d�finie, le filtre <code>DEFLATE</code> du
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny module <code class="module"><a href="/mod/mod_deflate.html">mod_deflate</a></code> est d�sactiv�, et
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code> refusera de d�livrer des ressources
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny encod�es.</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <h3><a name="no-cache" id="no-cache">no-cache</a></h3>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p><em>Disponible dans les versions 2.2.12 et ult�rieures d'Apache</em></p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Lorsque cette variable est d�finie,
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code> ne sauvegardera pas de r�ponse
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny susceptible d'�tre mise en cache. Cette variable d'environnement
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny n'a aucune incidence sur le fait qu'une r�ponse d�j� enregistr�e
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny dans la cache soit utilis�e ou non pour la requ�te courante.</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Quand cette variable est d�finie, la directive
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <code class="directive"><a href="/mod/core.html#keepalive">KeepAlive</a></code> est d�sactiv�e.</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <h3><a name="prefer-language" id="prefer-language">prefer-language</a></h3>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Cette variable modifie le comportement du module
7616a65d63d3bd0f669a871fd0ed89185956e9ceSimo Sorce <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code>. Si elle contient un symbole de
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny langage (tel que <code>en</code>, <code>ja</code>
c03b28a38b14fdb59f74864ae4dc56affe256508Simo Sorce ou <code>x-klingon</code>), <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code> essaie de
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny d�livrer une variante dans ce langage. S'il n'existe pas de telle
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny variante, le processus normal de
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <a href="content-negotiation.html">n�gociation</a> s'applique.</p>
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <h3><a name="redirect-carefully" id="redirect-carefully">redirect-carefully</a></h3>
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <p>Cette variable force le serveur � �tre plus prudent lors de l'envoi
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce d'une redirection au client. Elle est en g�n�ral utilis�e quand un
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce client pr�sente un probl�me connu avec les redirections. Elle fut
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce impl�ment�e � l'origine suite a un probl�me rencontr� avec le logiciel
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce WebFolders de Microsoft qui ne g�re pas correctement les redirections
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce vers des ressources de type r�pertoire via des m�thodes DAV.</p>
204cfc89a076fd32bf34f2abb3f809304aaa88abSimo Sorce <h3><a name="suppress-error-charset" id="suppress-error-charset">suppress-error-charset</a></h3>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p><em>Disponible dans les versions post�rieures � 2.0.54</em></p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Quand Apache g�n�re une redirection en r�ponse � une requ�te client,
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny la r�ponse inclut un texte destin� � �tre affich� au cas o� le client ne
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny suivrait pas, ou ne pourrait pas suivre automatiquement la redirection.
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny Habituellement, Apache marque ce texte en accord avec le jeu de caract�res
7616a65d63d3bd0f669a871fd0ed89185956e9ceSimo Sorce qu'il utilise, � savoir ISO-8859-1.</p>
7616a65d63d3bd0f669a871fd0ed89185956e9ceSimo Sorce <p> Cependant, si la redirection fait r�f�rence � une page qui utilise un
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny jeu de caract�res diff�rent, certaines versions de navigateurs obsol�tes
c03b28a38b14fdb59f74864ae4dc56affe256508Simo Sorce essaieront d'utiliser le jeu de caract�res du texte de la redirection
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny plut�t que celui de la page r�elle.
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny Ceci peut entra�ner, par exemple, un rendu incorrect du Grec.</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Si cette variable d'environnement est d�finie, Apache omettra le jeu de
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny caract�res pour le texte de la redirection, et les navigateurs obsol�tes
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny pr�cit�s utiliseront correctement celui de la page de destination.</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>L'envoi de pages d'erreur sans sp�cifier un jeu de caract�res peut
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny conduire � des attaques de type "cross-site-scripting" pour les
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny navigateurs qui ne respectent pas la sp�cification HTTP/1.1 (MSIE) et
7616a65d63d3bd0f669a871fd0ed89185956e9ceSimo Sorce tentent de d�duire le jeu de caract�res � partir du contenu. De tels
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny navigateurs peuvent �tre facilement tromp�s et utiliser le jeu de
c03b28a38b14fdb59f74864ae4dc56affe256508Simo Sorce caract�res UTF-7 ; les contenus des donn�es en entr�e de type UTF-7
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny (comme les URI de requ�te) ne seront alors plus prot�g�s par les
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny m�canismes d'�chappement usuels con�us pour pr�venir les attaques
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny de type "cross-site-scripting".</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <h3><a name="proxy" id="proxy">force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked,
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny proxy-sendcl, proxy-chain-auth, proxy-interim-response, proxy-initial-not-pooled</a></h3>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Ces directives modifient le comportement protocolaire du module
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>. Voir la documentation sur
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <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>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<h2><a name="examples" id="examples">Exemples</a></h2>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <h3><a name="fixheader" id="fixheader">Transmission du contenu d'en-t�tes non valides aux scripts
efea50efda58be66638e5d38c8e57fdf9992f204Simo Sorce <p>Avec la version 2.4, Apache est plus strict avec la conversion
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny des en-t�tes HTTP en variables d'environnement dans
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code> et d'autres modules : dans les versions
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny pr�c�dentes, tout caract�re invalide dans les noms d'en-t�tes
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny �tait tout simplement remplac� par un caract�re '_', ce qui
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny pouvait exposer � des attaques de type cross-site-scripting via
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny injection d'en-t�tes (voir <a href="http://events.ccc.de/congress/2007/Fahrplan/events/2212.en.html">Bogues
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Si vous devez supporter un client qui envoie des en-t�tes non
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny conformes et si ceux-ci ne peuvent pas �tre corrig�s, il existe
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny une solution de contournement simple mettant en jeu les modules
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code> et <code class="module"><a href="/mod/mod_headers.html">mod_headers</a></code>,
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny et permettant de prendre en compte ces en-t�tes :</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<pre class="prettyprint lang-config"># L'exemple suivant montre comment prendre en compte un en-t�te<br />
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny# Accept_Encoding non conforme envoy� par un client.
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan ZelenySetEnvIfNoCase ^Accept.Encoding$ ^(.*)$ fix_accept_encoding=$1
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan ZelenyRequestHeader set Accept-Encoding %{fix_accept_encoding}e env=fix_accept_encoding</pre>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <h3><a name="misbehaving" id="misbehaving">Modification du comportement protocolaire face � des clients
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Les versions ant�rieures recommandaient l'ajout de ces lignes dans
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny httpd.conf pour tenir compte de probl�mes connus avec certains clients.
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny Comme les clients concern�s sont maintenant tr�s peu utilis�s, cet
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny ajout n'est pratiquement plus n�cessaire.</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny# The following directives modify normal HTTP response behavior.
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny# The first directive disables keepalive for Netscape 2.x and browsers that
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny# spoof it. There are known problems with these browser implementations.
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny# The second directive is for Microsoft Internet Explorer 4.0b2
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny# which has a broken HTTP/1.1 implementation and does not properly
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny# support keepalive when it is used on 301 or 302 (redirect) responses.
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan ZelenyBrowserMatch "Mozilla/2" nokeepalive
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan ZelenyBrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny# The following directive disables HTTP/1.1 responses to browsers which
efea50efda58be66638e5d38c8e57fdf9992f204Simo Sorce# are in violation of the HTTP/1.0 spec by not being able to grok a
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny# basic 1.1 response.
7fe69bb6ec70bce439c6b975a9a0044c98ff502bSimo SorceBrowserMatch "RealPlayer 4\.0" force-response-1.0
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan ZelenyBrowserMatch "Java/1\.0" force-response-1.0
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan ZelenyBrowserMatch "JDK/1\.0" force-response-1.0</pre>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <h3><a name="no-img-log" id="no-img-log">Ne pas tracer les requ�tes pour des images dans le fichier de
efea50efda58be66638e5d38c8e57fdf9992f204Simo Sorce <p>Dans cet exemple, les requ�tes pour des images n'apparaissent pas
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny dans le fichier de trace des acc�s. Il peut �tre facilement adapt� pour
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny emp�cher le tra�age de r�pertoires particuliers, ou de requ�tes
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny en provenance de certains h�tes.</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <pre class="prettyprint lang-config">SetEnvIf Request_URI \.gif image-request
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan ZelenySetEnvIf Request_URI \.jpg image-request
efea50efda58be66638e5d38c8e57fdf9992f204Simo SorceSetEnvIf Request_URI \.png image-request
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan ZelenyCustomLog logs/access_log common env=!image-request</pre>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <h3><a name="image-theft" id="image-theft">Pr�vention du "Vol d'image"</a></h3>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Cet exemple montre comment emp�cher les utilisateurs ne faisant pas
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny partie de votre serveur d'utiliser des images de votre serveur comme
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny images en ligne dans leurs pages. Cette configuration n'est pas
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny recommand�e, mais elle peut fonctionner dans des circonstances bien
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny d�finies. Nous supposons que toutes vos images sont enregistr�es dans
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny un r�pertoire nomm� <code>/web/images</code>.</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <pre class="prettyprint lang-config">SetEnvIf Referer "^http://www\.example\.com/" local_referal
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny# Autorise les navigateurs qui n'envoient aucune information de Referer
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan ZelenySetEnvIf Referer "^$" local_referal
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny Require env local_referal
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny</Directory></pre>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny <p>Pour plus d'informations sur cette technique, voir le tutoriel sur
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny "<a href="http://www.serverwatch.com/tutorials/article.php/1132731">Keeping Your Images from Adorning Other Sites</a>".</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<p><span>Langues Disponibles: </span><a href="/en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<a href="/fr/env.html" title="Fran�ais"> fr </a> |
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<a href="/ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<a href="/ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<a href="/tr/env.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
3a59cbd0b7b9c5dd3c62ac1679876070c264d80fMichal Zidek</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<script type="text/javascript"><!--//--><![CDATA[//><!--
3a59cbd0b7b9c5dd3c62ac1679876070c264d80fMichal Zidekvar comments_shortname = 'httpd';
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zelenyvar comments_identifier = 'http://httpd.apache.org/docs/trunk/env.html';
3a59cbd0b7b9c5dd3c62ac1679876070c264d80fMichal Zidek(function(w, d) {
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny d.write('<div id="comments_thread"><\/div>');
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny var s = d.createElement('script');
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny})(window, document);
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zelenyif (typeof(prettyPrint) !== 'undefined') {
e76d78338026fa47dca32eaf7f5c15eabb1b951aJan Zeleny prettyPrint();