mod_proxy.html.fr revision 2d39a41e98476f5235b7c37ce745a4aa0904b1cb
f072359f493a5209335799da85ac16d6a273303bgryzor<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
f072359f493a5209335799da85ac16d6a273303bgryzor<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
f072359f493a5209335799da85ac16d6a273303bgryzor XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
f072359f493a5209335799da85ac16d6a273303bgryzor This file is generated from xml source: DO NOT EDIT
f072359f493a5209335799da85ac16d6a273303bgryzor XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
f072359f493a5209335799da85ac16d6a273303bgryzor<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
f072359f493a5209335799da85ac16d6a273303bgryzor<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
f072359f493a5209335799da85ac16d6a273303bgryzor<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
f072359f493a5209335799da85ac16d6a273303bgryzor<link href="/images/favicon.ico" rel="shortcut icon" /></head>
f072359f493a5209335799da85ac16d6a273303bgryzor<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>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<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> > <a href="./">Modules</a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<p><span>Langues Disponibles: </span><a href="/en/mod/mod_proxy.html" hreflang="en" rel="alternate" title="English"> en </a> |
f072359f493a5209335799da85ac16d6a273303bgryzor<a href="/fr/mod/mod_proxy.html" title="Fran�ais"> fr </a> |
f072359f493a5209335799da85ac16d6a273303bgryzor<a href="/ja/mod/mod_proxy.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
f072359f493a5209335799da85ac16d6a273303bgryzor<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Serveur mandataire/passerelle HTTP/1.1</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>proxy_module</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_proxy.c</td></tr></table>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>N'activez pas la fonctionnalit� de mandataire avec la directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> avant
f072359f493a5209335799da85ac16d6a273303bgryzor d'avoir <a href="#access">s�curis� votre serveur</a>. Les serveurs
f072359f493a5209335799da85ac16d6a273303bgryzor mandataires ouverts sont dangereux pour votre r�seau,
f072359f493a5209335799da85ac16d6a273303bgryzor mais aussi pour l'Internet au sens large.</p>
48c64aeceef385e19025b384bd719b2a9789592dnd <p>Ce module impl�mente un mandataire/passerelle pour le serveur
48c64aeceef385e19025b384bd719b2a9789592dnd HTTP Apache. Il
f072359f493a5209335799da85ac16d6a273303bgryzor impl�mente la fonctionnalit� de mandataire pour <code>AJP13</code>
f072359f493a5209335799da85ac16d6a273303bgryzor (Apache JServe Protocol version 1.3), <code>FTP</code>,
f072359f493a5209335799da85ac16d6a273303bgryzor <code>CONNECT</code> (pour SSL), <code>HTTP/0.9</code>,
f072359f493a5209335799da85ac16d6a273303bgryzor <code>HTTP/1.0</code>, et <code>HTTP/1.1</code>. Le module peut �tre
f072359f493a5209335799da85ac16d6a273303bgryzor configur� pour se connecter aux autres modules mandataires qui
f072359f493a5209335799da85ac16d6a273303bgryzor g�rent ces protocoles ou d'autres.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Les diverses fonctionnalit�s de
48c64aeceef385e19025b384bd719b2a9789592dnd mandataire d'Apache httpd sont r�parties entre plusieurs modules
f072359f493a5209335799da85ac16d6a273303bgryzor compl�mentaires de <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> :
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code>, <code class="module"><a href="/mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>,
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="module"><a href="/mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code>, <code class="module"><a href="/mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code>,
f072359f493a5209335799da85ac16d6a273303bgryzor et <code class="module"><a href="/mod/mod_proxy_connect.html">mod_proxy_connect</a></code>. Ainsi, si vous voulez
f072359f493a5209335799da85ac16d6a273303bgryzor utiliser une ou plusieurs fonctionnalit�s de mandataire
f072359f493a5209335799da85ac16d6a273303bgryzor particuli�res, chargez <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> <em>et</em> le(s)
f072359f493a5209335799da85ac16d6a273303bgryzor module(s) appropri�(s) dans le serveur (soit statiquement � la
f072359f493a5209335799da85ac16d6a273303bgryzor compilation, soit dynamiquement via la directive <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code>).</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>En outre, d'autres modules fournissent des fonctionnalit�s
f072359f493a5209335799da85ac16d6a273303bgryzor �tendues. <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code> et ses modules associ�s
f072359f493a5209335799da85ac16d6a273303bgryzor fournissent la mise en cache. Les directives <code>SSLProxy*</code>
f072359f493a5209335799da85ac16d6a273303bgryzor du module <code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code> permettent de contacter des
f072359f493a5209335799da85ac16d6a273303bgryzor serveurs distants en utilisant le protocole SSL/TLS. Ces modules
f072359f493a5209335799da85ac16d6a273303bgryzor additionnels devront �tre charg�s et configur�s pour pouvoir
f072359f493a5209335799da85ac16d6a273303bgryzor disposer de ces fonctionnalit�s.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div id="quickview"><h3 class="directives">Directives</h3>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#balancermember">BalancerMember</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#noproxy">NoProxy</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxy"><Proxy></a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxybadheader">ProxyBadHeader</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyblock">ProxyBlock</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxydomain">ProxyDomain</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyerroroverride">ProxyErrorOverride</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyiobuffersize">ProxyIOBufferSize</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxymatch"><ProxyMatch></a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxymaxforwards">ProxyMaxForwards</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypass">ProxyPass</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypassinterpolateenv">ProxyPassInterpolateEnv</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypassmatch">ProxyPassMatch</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypassreverse">ProxyPassReverse</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypreservehost">ProxyPreserveHost</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyreceivebuffersize">ProxyReceiveBufferSize</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyremote">ProxyRemote</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyremotematch">ProxyRemoteMatch</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyrequests">ProxyRequests</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyset">ProxySet</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxystatus">ProxyStatus</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxytimeout">ProxyTimeout</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyvia">ProxyVia</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#forwardreverse">Mandataires directs et
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#examples">Exemples simples</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#access">Contr�ler l'acc�s � votre
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#startup">Ralentissement au d�marrage</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#intranet">Mandataire en Intranet</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#envsettings">Ajustements relatifs au
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#request-bodies">Corps de requ�tes</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#x-headers">En-t�tes de requ�te du mandataire
f072359f493a5209335799da85ac16d6a273303bgryzor<li><code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><code class="module"><a href="/mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><code class="module"><a href="/mod/mod_proxy_connect.html">mod_proxy_connect</a></code></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><code class="module"><a href="/mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<h2><a name="forwardreverse" id="forwardreverse">Mandataires directs et
48c64aeceef385e19025b384bd719b2a9789592dnd <p>Le serveur HTTP Apache peut �tre configur� dans les deux modes mandataire
f072359f493a5209335799da85ac16d6a273303bgryzor <dfn>direct</dfn> et mandataire <dfn>inverse</dfn> (aussi nomm�
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Un <dfn>mandataire direct</dfn> standard est un serveur
f072359f493a5209335799da85ac16d6a273303bgryzor interm�diaire qui s'intercale entre le client et le <em>serveur
f072359f493a5209335799da85ac16d6a273303bgryzor demand�</em>. Pour obtenir un contenu h�berg� par
f072359f493a5209335799da85ac16d6a273303bgryzor le serveur demand�, le client envoie une requ�te au
f072359f493a5209335799da85ac16d6a273303bgryzor mandataire en nommant le serveur demand� comme
f072359f493a5209335799da85ac16d6a273303bgryzor cible, puis le mandataire extrait le contenu depuis le
f072359f493a5209335799da85ac16d6a273303bgryzor serveur demand� et le renvoie enfin au client. Le client doit �tre
f072359f493a5209335799da85ac16d6a273303bgryzor configur� de mani�re appropri�e pour pouvoir utiliser le mandataire
f072359f493a5209335799da85ac16d6a273303bgryzor direct afin d'acc�der � d'autres sites.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>L'acc�s � Internet depuis des clients situ�s derri�re un
f072359f493a5209335799da85ac16d6a273303bgryzor pare-feu est une utilisation typique du mandataire direct. Le
f072359f493a5209335799da85ac16d6a273303bgryzor mandataire direct peut aussi utiliser la mise en cache (fournie
f072359f493a5209335799da85ac16d6a273303bgryzor par <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code>) pour r�duire la charge du
f072359f493a5209335799da85ac16d6a273303bgryzor r�seau.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>La fonctionnalit� de mandataire direct est activ�e via la
f072359f493a5209335799da85ac16d6a273303bgryzor directive <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code>.
f072359f493a5209335799da85ac16d6a273303bgryzor Comme les mandataires directs permettent aux clients d'acc�der �
f072359f493a5209335799da85ac16d6a273303bgryzor des sites quelconques via votre serveur et de dissimuler leur
f072359f493a5209335799da85ac16d6a273303bgryzor v�ritable origine, il est indispensable de <a href="#access">s�curiser votre serveur</a> de fa�on � ce que seuls
f072359f493a5209335799da85ac16d6a273303bgryzor les clients autoris�s puissent acc�der � votre serveur avant
f072359f493a5209335799da85ac16d6a273303bgryzor d'activer la fonctionnalit� de mandataire direct.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Un <dfn>mandataire inverse</dfn> (ou <dfn>passerelle</dfn>),
f072359f493a5209335799da85ac16d6a273303bgryzor quant � lui, appara�t au client comme un serveur web standard.
f072359f493a5209335799da85ac16d6a273303bgryzor Aucune configuration particuli�re du client n'est n�cessaire. Le
f072359f493a5209335799da85ac16d6a273303bgryzor client adresse ses demandes de contenus ordinaires dans l'espace
f072359f493a5209335799da85ac16d6a273303bgryzor de nommage du mandataire inverse. Ce dernier d�cide alors o�
f072359f493a5209335799da85ac16d6a273303bgryzor envoyer ces requ�tes, et renvoie le contenu au client comme s'il
f072359f493a5209335799da85ac16d6a273303bgryzor l'h�bergeait lui-m�me.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>L'acc�s d'utilisateurs depuis Internet vers un serveur situ�
f072359f493a5209335799da85ac16d6a273303bgryzor derri�re un pare-feu est une utilisation typique du mandataire
f072359f493a5209335799da85ac16d6a273303bgryzor inverse. On peut aussi utiliser les mandataires inverses pour
f072359f493a5209335799da85ac16d6a273303bgryzor mettre en oeuvre une r�partition de charge entre plusieurs
f072359f493a5209335799da85ac16d6a273303bgryzor serveurs en arri�re-plan, ou fournir un cache pour un serveur
f072359f493a5209335799da85ac16d6a273303bgryzor d'arri�re-plan plus lent. Les mandataires inverses peuvent aussi
f072359f493a5209335799da85ac16d6a273303bgryzor tout simplement servir � rassembler plusieurs serveurs dans le
f072359f493a5209335799da85ac16d6a273303bgryzor m�me espace de nommage d'URLs.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>La fonctionnalit� de mandataire inverse est activ�e via la
f072359f493a5209335799da85ac16d6a273303bgryzor directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> ou
f072359f493a5209335799da85ac16d6a273303bgryzor le drapeau <code>[P]</code> de la directive <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>. Il n'est
f072359f493a5209335799da85ac16d6a273303bgryzor <strong>pas</strong> n�cessaire de d�finir <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> pour configurer
f072359f493a5209335799da85ac16d6a273303bgryzor un mandataire inverse.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<h2><a name="examples" id="examples">Exemples simples</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Les exemples ci-dessous illustrent de mani�re tr�s basique la
f072359f493a5209335799da85ac16d6a273303bgryzor mise en oeuvre de la fonctionnalit� de mandataire et ne sont l� que
f072359f493a5209335799da85ac16d6a273303bgryzor pour vous aider � d�marrer. Reportez-vous � la documentation de
f072359f493a5209335799da85ac16d6a273303bgryzor chaque directive.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Si en outre, vous d�sirez activer la mise en cache, consultez la
f072359f493a5209335799da85ac16d6a273303bgryzor documentation de <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code>.</p>
2d39a41e98476f5235b7c37ce745a4aa0904b1cbrbowen <div class="example"><h3>Mandataire inverse</h3><p><code>
2d39a41e98476f5235b7c37ce745a4aa0904b1cbrbowen ProxyPassReverse /foo http://foo.example.com/bar
f072359f493a5209335799da85ac16d6a273303bgryzor <div class="example"><h3>Mandataire direct</h3><p><code>
f072359f493a5209335799da85ac16d6a273303bgryzor ProxyRequests On<br />
f072359f493a5209335799da85ac16d6a273303bgryzor ProxyVia On<br />
f072359f493a5209335799da85ac16d6a273303bgryzor <Proxy *><br />
f072359f493a5209335799da85ac16d6a273303bgryzor Order deny,allow<br />
f072359f493a5209335799da85ac16d6a273303bgryzor Deny from all<br />
f072359f493a5209335799da85ac16d6a273303bgryzor </Proxy>
f072359f493a5209335799da85ac16d6a273303bgryzor </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<h2><a name="access" id="access">Contr�ler l'acc�s � votre
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Vous pouvez restreindre l'acc�s � votre mandataire via le bloc
f072359f493a5209335799da85ac16d6a273303bgryzor de contr�le <code class="directive"><a href="#proxy"><Proxy></a></code> comme dans
f072359f493a5209335799da85ac16d6a273303bgryzor l'exemple suivant :</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <Proxy *><br />
f072359f493a5209335799da85ac16d6a273303bgryzor Order Deny,Allow<br />
f072359f493a5209335799da85ac16d6a273303bgryzor Deny from all<br />
f072359f493a5209335799da85ac16d6a273303bgryzor Allow from 192.168.0<br />
f072359f493a5209335799da85ac16d6a273303bgryzor </Proxy>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Pour plus de d�tails sur les directives de contr�le d'acc�s,
f072359f493a5209335799da85ac16d6a273303bgryzor voir la documentation du module
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Restreindre l'acc�s de mani�re stricte est essentiel si vous
f072359f493a5209335799da85ac16d6a273303bgryzor mettez en oeuvre un mandataire direct (en d�finissant la directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> � "on").
f072359f493a5209335799da85ac16d6a273303bgryzor Dans le cas contraire, votre serveur pourrait �tre utilis� par
f072359f493a5209335799da85ac16d6a273303bgryzor n'importe quel client pour acc�der � des serveurs quelconques,
f072359f493a5209335799da85ac16d6a273303bgryzor tout en masquant sa v�ritable identit�. Ceci repr�sente un danger
f072359f493a5209335799da85ac16d6a273303bgryzor non seulement pour votre r�seau, mais aussi pour l'Internet au
f072359f493a5209335799da85ac16d6a273303bgryzor sens large. Dans le cas de la mise en oeuvre d'un mandataire
f072359f493a5209335799da85ac16d6a273303bgryzor inverse (en d�finissant la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> � "off"), le contr�le
f072359f493a5209335799da85ac16d6a273303bgryzor d'acc�s est moins critique car les clients ne peuvent contacter
f072359f493a5209335799da85ac16d6a273303bgryzor que les serveurs que vous avez sp�cifi�s.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p><strong>Voir aussi</strong> la variable d'environnement <a href="mod_proxy_http.html#env">Proxy-Chain-Auth</a>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<h2><a name="startup" id="startup">Ralentissement au d�marrage</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Si vous utilisez la directive <code class="directive"><a href="#proxyblock">ProxyBlock</a></code>, les noms d'h�tes sont r�solus en adresses
f072359f493a5209335799da85ac16d6a273303bgryzor IP puis ces derni�res mises en cache au cours du d�marrage
f072359f493a5209335799da85ac16d6a273303bgryzor � des fins de tests de comparaisons ult�rieurs. Ce processus peut
f072359f493a5209335799da85ac16d6a273303bgryzor durer plusieurs secondes (ou d'avantage) en fonction de la vitesse
f072359f493a5209335799da85ac16d6a273303bgryzor � laquelle s'effectue la r�solution des noms d'h�tes.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<h2><a name="intranet" id="intranet">Mandataire en Intranet</a></h2>
48c64aeceef385e19025b384bd719b2a9789592dnd <p>Un serveur mandataire Apache httpd situ� � l'int�rieur d'un Intranet
f072359f493a5209335799da85ac16d6a273303bgryzor doit faire suivre les requ�tes destin�es � un serveur externe �
f072359f493a5209335799da85ac16d6a273303bgryzor travers le pare-feu de l'entreprise (pour ce faire, d�finissez la
f072359f493a5209335799da85ac16d6a273303bgryzor directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code> de
f072359f493a5209335799da85ac16d6a273303bgryzor fa�on � ce qu'elle fasse suivre le <var>protocole</var> concern�
f072359f493a5209335799da85ac16d6a273303bgryzor vers le mandataire du pare-feu). Cependant, lorsqu'il doit acc�der
f072359f493a5209335799da85ac16d6a273303bgryzor � des ressources situ�es dans l'Intranet, il peut se passer du
f072359f493a5209335799da85ac16d6a273303bgryzor pare-feu pour acc�der aux serveurs. A cet effet, la directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive"><a href="#noproxy">NoProxy</a></code> permet de
f072359f493a5209335799da85ac16d6a273303bgryzor sp�cifier quels h�tes appartiennent � l'Intranet et peuvent donc
f072359f493a5209335799da85ac16d6a273303bgryzor �tre acc�d�s directement.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Les utilisateurs d'un Intranet ont tendance � oublier le nom du
f072359f493a5209335799da85ac16d6a273303bgryzor domaine local dans leurs requ�tes WWW, et demandent par exemple
eef716e54c415709ca9d53aad4678bf9d96186e6nd <code>http://un-serveur.example.com/</code>. Certains serveurs
f072359f493a5209335799da85ac16d6a273303bgryzor mandataires commerciaux acceptent ce genre de requ�te et les
f072359f493a5209335799da85ac16d6a273303bgryzor traitent simplement en utilisant un nom de domaine local
f072359f493a5209335799da85ac16d6a273303bgryzor implicite. Lorsque la directive <code class="directive"><a href="#proxydomain">ProxyDomain</a></code> est utilis�e et si le
48c64aeceef385e19025b384bd719b2a9789592dnd mandataire</a>, Apache httpd peut renvoyer une r�ponse de redirection et
f072359f493a5209335799da85ac16d6a273303bgryzor ainsi fournir au client l'adresse de serveur correcte,
f072359f493a5209335799da85ac16d6a273303bgryzor enti�rement qualifi�e. C'est la m�thode � privil�gier car le
f072359f493a5209335799da85ac16d6a273303bgryzor fichier des marque-pages de l'utilisateur contiendra alors des
f072359f493a5209335799da85ac16d6a273303bgryzor noms de serveurs enti�rement qualifi�s.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<h2><a name="envsettings" id="envsettings">Ajustements relatifs au
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Pour les cas o� <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> envoie des requ�tes
f072359f493a5209335799da85ac16d6a273303bgryzor vers un serveur qui n'impl�mente pas correctement les connexions
f072359f493a5209335799da85ac16d6a273303bgryzor persistantes ou le protocole HTTP/1.1, il existe deux variables
f072359f493a5209335799da85ac16d6a273303bgryzor d'environnement qui permettent de forcer les requ�tes � utiliser
f072359f493a5209335799da85ac16d6a273303bgryzor le protocole HTTP/1.0 avec connexions non persistantes. Elles
f072359f493a5209335799da85ac16d6a273303bgryzor peuvent �tre d�finies via la directive <code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Il s'agit des variables <code>force-proxy-request-1.0</code> et
f072359f493a5209335799da85ac16d6a273303bgryzor <Location /serveur-non-conforme/><br />
f072359f493a5209335799da85ac16d6a273303bgryzor ProxyPass http://serveur-non-conforme:7001/foo/<br />
f072359f493a5209335799da85ac16d6a273303bgryzor SetEnv force-proxy-request-1.0 1<br />
f072359f493a5209335799da85ac16d6a273303bgryzor SetEnv proxy-nokeepalive 1<br />
f072359f493a5209335799da85ac16d6a273303bgryzor </Location>
f072359f493a5209335799da85ac16d6a273303bgryzor </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<h2><a name="request-bodies" id="request-bodies">Corps de requ�tes</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Certaines m�thodes de requ�tes comme POST comportent un corps de
f072359f493a5209335799da85ac16d6a273303bgryzor requ�te. Le protocole HTTP stipule que les requ�tes qui comportent
f072359f493a5209335799da85ac16d6a273303bgryzor un corps doivent soit utiliser un codage de transmission
f072359f493a5209335799da85ac16d6a273303bgryzor fractionn�e (chunked transfer encoding), soit envoyer un en-t�te de requ�te
f072359f493a5209335799da85ac16d6a273303bgryzor <code>Content-Length</code>. Lorsqu'il fait suivre ce genre de
f072359f493a5209335799da85ac16d6a273303bgryzor requ�te vers le serveur demand�, <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code>
f072359f493a5209335799da85ac16d6a273303bgryzor s'efforce toujours d'envoyer l'en-t�te <code>Content-Length</code>.
f072359f493a5209335799da85ac16d6a273303bgryzor Par contre, si la taille du corps est importante, et si la requ�te
f072359f493a5209335799da85ac16d6a273303bgryzor originale utilise un codage � fractionnement, ce dernier peut aussi
f072359f493a5209335799da85ac16d6a273303bgryzor �tre utilis� dans la requ�te montante. Ce comportement peut �tre
f072359f493a5209335799da85ac16d6a273303bgryzor d'environnement</a>. Ainsi, si elle est d�finie, la variable
f072359f493a5209335799da85ac16d6a273303bgryzor <code>proxy-sendcl</code> assure une compatibilit� maximale avec les
f072359f493a5209335799da85ac16d6a273303bgryzor serveurs demand�s en imposant l'envoi de l'en-t�te
f072359f493a5209335799da85ac16d6a273303bgryzor <code>proxy-sendchunked</code> diminue la consommation de ressources
f072359f493a5209335799da85ac16d6a273303bgryzor en imposant l'utilisation d'un codage � fractionnement.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<h2><a name="x-headers" id="x-headers">En-t�tes de requ�te du mandataire
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Lorsqu'il est configur� en mode mandataire inverse (en utilisant
f072359f493a5209335799da85ac16d6a273303bgryzor par exemple la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>),
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code> ajoute plusieurs en-t�tes de requ�te
f072359f493a5209335799da85ac16d6a273303bgryzor afin de transmettre des informations au serveur demand�. Ces
f072359f493a5209335799da85ac16d6a273303bgryzor en-t�tes sont les suivants :</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <dd>L'h�te d'origine demand� par le client dans l'en-t�te de
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Ces en-t�tes doivent �tre utilis�s avec pr�cautions sur le
f072359f493a5209335799da85ac16d6a273303bgryzor serveur demand�, car ils contiendront plus d'une valeur (s�par�es
f072359f493a5209335799da85ac16d6a273303bgryzor par des virgules) si la requ�te originale contenait d�j� un de ces
f072359f493a5209335799da85ac16d6a273303bgryzor en-t�tes. Par exemple, vous pouvez utiliser
f072359f493a5209335799da85ac16d6a273303bgryzor <code>%{X-Forwarded-For}i</code> dans la cha�ne de format du journal
f072359f493a5209335799da85ac16d6a273303bgryzor du serveur demand� pour enregistrer les adresses IP des clients
f072359f493a5209335799da85ac16d6a273303bgryzor originaux, mais il est possible que vous obteniez plusieurs adresses
f072359f493a5209335799da85ac16d6a273303bgryzor si la requ�te passe � travers plusieurs mandataires.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Voir aussi les directives <code class="directive"><a href="#proxypreservehost">ProxyPreserveHost</a></code> et <code class="directive"><a href="#proxyvia">ProxyVia</a></code> directives, qui permettent
f072359f493a5209335799da85ac16d6a273303bgryzor de contr�ler d'autres en-t�tes de requ�te.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="BalancerMember" id="BalancerMember">BalancerMember</a> <a name="balancermember" id="balancermember">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un membre � un groupe de r�partition de
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BalancerMember [<var>balancerurl</var>] <var>url</var> [<var>cl�=valeur [cl�=valeur ...]]</var></code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
48c64aeceef385e19025b384bd719b2a9789592dnd<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.2 du serveur HTTP Apache.</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive parmet d'ajouter un membre � un groupe de
f072359f493a5209335799da85ac16d6a273303bgryzor r�partition de charge. Elle peut se trouver dans un conteneur
f072359f493a5209335799da85ac16d6a273303bgryzor <code><Proxy <var>balancer://</var>...></code>, et accepte
f072359f493a5209335799da85ac16d6a273303bgryzor tous les param�tres de paires cl�/valeur que supporte la directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>La directive <code class="directive"><a href="#balancermember">BalancerMember</a></code> accepte un param�tre
f072359f493a5209335799da85ac16d6a273303bgryzor suppl�mentaire : <var>loadfactor</var>. Il s'agit du facteur de
f072359f493a5209335799da85ac16d6a273303bgryzor charge du membre - un nombre entre 1 (valeur par d�faut) et 100, qui
f072359f493a5209335799da85ac16d6a273303bgryzor d�finit la charge � appliquer au membre en question.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>L'argument balancerurl n'est requis que s'il ne se trouve pas
f072359f493a5209335799da85ac16d6a273303bgryzor d�j� dans la directive de conteneur <code><Proxy
f072359f493a5209335799da85ac16d6a273303bgryzor <var>balancer://</var>...></code>. Il correspond � l'URL d'un
f072359f493a5209335799da85ac16d6a273303bgryzor r�partiteur de charge d�fini par une directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="NoProxy" id="NoProxy">NoProxy</a> <a name="noproxy" id="noproxy">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Serveurs, domaines ou r�seaux auquels on se connectera
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NoProxy <var>domaine</var> [<var>domaine</var>] ...</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive n'a d'utilit� que pour les serveurs mandataires
48c64aeceef385e19025b384bd719b2a9789592dnd Apache httpd au sein d'Intranets. La directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive">NoProxy</code> permet de sp�cifier une liste de
f072359f493a5209335799da85ac16d6a273303bgryzor sous-r�seaux, d'adresses IP, de serveurs et/ou de domaines s�par�s
f072359f493a5209335799da85ac16d6a273303bgryzor par des espaces. Une requ�te pour un serveur qui correspond � un ou
f072359f493a5209335799da85ac16d6a273303bgryzor plusieurs crit�res sera toujours servie par ce serveur directement,
f072359f493a5209335799da85ac16d6a273303bgryzor sans �tre redirig�e vers le(s) serveur(s) mandataire(s) d�fini(s) par
f072359f493a5209335799da85ac16d6a273303bgryzor la directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Le type des arguments <var>serveur</var> de la directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive">NoProxy</code> appartiennent � la liste suivante
f072359f493a5209335799da85ac16d6a273303bgryzor <dt><var><a name="domain" id="domain">Domaine</a></var></dt>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Un <dfn>domaine</dfn> est ici un nom de domaine DNS partiellement
f072359f493a5209335799da85ac16d6a273303bgryzor qualifi� pr�c�d� d'un point. Il repr�sente une liste de serveurs qui
f072359f493a5209335799da85ac16d6a273303bgryzor appartiennent logiquement au m�me domaine ou � la m�me zonz DNS
f072359f493a5209335799da85ac16d6a273303bgryzor (en d'autres termes, les nom des serveurs se terminent tous par
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Pour faire la distinction entre <var>domaine</var>s et <var><a href="#hostname">nom d'h�te</a></var>s (des points de vue � la fois
f072359f493a5209335799da85ac16d6a273303bgryzor syntaxique et
f072359f493a5209335799da85ac16d6a273303bgryzor s�mantique, un domaine DNS pouvant aussi avoir un enregistrement DNS
f072359f493a5209335799da85ac16d6a273303bgryzor de type A !), les <var>domaine</var>s sont toujours sp�cifi�s en les
f072359f493a5209335799da85ac16d6a273303bgryzor pr�fixant par un point.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Les comparaisons de noms de domaines s'effectuent sans tenir
f072359f493a5209335799da85ac16d6a273303bgryzor compte de la casse, et les parties droites des <var>Domaine</var>s
f072359f493a5209335799da85ac16d6a273303bgryzor sont toujours cens�es correspondre � la racine de l'arborescence
e797af4d7b0cada1278d72d6c8ac77210ef78632minfrin DNS, si bien que les domaines <code>.ExEmple.com</code> et
eef716e54c415709ca9d53aad4678bf9d96186e6nd <code>.example.com.</code> (notez le point � la fin du nom) sont
f072359f493a5209335799da85ac16d6a273303bgryzor consid�r�s comme identiques. Comme une comparaison de domaines ne
f072359f493a5209335799da85ac16d6a273303bgryzor n�cessite pas de recherche DNS, elle est beaucoup plus efficace
f072359f493a5209335799da85ac16d6a273303bgryzor qu'une comparaison de sous-r�seaux.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <dt><var><a name="subnet" id="subnet">Sous-r�seau</a></var></dt>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Un <dfn>Sous-r�seau</dfn> est une adresse internet partiellement
f072359f493a5209335799da85ac16d6a273303bgryzor qualifi�e sous forme num�rique (quatre nombres s�par�s par des
f072359f493a5209335799da85ac16d6a273303bgryzor points), optionnellement suivie d'un slash et du masque de
f072359f493a5209335799da85ac16d6a273303bgryzor sous-r�seau sp�cifiant le nombre de bits significatifs dans le
f072359f493a5209335799da85ac16d6a273303bgryzor <var>Sous-r�seau</var>. Il repr�sente un sous-r�seau de serveurs qui
f072359f493a5209335799da85ac16d6a273303bgryzor peuvent �tre atteints depuis la m�me interface r�seau. En l'absence
f072359f493a5209335799da85ac16d6a273303bgryzor de masque de sous-r�seau explicite, il est sous-entendu que les
f072359f493a5209335799da85ac16d6a273303bgryzor digits manquants (ou caract�res 0) de fin sp�cifient le masque de
f072359f493a5209335799da85ac16d6a273303bgryzor sous-r�seau (Dans ce cas, le masque de sous-r�seau ne peut �tre
f072359f493a5209335799da85ac16d6a273303bgryzor qu'un multiple de 8). Voici quelques exemples :</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <dt><code>192.168</code> ou <code>192.168.0.0</code></dt>
f072359f493a5209335799da85ac16d6a273303bgryzor <dd>le sous-r�seau 192.168.0.0 avec un masque de sous-r�seau
f072359f493a5209335799da85ac16d6a273303bgryzor implicite de 16 bits significatifs (parfois exprim� sous la forme
f072359f493a5209335799da85ac16d6a273303bgryzor <dd>le sous-r�seau <code>192.168.112.0/21</code> avec un masque de
f072359f493a5209335799da85ac16d6a273303bgryzor sous-r�seau implicite de 21 bits significatifs (parfois exprim�
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Comme cas extr�mes, un <em>Sous-r�seau</em> avec un masque de
f072359f493a5209335799da85ac16d6a273303bgryzor sous-r�seau de 32 bits significatifs est �quivalent � une <var><a href="#ipadr">adresse IP</a></var>, alors qu'un <em>Sous-r�seau</em> avec un masque de
f072359f493a5209335799da85ac16d6a273303bgryzor sous-r�seau de 0 bit significatif (c'est � dire 0.0.0.0/0) est
f072359f493a5209335799da85ac16d6a273303bgryzor identique � la constante <var>_Default_</var>, et peut correspondre
f072359f493a5209335799da85ac16d6a273303bgryzor <dt><var><a name="ipaddr" id="ipaddr">Adresse IP</a></var></dt>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Une <dfn>Adresse IP</dfn> est une adresse internet pleinement
f072359f493a5209335799da85ac16d6a273303bgryzor qualifi�e sous forme num�rique (quatre nombres s�par�s par des
f072359f493a5209335799da85ac16d6a273303bgryzor points). En g�n�ral, cette adresse repr�sente un serveur, mais elle
f072359f493a5209335799da85ac16d6a273303bgryzor ne doit pas n�cessairement correspondre � un nom de domaine DNS.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor 192.168.123.7
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Une <dfn>Adresse IP</dfn> ne n�cessite pas de r�solution DNS,
f072359f493a5209335799da85ac16d6a273303bgryzor et peut ainsi s'av�rer plus efficace quant aux performances
f072359f493a5209335799da85ac16d6a273303bgryzor d'Apache.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <dt><var><a name="hostname" id="hostname">Nom de serveur</a></var></dt>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Un <dfn>Nom de serveur</dfn> est un nom de domaine DNS pleinement
f072359f493a5209335799da85ac16d6a273303bgryzor qualifi� qui peut �tre r�solu en une ou plusieurs adresses IP par le
f072359f493a5209335799da85ac16d6a273303bgryzor service de noms de domaines DNS. Il repr�sente un h�te logique (par
f072359f493a5209335799da85ac16d6a273303bgryzor opposition aux <var><a href="#domain">Domaine</a></var>s, voir
f072359f493a5209335799da85ac16d6a273303bgryzor ci-dessus), et doit pouvoir �tre r�solu en une ou plusieurs <var><a href="#ipaddr">adresses IP</a></var> (ou souvent en une liste
f072359f493a5209335799da85ac16d6a273303bgryzor d'h�tes avec diff�rentes <var><a href="#ipaddr">adresses
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Dans de nombreuses situations, il est plus efficace de
f072359f493a5209335799da85ac16d6a273303bgryzor sp�cifier une <var><a href="#ipaddr">adresse IP</a></var> qu'un
f072359f493a5209335799da85ac16d6a273303bgryzor <var>Nom de serveur</var> car cela �vite d'avoir � effectuer une
48c64aeceef385e19025b384bd719b2a9789592dnd recherche DNS. La r�solution de nom dans Apache httpd peut prendre un
f072359f493a5209335799da85ac16d6a273303bgryzor temps tr�s long lorsque la connexion avec le serveur de noms
f072359f493a5209335799da85ac16d6a273303bgryzor utilise une liaison PPP lente.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Les comparaisons de <var>Nom de serveur</var> s'effectuent sans tenir
f072359f493a5209335799da85ac16d6a273303bgryzor compte de la casse, et les parties droites des <var>Noms de serveur</var>
f072359f493a5209335799da85ac16d6a273303bgryzor sont toujours cens�es correspondre � la racine de l'arborescence
e797af4d7b0cada1278d72d6c8ac77210ef78632minfrin DNS, si bien que les domaines <code>WWW.ExEmple.com</code> et
eef716e54c415709ca9d53aad4678bf9d96186e6nd <code>www.example.com.</code> (notez le point � la fin du nom) sont
f072359f493a5209335799da85ac16d6a273303bgryzor consid�r�s comme identiques.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><a href="/dns-caveats.html">Probl�mes li�s au DNS</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="Proxy" id="Proxy"><Proxy></a> <a name="proxy" id="proxy">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Conteneur de directives s'appliquant � des ressources
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Proxy <var>url-avec-jokers</var>> ...</Proxy></code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Les directives situ�es dans une section <code class="directive"><Proxy></code> ne s'appliquent qu'au contenu
f072359f493a5209335799da85ac16d6a273303bgryzor mandat� concern�. Les jokers de style shell sont autoris�s.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Par exemple, les lignes suivantes n'autoriseront � acc�der � un
f072359f493a5209335799da85ac16d6a273303bgryzor contenu via votre serveur mandataire que les h�tes appartenant �
f072359f493a5209335799da85ac16d6a273303bgryzor <Proxy *><br />
f072359f493a5209335799da85ac16d6a273303bgryzor Order Deny,Allow<br />
f072359f493a5209335799da85ac16d6a273303bgryzor Deny from all<br />
f072359f493a5209335799da85ac16d6a273303bgryzor </Proxy>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Dans l'exemple suivant, tous les fichiers du r�pertoire
eef716e54c415709ca9d53aad4678bf9d96186e6nd <code>foo</code> de <code>example.com</code> seront trait�s par le
f072359f493a5209335799da85ac16d6a273303bgryzor filtre <code>INCLUDES</code> lorsqu'ils seront envoy�s par
f072359f493a5209335799da85ac16d6a273303bgryzor l'interm�diaire du serveur mandataire :</p>
f072359f493a5209335799da85ac16d6a273303bgryzor SetOutputFilter INCLUDES<br />
f072359f493a5209335799da85ac16d6a273303bgryzor </Proxy>
7cc5e8f14e6ab2d8b60bb0eaba4b68b00d320b29nd<li><code class="directive"><a href="#proxymatch"><ProxyMatch></a></code></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyBadHeader" id="ProxyBadHeader">ProxyBadHeader</a> <a name="proxybadheader" id="proxybadheader">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�termine la mani�re de traiter les lignes d'en-t�te
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyBadHeader IsError|Ignore|StartBody</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyBadHeader IsError</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
48c64aeceef385e19025b384bd719b2a9789592dnd<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.0.44 du serveur HTTP Apache</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>La directive <code class="directive">ProxyBadHeader</code> permet de
f072359f493a5209335799da85ac16d6a273303bgryzor d�terminer le comportement de <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> lorsqu'il
f072359f493a5209335799da85ac16d6a273303bgryzor re�oit des lignes d'en-t�te dont la syntaxe n'est pas valide (c'est
f072359f493a5209335799da85ac16d6a273303bgryzor � dire ne contenant pas de caract�re ':'). Les arguments disponibles
f072359f493a5209335799da85ac16d6a273303bgryzor <dd>Annule la requ�te et renvoie une r�ponse de code 502 (mauvaise
f072359f493a5209335799da85ac16d6a273303bgryzor passerelle). C'est le comportement par d�faut.</dd>
f072359f493a5209335799da85ac16d6a273303bgryzor <dd>Traite les lignes d'en-t�te incorrectes comme si elles n'avaient
f072359f493a5209335799da85ac16d6a273303bgryzor pas �t� envoy�es.</dd>
f072359f493a5209335799da85ac16d6a273303bgryzor <dd>A la r�ception de la premi�re ligne d'en-t�te incorrecte, les
f072359f493a5209335799da85ac16d6a273303bgryzor autres en-t�tes sont lus et ce qui reste est trait� en tant que
f072359f493a5209335799da85ac16d6a273303bgryzor corps. Ceci facilite la prise en compte des serveurs d'arri�re-plan
f072359f493a5209335799da85ac16d6a273303bgryzor bogu�s qui oublient d'ins�rer une ligne vide entre les
f072359f493a5209335799da85ac16d6a273303bgryzor en-t�tes et le corps.</dd>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyBlock" id="ProxyBlock">ProxyBlock</a> <a name="proxyblock" id="proxyblock">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Termes, serveurs ou domaines bloqu�s par le
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyBlock *|<var>terme</var>|<var>serveur</var>|<var>domaine</var>
f072359f493a5209335799da85ac16d6a273303bgryzor[<var>terme</var>|<var>serveur</var>|<var>domaine</var>] ...</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>La directive <code class="directive">ProxyBlock</code> permet de
f072359f493a5209335799da85ac16d6a273303bgryzor sp�cifier une liste de termes, serveurs et/ou domaines, s�par�s par
f072359f493a5209335799da85ac16d6a273303bgryzor des espaces. Les requ�tes de documents HTTP, HTTPS, FTP vers des
f072359f493a5209335799da85ac16d6a273303bgryzor sites dont les noms contiennent des termes, noms de serveur ou
f072359f493a5209335799da85ac16d6a273303bgryzor domaine correspondants seront <em>bloqu�s</em> par le serveur
f072359f493a5209335799da85ac16d6a273303bgryzor mandataire. La module proxy va aussi tenter de d�terminer les
f072359f493a5209335799da85ac16d6a273303bgryzor adresses IP des �l�ments de la liste qui peuvent correspondre � des
f072359f493a5209335799da85ac16d6a273303bgryzor noms d'h�tes au cours du d�marrage, et les mettra en cache � des
f072359f493a5209335799da85ac16d6a273303bgryzor fins de comparaisons ult�rieures. Ceci peut ralentir le d�marrage du
f072359f493a5209335799da85ac16d6a273303bgryzor serveur.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor ProxyBlock joes-garage.com some-host.co.uk rocky.wotsamattau.edu
f072359f493a5209335799da85ac16d6a273303bgryzor <p><code>rocky.wotsamattau.edu</code> aurait �galement correspondu s'il
f072359f493a5209335799da85ac16d6a273303bgryzor avait �t� sp�cifi� par son adresse IP.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Notez que <code>wotsamattau</code> aurait suffi pour correspondre
f072359f493a5209335799da85ac16d6a273303bgryzor ProxyBlock *
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyDomain" id="ProxyDomain">ProxyDomain</a> <a name="proxydomain" id="proxydomain">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom de domaine par d�faut pour les requ�tes
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyDomain <var>Domaine</var></code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive n'a d'utilit� que pour les serveurs mandataires
48c64aeceef385e19025b384bd719b2a9789592dnd Apache httpd au sein d'un Intranet. La directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive">ProxyDomain</code> permet de sp�cifier le domaine
f072359f493a5209335799da85ac16d6a273303bgryzor par d�faut auquel le serveur mandataire apache appartient. Si le
f072359f493a5209335799da85ac16d6a273303bgryzor serveur re�oit une requ�te pour un h�te sans nom de domaine, il va
f072359f493a5209335799da85ac16d6a273303bgryzor g�n�rer une r�ponse de redirection vers le m�me h�te suffix� par le
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyErrorOverride" id="ProxyErrorOverride">ProxyErrorOverride</a> <a name="proxyerroroverride" id="proxyerroroverride">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Outrepasser les pages d'erreur pour les contenus
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyErrorOverride On|Off</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyErrorOverride Off</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.0 d'Apache</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive est utile pour les configurations de mandataires
f072359f493a5209335799da85ac16d6a273303bgryzor inverses, lorsque vous souhaitez que les pages d'erreur envoy�es
f072359f493a5209335799da85ac16d6a273303bgryzor aux utilisateurs finaux pr�sentent un aspect homog�ne. Elle permet
f072359f493a5209335799da85ac16d6a273303bgryzor aussi l'inclusion de fichiers (via les SSI de
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>) pour obtenir le code d'erreur et agir
f072359f493a5209335799da85ac16d6a273303bgryzor en cons�quence (le comportement par d�faut afficherait la page
f072359f493a5209335799da85ac16d6a273303bgryzor d'erreur du serveur mandat�, alors que c'est le message d'erreur SSI
f072359f493a5209335799da85ac16d6a273303bgryzor qui sera affich� si cette directive est � "on").</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive n'affecte pas le traitement des r�ponses
f072359f493a5209335799da85ac16d6a273303bgryzor informatives (1xx), de type succ�s normal (2xx), ou de redirection
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyIOBufferSize" id="ProxyIOBufferSize">ProxyIOBufferSize</a> <a name="proxyiobuffersize" id="proxyiobuffersize">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�termine la taille du tampon interne de transfert de
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyIOBufferSize <var>octets</var></code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyIOBufferSize 8192</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>La directive <code class="directive">ProxyIOBufferSize</code> permet
f072359f493a5209335799da85ac16d6a273303bgryzor d'ajuster la taille du tampon interne utilis� comme bloc-note pour
f072359f493a5209335799da85ac16d6a273303bgryzor les transferts de donn�es entre entr�e et sortie. La taille minimale
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Dans la plupart des cas, il n'y a aucune raison de modifier cette
f072359f493a5209335799da85ac16d6a273303bgryzor valeur.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Si elle est utilis�e avec AJP, cette directive permet de d�finir
f072359f493a5209335799da85ac16d6a273303bgryzor la taille maximale du paquet AJP en octets. Si vous ne conservez pas
f072359f493a5209335799da85ac16d6a273303bgryzor la valeur par d�faut, vous devez aussi modifier l'attribut
f072359f493a5209335799da85ac16d6a273303bgryzor <code>packetSize</code> de votre connecteur AJP du c�t� de Tomcat !
f072359f493a5209335799da85ac16d6a273303bgryzor L'attribut <code>packetSize</code> n'est disponible que dans Tomcat
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Il n'est normalement pas n�cessaire de modifier la taille
f072359f493a5209335799da85ac16d6a273303bgryzor maximale du paquet. Des probl�mes ont cependant �t� rapport�s avec
f072359f493a5209335799da85ac16d6a273303bgryzor la valeur par d�faut lors de l'envoi de certificats ou de cha�nes de
f072359f493a5209335799da85ac16d6a273303bgryzor certificats.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyMatch" id="ProxyMatch"><ProxyMatch></a> <a name="proxymatch" id="proxymatch">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Conteneur de directives s'appliquant � des ressources
f072359f493a5209335799da85ac16d6a273303bgryzormandat�es correspondant � une expression rationnelle</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><ProxyMatch <var>regex</var>> ...</ProxyMatch></code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>La directive <code class="directive"><ProxyMatch></code> est
f072359f493a5209335799da85ac16d6a273303bgryzor identique � la directive <code class="directive"><a href="#proxy"><Proxy></a></code>, � l'exception qu'elle d�finit
f072359f493a5209335799da85ac16d6a273303bgryzor les URLs auxquelles elle s'applique en utilisant une <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression rationnelle</a>.</p>
7cc5e8f14e6ab2d8b60bb0eaba4b68b00d320b29nd<li><code class="directive"><a href="#proxy"><Proxy></a></code></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyMaxForwards" id="ProxyMaxForwards">ProxyMaxForwards</a> <a name="proxymaxforwards" id="proxymaxforwards">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de mandataires � travers lesquelles une
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyMaxForwards <var>nombre</var></code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyMaxForwards -1</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
48c64aeceef385e19025b384bd719b2a9789592dnd<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.0 du serveur HTTP Apache ; comportement par d�faut
f072359f493a5209335799da85ac16d6a273303bgryzor <p>La directive <code class="directive">ProxyMaxForwards</code> permet de
f072359f493a5209335799da85ac16d6a273303bgryzor sp�cifier le nombre maximum de mandataires � travers lesquels une
f072359f493a5209335799da85ac16d6a273303bgryzor requ�te peut passer dans le cas o� la la requ�te ne contient pas
f072359f493a5209335799da85ac16d6a273303bgryzor d'en-t�te <code>Max-Forwards</code>. Ceci permet de se pr�munir
f072359f493a5209335799da85ac16d6a273303bgryzor contre les boucles infinies de mandataires ou contre les attaques de
f072359f493a5209335799da85ac16d6a273303bgryzor type d�ni de service.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor ProxyMaxForwards 15
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Notez que la d�finition de la directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive">ProxyMaxForwards</code> constitue une violation du
f072359f493a5209335799da85ac16d6a273303bgryzor protocole HTTP/1.1 (RFC2616), qui interdit � un mandataire de
f072359f493a5209335799da85ac16d6a273303bgryzor d�finir <code>Max-Forwards</code> si le client ne l'a pas fait
48c64aeceef385e19025b384bd719b2a9789592dnd lui-m�me. Les versions pr�c�dentes d'Apache httpd la d�finissaient
f072359f493a5209335799da85ac16d6a273303bgryzor syst�matiquement. Une valeur n�gative de
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive">ProxyMaxForwards</code>, y compris la valeur par
f072359f493a5209335799da85ac16d6a273303bgryzor d�faut -1, implique un comportement compatible avec le protocole,
f072359f493a5209335799da85ac16d6a273303bgryzor mais vous expose aux bouclages infinis.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyPass" id="ProxyPass">ProxyPass</a> <a name="proxypass" id="proxypass">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>R�f�rencer des serveurs distants depuis
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPass [<var>chemin</var>] !|<var>url</var> [<var>cl�=valeur</var>
f072359f493a5209335799da85ac16d6a273303bgryzor <var>[cl�=valeur</var> ...]] [nocanon] [interpolate]</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive permet de r�f�rencer des serveurs distants depuis
f072359f493a5209335799da85ac16d6a273303bgryzor l'espace d'URLs du serveur local ; le serveur
f072359f493a5209335799da85ac16d6a273303bgryzor local n'agit pas en tant que mandataire au sens conventionnel, mais
f072359f493a5209335799da85ac16d6a273303bgryzor plut�t comme miroir du serveur distant. Le serveur local est
f072359f493a5209335799da85ac16d6a273303bgryzor <dfn>passerelle</dfn>. L'argument <var>chemin</var> est le nom d'un
f072359f493a5209335799da85ac16d6a273303bgryzor chemin virtuel local ; <var>url</var> est une URL partielle pour le
f072359f493a5209335799da85ac16d6a273303bgryzor serveur distant et ne doit pas contenir de cha�ne d'arguments.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <div class="warning">En g�n�ral, la directive <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> doit �tre d�finie �
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Supposons que le serveur local a pour adresse
f072359f493a5209335799da85ac16d6a273303bgryzor <p>va convertir en interne toute requ�te pour
eef716e54c415709ca9d53aad4678bf9d96186e6nd <code>http://example.com/miroir/foo/bar</code> en une requ�te
eef716e54c415709ca9d53aad4678bf9d96186e6nd mandat�e pour <code>http://backend.example.com/bar</code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Si le premier argument se termine par un slash
f072359f493a5209335799da85ac16d6a273303bgryzor <strong>/</strong>, il doit en �tre de m�me pour le second argument
f072359f493a5209335799da85ac16d6a273303bgryzor et vice versa. Dans le cas contraire, il risque de manquer des
f072359f493a5209335799da85ac16d6a273303bgryzor slashes n�cessaires dans la requ�te r�sultante vers le serveur
f072359f493a5209335799da85ac16d6a273303bgryzor d'arri�re-plan et les r�sulats ne seront pas ceux attendus.
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Le drapeau <code>!</code> permet de soustraire un sous-r�pertoire
f072359f493a5209335799da85ac16d6a273303bgryzor du mandat inverse, comme dans l'exemple suivant :</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>va mandater toutes les requ�tes pour <code>/miroir/foo</code>
eef716e54c415709ca9d53aad4678bf9d96186e6nd vers <code>backend.example.com</code>, <em>sauf</em> les requ�tes
f072359f493a5209335799da85ac16d6a273303bgryzor <p>L'ordre est important : les exclusions doivent appara�tre
f072359f493a5209335799da85ac16d6a273303bgryzor <em>avant</em> la directive <code class="directive">ProxyPass</code> plus
f072359f493a5209335799da85ac16d6a273303bgryzor g�n�rale.</p>
48c64aeceef385e19025b384bd719b2a9789592dnd <p>Depuis la version 2.1 du serveur HTTP Apache, il est possible d'utiliser un jeu de
f072359f493a5209335799da85ac16d6a273303bgryzor connexions vers un serveur d'arri�re-plan. Il est possible de
f072359f493a5209335799da85ac16d6a273303bgryzor personnaliser ce jeu de connexions � l'aide des param�tres
f072359f493a5209335799da85ac16d6a273303bgryzor <code>cl�=valeur</code>. La valeur par d�faut du nombre maximum de
f072359f493a5209335799da85ac16d6a273303bgryzor connexions correspond au nombre de threads par processus pour le MPM
f072359f493a5209335799da85ac16d6a273303bgryzor utilis�. Pour le MPM Prefork, cette valeur est toujours 1, alors que
f072359f493a5209335799da85ac16d6a273303bgryzor pour le MPM Worker, elle est contr�l�e par la directive
f072359f493a5209335799da85ac16d6a273303bgryzor <p>La d�finition de <code>min</code> va d�terminer le nombre minimum
f072359f493a5209335799da85ac16d6a273303bgryzor de connexions ouvertes vers le serveur d'arri�re-plan. Des
f072359f493a5209335799da85ac16d6a273303bgryzor connexions pourront �tre cr��es � la demande � concurrence du
f072359f493a5209335799da85ac16d6a273303bgryzor connexion au dessus de <code>smax</code> se verra attribuer une
48c64aeceef385e19025b384bd719b2a9789592dnd dur�e de vie <code>ttl</code>. Apache httpd ne cr�era jamais plus de
f072359f493a5209335799da85ac16d6a273303bgryzor connexions vers le serveur d'arri�re-plan que le maximum absolu,
eef716e54c415709ca9d53aad4678bf9d96186e6nd ProxyPass /exemple http://backend.example.com smax=5 max=20 ttl=120 retry=300
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Nombre minimum de connexions ouvertes vers le serveur
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Nombre maximum absolu de connexions autoris�es vers le
f072359f493a5209335799da85ac16d6a273303bgryzor serveur d'arri�re-plan. La valeur par d�faut du nombre maximum
f072359f493a5209335799da85ac16d6a273303bgryzor absolu de connexions correspond au nombre de threads par
f072359f493a5209335799da85ac16d6a273303bgryzor processus pour le MPM utilis�. Pour le MPM Prefork, la valeur
f072359f493a5209335799da85ac16d6a273303bgryzor est toujours 1, alors que pour le MPM Worker, elle est contr�l�e
f072359f493a5209335799da85ac16d6a273303bgryzor par la directive <code class="directive">ThreadsPerChild</code>. Apache
48c64aeceef385e19025b384bd719b2a9789592dnd httpd ne cr�era jamais plus de connexions vers le serveur
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Des connexions pourront �tre cr��es � la demande jusqu'au
f072359f493a5209335799da85ac16d6a273303bgryzor maximum relatif. Toute connexion en surnombre par rapport au
f072359f493a5209335799da85ac16d6a273303bgryzor maximum relatif se verra attribuer une dur�e de vie
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Cette cl� permet de d�finir le d�lai maximum d'attente pour
f072359f493a5209335799da85ac16d6a273303bgryzor une connexion libre dans le jeu de connexions, en millisecondes.
48c64aeceef385e19025b384bd719b2a9789592dnd S'il n'y a pas de connexion libre dans le jeu, Apache httpd renverra
f072359f493a5209335799da85ac16d6a273303bgryzor <td>D�lai d'attente d'une connexion en secondes.
48c64aeceef385e19025b384bd719b2a9789592dnd La dur�e en secondes pendant laquelle Apache httpd va attendre pour
f072359f493a5209335799da85ac16d6a273303bgryzor l'�tablissement d'une connexion vers le serveur d'arri�re-plan.
f072359f493a5209335799da85ac16d6a273303bgryzor Le d�lai peut �tre sp�cifi� en millisecondes en ajoutant le
f072359f493a5209335799da85ac16d6a273303bgryzor suffixe ms.
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Vous pouvez utiliser cette cl� pour forcer mod_proxy �
f072359f493a5209335799da85ac16d6a273303bgryzor fermer imm�diatement une connexion vers le serveur
f072359f493a5209335799da85ac16d6a273303bgryzor d'arri�re-plan apr�s utilisation, et ainsi d�sactiver le jeu de
f072359f493a5209335799da85ac16d6a273303bgryzor connexions permanentes vers ce serveur. Ceci peut s'av�rer utile
48c64aeceef385e19025b384bd719b2a9789592dnd dans des situations o� un pare-feu situ� entre Apache httpd et le
f072359f493a5209335799da85ac16d6a273303bgryzor serveur d'arri�re-plan (quelque soit le protocole) interrompt
f072359f493a5209335799da85ac16d6a273303bgryzor des connexions de mani�re silencieuse, ou lorsque le serveur
f072359f493a5209335799da85ac16d6a273303bgryzor d'arri�re-plan lui-m�me est accessible par rotation de DNS
f072359f493a5209335799da85ac16d6a273303bgryzor (round-robin DNS). Pour d�sactiver la r�utilisation du jeu de
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Permet de d�finir si le module mandataire doit vider
f072359f493a5209335799da85ac16d6a273303bgryzor automatiquement le tampon de sortie apr�s chaque tron�on de
f072359f493a5209335799da85ac16d6a273303bgryzor donn�es. 'off' signifie que le tampon sera vid� si n�cessaire,
f072359f493a5209335799da85ac16d6a273303bgryzor 'on' que le tampon sera vid� apr�s chaque envoi d'un
f072359f493a5209335799da85ac16d6a273303bgryzor tron�on de donn�es, et 'auto' que le tampon sera vid� apr�s un
f072359f493a5209335799da85ac16d6a273303bgryzor d�lai de 'flushwait' millisecondes si aucune entr�e n'est re�ue.
f072359f493a5209335799da85ac16d6a273303bgryzor Actuellement, cette cl� n'est support�e que par AJP.
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Le d�lai d'attente pour une entr�e additionnelle, en
f072359f493a5209335799da85ac16d6a273303bgryzor millisecondes, avant le vidage du tampon en sortie dans le cas
f072359f493a5209335799da85ac16d6a273303bgryzor o� 'flushpackets' est � 'auto'.
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Permet de d�finir la taille du tampon d'entr�es/sorties du
f072359f493a5209335799da85ac16d6a273303bgryzor bloc-notes interne. Cette cl� vous permet d'outrepasser la
f072359f493a5209335799da85ac16d6a273303bgryzor directive <code class="directive">ProxyIOBufferSize</code> pour un
f072359f493a5209335799da85ac16d6a273303bgryzor serveur cible sp�cifique. La valeur doit �tre au minimum 512 ou d�finie
f072359f493a5209335799da85ac16d6a273303bgryzor � 0 pour la valeur par d�faut du syst�me de 8192.
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Cette cl� doit �tre utilis�e lorsque vous avez un pare-feu
48c64aeceef385e19025b384bd719b2a9789592dnd entre Apache httpd et le serveur d'arri�re-plan, et si ce dernier tend
f072359f493a5209335799da85ac16d6a273303bgryzor � interrompre les connexions inactives. Cette cl� va faire en
f072359f493a5209335799da85ac16d6a273303bgryzor sorte que le syst�me d'exploitation envoie des messages
f072359f493a5209335799da85ac16d6a273303bgryzor <code>KEEP_ALIVE</code> sur chacune des connexions inactives
f072359f493a5209335799da85ac16d6a273303bgryzor (selon des intervalles de temps d�pendant de la configuration
f072359f493a5209335799da85ac16d6a273303bgryzor g�n�rale de l'OS, en g�n�ral 120ms), et ainsi �viter la
f072359f493a5209335799da85ac16d6a273303bgryzor fermeture de la connexion par le pare-feu. Pour activer
f072359f493a5209335799da85ac16d6a273303bgryzor <td>D�finit le groupe de r�partition de charge dont le serveur cible
f072359f493a5209335799da85ac16d6a273303bgryzor est membre. Le r�partiteur de charge va essayer tous les membres
f072359f493a5209335799da85ac16d6a273303bgryzor d'un groupe de r�partition de charge de num�ro inf�rieur avant
f072359f493a5209335799da85ac16d6a273303bgryzor d'essayer ceux dont le groupe poss�de un num�ro sup�rieur.
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Avec la cl� ping, le serveur web envoie une requ�te
f072359f493a5209335799da85ac16d6a273303bgryzor <code>CPING</code> sur la connexion ajp13 avant de rediriger une
f072359f493a5209335799da85ac16d6a273303bgryzor requ�te. La valeur correspond au d�lai d'attente de la r�ponse
f072359f493a5209335799da85ac16d6a273303bgryzor <code>CPONG</code>. Cette fonctionnalit� a �t� ajout�e afin de
f072359f493a5209335799da85ac16d6a273303bgryzor pallier aux probl�mes de blocage et de surcharge des serveurs
f072359f493a5209335799da85ac16d6a273303bgryzor Tomcat, et n�cessite le support de ping/pong ajp13 qui a �t�
f072359f493a5209335799da85ac16d6a273303bgryzor impl�ment� dans Tomcat 3.3.2+, 4.1.28+ et 5.0.13+. Le trafic
f072359f493a5209335799da85ac16d6a273303bgryzor r�seau peut s'en trouver augment� en fonctionnement normal, ce
f072359f493a5209335799da85ac16d6a273303bgryzor qui peut poser probl�me, mais peut s'en trouver diminu� dans les
f072359f493a5209335799da85ac16d6a273303bgryzor cas o� les noeuds de cluster sont arr�t�s ou surcharg�s. Cette
f072359f493a5209335799da85ac16d6a273303bgryzor cl� n'est actuellement utilisable qu'avec AJP. Le d�lai peut
f072359f493a5209335799da85ac16d6a273303bgryzor aussi �tre d�fini en millisecondes en ajoutant le suffixe
f072359f493a5209335799da85ac16d6a273303bgryzor <td>D�finit la taille du tampon r�seau explicite (TCP/IP) pour
f072359f493a5209335799da85ac16d6a273303bgryzor les connexions mandat�es. Cette cl� vous permet d'outrepasser la
f072359f493a5209335799da85ac16d6a273303bgryzor directive <code class="directive">ProxyReceiveBufferSize</code> pour un
f072359f493a5209335799da85ac16d6a273303bgryzor serveur cible sp�cifique. Sa valeur doit �tre au minimum 512 ou d�finie
f072359f493a5209335799da85ac16d6a273303bgryzor � 0 pour la valeur par d�faut du syst�me.
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Route pour la redirection du serveur cible. Cette valeur est en
f072359f493a5209335799da85ac16d6a273303bgryzor g�n�ral d�finie dynamiquement pour permettre une suppression
f072359f493a5209335799da85ac16d6a273303bgryzor s�curis�e du noeud du cluster. Si cette cl� est d�finie, toutes
f072359f493a5209335799da85ac16d6a273303bgryzor les requ�tes sans identifiant de session seront redirig�es vers
f072359f493a5209335799da85ac16d6a273303bgryzor le membre de groupe de r�partition de charge dont la route
f072359f493a5209335799da85ac16d6a273303bgryzor correspond � la valeur de la cl�.
f072359f493a5209335799da85ac16d6a273303bgryzor <td>D�lai entre deux essais du serveur cible du jeu de connexions en
f072359f493a5209335799da85ac16d6a273303bgryzor secondes. Si le serveur cible du jeu de connexions vers le serveur
48c64aeceef385e19025b384bd719b2a9789592dnd d'arri�re-plan est dans un �tat d'erreur, Apache httpd ne redirigera
f072359f493a5209335799da85ac16d6a273303bgryzor pas de requ�te vers ce serveur avant l'expiration du d�lai
f072359f493a5209335799da85ac16d6a273303bgryzor sp�cifi�. Ceci permet d'arr�ter le serveur d'arri�re-plan pour
f072359f493a5209335799da85ac16d6a273303bgryzor maintenance, et de le remettre en ligne plus tard. Une valeur de
f072359f493a5209335799da85ac16d6a273303bgryzor 0 implique de toujours essayer les serveurs cibles dans un �tat d'erreur
f072359f493a5209335799da85ac16d6a273303bgryzor sans d�lai.
f072359f493a5209335799da85ac16d6a273303bgryzor <td>La route du serveur cible lorsqu'il est utilis� au sein d'un
f072359f493a5209335799da85ac16d6a273303bgryzor r�partiteur de charge. La route est une valeur ajout�e �
f072359f493a5209335799da85ac16d6a273303bgryzor l'identifiant de session.
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Valeur constitu�e d'une simple lettre et d�finissant l'�tat
f072359f493a5209335799da85ac16d6a273303bgryzor initial de ce serveur cible : 'D' correspond � "d�sactiv�", 'S' �
f072359f493a5209335799da85ac16d6a273303bgryzor "arr�t�", 'I' � "erreurs ignor�es", 'H' � "interruption � chaud"
f072359f493a5209335799da85ac16d6a273303bgryzor et 'E' � "erreur". Une valeur d'�tat peut �tre d�finie (ce qui
f072359f493a5209335799da85ac16d6a273303bgryzor correspond au comportement par d�faut) en pr�fixant la valeur
f072359f493a5209335799da85ac16d6a273303bgryzor par '+', ou annul�e en pr�fixant la valeur par '-'. Ainsi, la
f072359f493a5209335799da85ac16d6a273303bgryzor valeur 'S-E' d�finit l'�tat de ce serveur cible � "arr�t�" et supprime
f072359f493a5209335799da85ac16d6a273303bgryzor le drapeau "en-erreur".
f072359f493a5209335799da85ac16d6a273303bgryzor <td><code class="directive"><a href="#proxytimeout">ProxyTimeout</a></code></td>
f072359f493a5209335799da85ac16d6a273303bgryzor <td>D�lai d'attente de la connexion en secondes. Le nombre de
48c64aeceef385e19025b384bd719b2a9789592dnd secondes pendant lesquelles Apache httpd attend l'envoi de
f072359f493a5209335799da85ac16d6a273303bgryzor donn�es vers le serveur d'arri�re-plan.
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Dur�e de vie des connexions inactives en surnombre par
f072359f493a5209335799da85ac16d6a273303bgryzor rapport aux <code>smax</code> premi�res connexions en secondes.
48c64aeceef385e19025b384bd719b2a9789592dnd Apache httpd fermera toutes les connexions qui n'ont pas �t� utilis�es
f072359f493a5209335799da85ac16d6a273303bgryzor pendant ce laps de temps.
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Si l'URL de la directive Proxy d�bute par
f072359f493a5209335799da85ac16d6a273303bgryzor <code>balancer://cluster/</code>, toute information relative au
f072359f493a5209335799da85ac16d6a273303bgryzor chemin est ignor�e), alors un serveur cible virtuel ne communiquant pas
f072359f493a5209335799da85ac16d6a273303bgryzor r�ellement avec le serveur d'arri�re-plan sera cr��. Celui-ci sera
f072359f493a5209335799da85ac16d6a273303bgryzor en fait responsable de la gestion de plusieurs serveurs cibles "r�els". Dans
f072359f493a5209335799da85ac16d6a273303bgryzor ce cas, un jeu de param�tres particuliers s'applique � ce serveur cible
f072359f493a5209335799da85ac16d6a273303bgryzor virtuel. Voir <code class="module"><a href="/mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> pour plus
f072359f493a5209335799da85ac16d6a273303bgryzor d'informations � propos du fonctionnement du r�partiteur de
f072359f493a5209335799da85ac16d6a273303bgryzor <td>M�thode de r�partition de charge utilis�e. Permet de
f072359f493a5209335799da85ac16d6a273303bgryzor s�lectionner la m�thode de planification de la r�partition de
f072359f493a5209335799da85ac16d6a273303bgryzor charge � utiliser. La valeur est soit <code>byrequests</code>,
f072359f493a5209335799da85ac16d6a273303bgryzor pour effectuer un d�compte de requ�tes pond�r�es, soit
f072359f493a5209335799da85ac16d6a273303bgryzor <code>bytraffic</code>, pour effectuer une r�partition en
f072359f493a5209335799da85ac16d6a273303bgryzor fonction du d�compte des octets transmis, soit
f072359f493a5209335799da85ac16d6a273303bgryzor <code>bybusyness</code>, pour effectuer une r�partition en
f072359f493a5209335799da85ac16d6a273303bgryzor fonction des requ�tes en attente. La valeur par d�faut est
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Nombre maximum d'�checs avant abandon.
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Si ce param�tre est d�fini � <code>On</code>, la session va
f072359f493a5209335799da85ac16d6a273303bgryzor s'interrompre si le serveur cible est dans un �tat d'erreur ou
f072359f493a5209335799da85ac16d6a273303bgryzor d�sactiv�. D�finissez ce param�tre � On si le serveur
f072359f493a5209335799da85ac16d6a273303bgryzor d'arri�re-plan ne supporte pas la r�plication de session.
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Nom de session persistant du r�partiteur. La valeur est
f072359f493a5209335799da85ac16d6a273303bgryzor <code>PHPSESSIONID</code>, et d�pend du serveur d'application
f072359f493a5209335799da85ac16d6a273303bgryzor d'arri�re-plan qui supporte les sessions. Si le serveur
f072359f493a5209335799da85ac16d6a273303bgryzor d'application d'arri�re-plan utilise des noms diff�rents pour
f072359f493a5209335799da85ac16d6a273303bgryzor les cookies et les identifiants cod�s d'URL (comme les
f072359f493a5209335799da85ac16d6a273303bgryzor conteneurs de servlet), s�parez-les par le caract�re '|'. La
f072359f493a5209335799da85ac16d6a273303bgryzor premi�re partie contient le cookie et la seconde le chemin.
f072359f493a5209335799da85ac16d6a273303bgryzor <td>Si ce param�tre est d�fini � <code>On</code>, le caract�re
f072359f493a5209335799da85ac16d6a273303bgryzor ';' sera utilis� comme s�parateur de chemin de session
f072359f493a5209335799da85ac16d6a273303bgryzor persistante additionnel. Ceci permet principalement de simuler
f072359f493a5209335799da85ac16d6a273303bgryzor le comportement de mod_jk lorsqu'on utilise des chemins du style
f072359f493a5209335799da85ac16d6a273303bgryzor <td>D�lai du r�partiteur en secondes. Si ce param�tre est
f072359f493a5209335799da85ac16d6a273303bgryzor d�fini, sa valeur correspond � la dur�e maximale d'attente pour
f072359f493a5209335799da85ac16d6a273303bgryzor un serveur cible libre. Le comportement par d�faut est de ne pas
5479b5fa65d8ec88ea9c4389fd1b2c2728585571nd <p>Exemple de configuration d'un r�partiteur de charge</p>
eef716e54c415709ca9d53aad4678bf9d96186e6nd ProxyPass /zone-speciale http://special.example.com smax=5 max=10<br />
f072359f493a5209335799da85ac16d6a273303bgryzor ProxyPass / balancer://mon-cluster/ stickysession=JSESSIONID|jsessionid nofailover=On<br />
f072359f493a5209335799da85ac16d6a273303bgryzor <Proxy balancer://mon-cluster><br />
f072359f493a5209335799da85ac16d6a273303bgryzor # Serveur moins puissant ; faites-lui traiter moins de requ�tes<br />
f072359f493a5209335799da85ac16d6a273303bgryzor BalancerMember http://1.2.3.6:8009 smax=1 loadfactor=20<br />
f072359f493a5209335799da85ac16d6a273303bgryzor </Proxy>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Configuration d'un serveur cible de r�serve qui ne sera utilis� que si
f072359f493a5209335799da85ac16d6a273303bgryzor aucun autre serveur cible n'est disponible</p>
f072359f493a5209335799da85ac16d6a273303bgryzor ProxyPass / balancer://hotcluster/ <br />
f072359f493a5209335799da85ac16d6a273303bgryzor <Proxy balancer://hotcluster><br />
f072359f493a5209335799da85ac16d6a273303bgryzor BalancerMember http://1.2.3.4:8009 loadfactor=1<br />
f072359f493a5209335799da85ac16d6a273303bgryzor BalancerMember http://1.2.3.5:8009 loadfactor=2<br />
f072359f493a5209335799da85ac16d6a273303bgryzor # La ligne suivante configure le serveur cible de r�serve<br />
f072359f493a5209335799da85ac16d6a273303bgryzor ProxySet lbmethod=bytraffic
f072359f493a5209335799da85ac16d6a273303bgryzor </Proxy>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Normalement, mod_proxy va mettre sous leur forme canonique les
f072359f493a5209335799da85ac16d6a273303bgryzor URLs trait�es par ProxyPass. Mais ceci peut �tre incompatible avec
f072359f493a5209335799da85ac16d6a273303bgryzor certains serveurs d'arri�re-plan, et en particulier avec ceux qui
f072359f493a5209335799da85ac16d6a273303bgryzor <var>nocanon</var> modifie ce comportement et permet de transmettre
f072359f493a5209335799da85ac16d6a273303bgryzor le chemin d'URL sous sa forme brute au serveur d'arri�re-plan. Notez
f072359f493a5209335799da85ac16d6a273303bgryzor que ceci peut affecter la s�curit� de votre serveur d'arri�re-plan,
f072359f493a5209335799da85ac16d6a273303bgryzor car la protection limit�e contre les attaques � base d'URL que
f072359f493a5209335799da85ac16d6a273303bgryzor fournit le mandataire est alors supprim�e.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Le mot-cl� optionnel <var>interpolate</var> (disponible depuis
f072359f493a5209335799da85ac16d6a273303bgryzor httpd 2.2.9), en combinaison avec la directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive">ProxyPassInterpolateEnv</code>, permet � ProxyPass
f072359f493a5209335799da85ac16d6a273303bgryzor d'interpoler les variables d'environnement � l'aide de la syntaxe
f072359f493a5209335799da85ac16d6a273303bgryzor <var>${VARNAME}</var>. Notez que de nombreuses variables
f072359f493a5209335799da85ac16d6a273303bgryzor d'environnement standard d�riv�es de CGI n'existeront pas lorsque
f072359f493a5209335799da85ac16d6a273303bgryzor l'interpolation se produit ; vous devrez alors encore avoir avoir
f072359f493a5209335799da85ac16d6a273303bgryzor recours � <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> pour des r�gles
f072359f493a5209335799da85ac16d6a273303bgryzor complexes.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Lorsque la directive ProxyPass est utilis�e � l'int�rieur d'une
f072359f493a5209335799da85ac16d6a273303bgryzor section <code class="directive"><a href="/mod/core.html#location"><Location></a></code>, le premier argument est omis et le r�pertoire
f072359f493a5209335799da85ac16d6a273303bgryzor local est obtenu � partir de la section <code class="directive"><a href="/mod/core.html#location"><Location></a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Si vous avez besoin d'un configuration de mandataire inverse plus
f072359f493a5209335799da85ac16d6a273303bgryzor souple, reportez-vous � la documentaion de la directive <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> et son drapeau
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyPassInterpolateEnv" id="ProxyPassInterpolateEnv">ProxyPassInterpolateEnv</a> <a name="proxypassinterpolateenv" id="proxypassinterpolateenv">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active l'interpolation des variables d'environnement dans
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassInterpolateEnv On|Off</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyPassInterpolateEnv Off</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.2.9 d'Apache</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive, ainsi que l'argument <var>interpolate</var> des
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive">ProxyPassReverseCookieDomain</code> et
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive">ProxyPassReverseCookiePath</code>, permet de
f072359f493a5209335799da85ac16d6a273303bgryzor configurer dynamiquement un mandataire inverse � l'aide de
f072359f493a5209335799da85ac16d6a273303bgryzor variables d'environnement, ces derni�res pouvant �tre d�finies par un
f072359f493a5209335799da85ac16d6a273303bgryzor autre module comme <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>. Elle affecte les
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive">ProxyPassReverseCookieDomain</code>, et
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive">ProxyPassReverseCookiePath</code>, en leur indiquant
f072359f493a5209335799da85ac16d6a273303bgryzor de remplacer la cha�ne <code>${nom_var}</code> dans les directives
f072359f493a5209335799da85ac16d6a273303bgryzor de configuration par la valeur de la variable d'environnement
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Conservez cette directive � off (pour les performances du
f072359f493a5209335799da85ac16d6a273303bgryzor serveur), sauf si vous en avez r�ellement besoin.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyPassMatch" id="ProxyPassMatch">ProxyPassMatch</a> <a name="proxypassmatch" id="proxypassmatch">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre des serveurs distants dans l'espace d'URL
f072359f493a5209335799da85ac16d6a273303bgryzordu serveur local en utilisant des expressions rationnelles</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassMatch [<var>regex</var>] !|<var>url</var>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive est identique � la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>, mais fait usage des
f072359f493a5209335799da85ac16d6a273303bgryzor expressions rationnelles, au lieu d'une simple comparaison de
f072359f493a5209335799da85ac16d6a273303bgryzor pr�fixes. L'expression rationnelle sp�cifi�e est compar�e �
f072359f493a5209335799da85ac16d6a273303bgryzor l'<var>url</var>, et si elle correspond, le serveur va substituer
f072359f493a5209335799da85ac16d6a273303bgryzor toute correspondance entre parenth�ses dans la cha�ne donn�e et
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Supposons que le serveur local a pour adresse
eef716e54c415709ca9d53aad4678bf9d96186e6nd ProxyPassMatch ^(/.*\.gif)$ http://backend.example.com$1
f072359f493a5209335799da85ac16d6a273303bgryzor <p>va provoquer la conversion interne de la requ�te locale
eef716e54c415709ca9d53aad4678bf9d96186e6nd <code>http://example.com/foo/bar.gif</code> en une requ�te mandat�e
eef716e54c415709ca9d53aad4678bf9d96186e6nd pour <code>http://backend.example.com/foo/bar.gif</code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>L'argument URL doit pouvoir �tre interpr�t� en tant qu'URL
f072359f493a5209335799da85ac16d6a273303bgryzor <em>avant</em> les substitutions d'expressions rationnelles (et
f072359f493a5209335799da85ac16d6a273303bgryzor doit aussi l'�tre apr�s). Ceci limite les correspondances que vous
f072359f493a5209335799da85ac16d6a273303bgryzor pouvez utiliser. Par exemple, si l'on avait utilis�</p>
eef716e54c415709ca9d53aad4678bf9d96186e6nd ProxyPassMatch ^(/.*\.gif)$ http://backend.example.com:8000$1
f072359f493a5209335799da85ac16d6a273303bgryzor <p>dans l'exemple pr�c�dent, nous aurions provoqu� une erreur de
f072359f493a5209335799da85ac16d6a273303bgryzor syntaxe au d�marrage du serveur. C'est une bogue (PR 46665 dans
f072359f493a5209335799da85ac16d6a273303bgryzor ASF bugzilla), et il est possible de la contourner en reformulant
f072359f493a5209335799da85ac16d6a273303bgryzor la correspondance :</p>
eef716e54c415709ca9d53aad4678bf9d96186e6nd ProxyPassMatch ^/(.*\.gif)$ http://backend.example.com:8000/$1
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Le drapeau <code>!</code> vous permet de ne pas mandater un
f072359f493a5209335799da85ac16d6a273303bgryzor sous-r�pertoire donn�.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyPassReverse" id="ProxyPassReverse">ProxyPassReverse</a> <a name="proxypassreverse" id="proxypassreverse">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajuste l'URL dans les en-t�tes de la r�ponse HTTP envoy�e
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverse [<var>chemin</var>] <var>url</var>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
48c64aeceef385e19025b384bd719b2a9789592dnd <p>Cette directive permet de faire en sorte qu'Apache httpd ajuste l'URL
f072359f493a5209335799da85ac16d6a273303bgryzor <code>Content-Location</code> et <code>URI</code> des r�ponses de
48c64aeceef385e19025b384bd719b2a9789592dnd redirection HTTP. Ceci est essentiel lorsqu'Apache httpd est utilis� en
f072359f493a5209335799da85ac16d6a273303bgryzor tant que mandataire inverse (ou passerelle), afin d'�viter de
f072359f493a5209335799da85ac16d6a273303bgryzor court-circuiter le mandataire inverse suite aux redirections HTTP
f072359f493a5209335799da85ac16d6a273303bgryzor sur le serveur d'arri�re-plan qui restent derri�re le mandataire
f072359f493a5209335799da85ac16d6a273303bgryzor inverse.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Seuls les en-t�tes de r�ponse HTTP sp�cialement mentionn�s
48c64aeceef385e19025b384bd719b2a9789592dnd ci-dessus seront r��crits. Apache httpd ne r��crira ni les autres en-t�tes
f072359f493a5209335799da85ac16d6a273303bgryzor de r�ponse, ni les r�f�rences d'URLs dans les pages HTML. Cela
f072359f493a5209335799da85ac16d6a273303bgryzor signifie que dans le cas o� un contenu mandat� contient des
f072359f493a5209335799da85ac16d6a273303bgryzor r�f�rences � des URLs absolues, elles court-circuiteront le
f072359f493a5209335799da85ac16d6a273303bgryzor mandataire. Le module <a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a>
f072359f493a5209335799da85ac16d6a273303bgryzor de Nick Kew est un module tiers qui parcourt le code HTML et r��crit
f072359f493a5209335799da85ac16d6a273303bgryzor les r�f�rences d'URL.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p><var>chemin</var> est le nom d'un chemin virtuel local.
f072359f493a5209335799da85ac16d6a273303bgryzor <var>url</var> est une URL partielle pour le serveur distant - ils
f072359f493a5209335799da85ac16d6a273303bgryzor sont utilis�s de la m�me fa�on qu'avec la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Supposons par exemple que le serveur local a pour adresse
eef716e54c415709ca9d53aad4678bf9d96186e6nd ProxyPassReverse /miroir/foo/ http://backend.example.com/<br />
eef716e54c415709ca9d53aad4678bf9d96186e6nd ProxyPassReverseCookieDomain backend.example.com public.example.com<br />
f072359f493a5209335799da85ac16d6a273303bgryzor <p>ne va pas seulement provoquer la conversion interne d'une requ�te
eef716e54c415709ca9d53aad4678bf9d96186e6nd locale pour <code>http://example.com/miroir/foo/bar</code> en une
eef716e54c415709ca9d53aad4678bf9d96186e6nd requ�te mandat�e pour <code>http://backend.example.com/bar</code>
f072359f493a5209335799da85ac16d6a273303bgryzor (la fonctionnalit� fournie par <code>ProxyPass</code>). Il va
f072359f493a5209335799da85ac16d6a273303bgryzor aussi s'occuper des redirections que le serveur
eef716e54c415709ca9d53aad4678bf9d96186e6nd <code>http://backend.example.com/bar</code> est redirig� par
eef716e54c415709ca9d53aad4678bf9d96186e6nd celui-ci vers <code>http://backend.example.com/quux</code>, Apache
48c64aeceef385e19025b384bd719b2a9789592dnd httpd corrige ceci en <code>http://example.com/miroir/foo/quux</code>
f072359f493a5209335799da85ac16d6a273303bgryzor avant de faire suivre la redirection HTTP au client. Notez que le
f072359f493a5209335799da85ac16d6a273303bgryzor nom d'h�te utilis� pour construire l'URL est choisi en respectant la
f072359f493a5209335799da85ac16d6a273303bgryzor d�finition de la directive <code class="directive"><a href="/mod/core.html#usecanonicalname">UseCanonicalName</a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Notez que la directive <code class="directive">ProxyPassReverse</code>
f072359f493a5209335799da85ac16d6a273303bgryzor peut aussi �tre utilis�e en conjonction avec la fonctionnalit�
f072359f493a5209335799da85ac16d6a273303bgryzor pass-through (<code>RewriteRule ... [P]</code>) du module
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>, car elle ne d�pend pas d'une directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive"><a href="#proxypass">ProxyPass</a></code>
f072359f493a5209335799da85ac16d6a273303bgryzor correspondante.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Le mot-cl� optionnel <var>interpolate</var> (disponible depuis
f072359f493a5209335799da85ac16d6a273303bgryzor httpd 2.2.9), utilis� en combinaison avec la directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive">ProxyPassInterpolateEnv</code>, permet
f072359f493a5209335799da85ac16d6a273303bgryzor l'interpolation des variables d'environnement sp�cifi�es en
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Lorsque cette directive est utilis�e dans une section <code class="directive"><a href="/mod/core.html#location"><Location></a></code>, le premier
f072359f493a5209335799da85ac16d6a273303bgryzor argument est omis et le r�pertoire local est obtenu � partir de
f072359f493a5209335799da85ac16d6a273303bgryzor l'argument de la directive <code class="directive"><a href="/mod/core.html#location"><Location></a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyPassReverseCookieDomain" id="ProxyPassReverseCookieDomain">ProxyPassReverseCookieDomain</a> <a name="proxypassreversecookiedomain" id="proxypassreversecookiedomain">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajuste la cha�ne correspondant au domaine dans les en-t�tes
f072359f493a5209335799da85ac16d6a273303bgryzorSet-Cookie en provenance d'un serveur mandat�</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverseCookieDomain <var>domaine-interne</var>
f072359f493a5209335799da85ac16d6a273303bgryzor<var>domaine-public</var> [<var>interpolate</var>]</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<p>L'utilisation de cette directive est similaire � celle de la
f072359f493a5209335799da85ac16d6a273303bgryzordirective <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>,
f072359f493a5209335799da85ac16d6a273303bgryzormais au lieu de r��crire des en-t�tes qui contiennent des URLs, elle
f072359f493a5209335799da85ac16d6a273303bgryzorr��crit la cha�ne correspondant au domaine dans les en-t�tes
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyPassReverseCookiePath" id="ProxyPassReverseCookiePath">ProxyPassReverseCookiePath</a> <a name="proxypassreversecookiepath" id="proxypassreversecookiepath">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajuste la cha�ne correspondant au chemin dans les en-t�tes
f072359f493a5209335799da85ac16d6a273303bgryzorSet-Cookie en provenance d'un serveur mandat�</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverseCookiePath <var>chemin-interne</var>
f072359f493a5209335799da85ac16d6a273303bgryzor<var>chemin-public</var> [<var>interpolate</var>]</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<p>L'utilisation de cette directive est similaire � celle de la
f072359f493a5209335799da85ac16d6a273303bgryzordirective <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>,
f072359f493a5209335799da85ac16d6a273303bgryzormais au lieu de r��crire des en-t�tes qui contiennent des URLs, elle
f072359f493a5209335799da85ac16d6a273303bgryzorr��crit la cha�ne correspondant au <code>chemin</code> dans les en-t�tes
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyPreserveHost" id="ProxyPreserveHost">ProxyPreserveHost</a> <a name="proxypreservehost" id="proxypreservehost">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise l'en-t�te de requ�te entrante Host pour la requ�te
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPreserveHost On|Off</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyPreserveHost Off</code></td></tr>
201fc52d132d8f375e6c4351921367897fb5265and<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
48c64aeceef385e19025b384bd719b2a9789592dnd<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.0.31 du serveur HTTP Apache. Utilisable
3c13a815670b54d1c17bf02954f7d2b066cde95cnddans un contexte de r�pertoire depuis la version 2.3.3.</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Lorsqu'elle est activ�e, cette directive va transmettre l'en-t�te
f072359f493a5209335799da85ac16d6a273303bgryzor Host: de la requ�te entrante vers le serveur mandat�, au lieu du nom
f072359f493a5209335799da85ac16d6a273303bgryzor d'h�te sp�cifi� par la directive <code class="directive">ProxyPass</code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive est habituellement d�finie � <code>Off</code>.
f072359f493a5209335799da85ac16d6a273303bgryzor Elle est principalement utile dans les configurations particuli�res
f072359f493a5209335799da85ac16d6a273303bgryzor comme l'h�bergement virtuel mandat� en masse � base de nom, o�
f072359f493a5209335799da85ac16d6a273303bgryzor l'en-t�te Host d'origine doit �tre �valu� par le serveur
f072359f493a5209335799da85ac16d6a273303bgryzor d'arri�re-plan.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyReceiveBufferSize" id="ProxyReceiveBufferSize">ProxyReceiveBufferSize</a> <a name="proxyreceivebuffersize" id="proxyreceivebuffersize">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du tampon r�seau pour les connexions mandat�es HTTP
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyReceiveBufferSize <var>octets</var></code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyReceiveBufferSize 0</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>La directive <code class="directive">ProxyReceiveBufferSize</code> permet
f072359f493a5209335799da85ac16d6a273303bgryzor de sp�cifier une taille de tampon r�seau explicite (TCP/IP) pour les
f072359f493a5209335799da85ac16d6a273303bgryzor connexions mandat�es HTTP et FTP, afin d'am�liorer le d�bit de
f072359f493a5209335799da85ac16d6a273303bgryzor donn�es. Elle doit �tre sup�rieure � <code>512</code> ou d�finie �
f072359f493a5209335799da85ac16d6a273303bgryzor <code>0</code> pour indiquer que la taille de tampon par d�faut du
f072359f493a5209335799da85ac16d6a273303bgryzor syst�me doit �tre utilis�e.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor ProxyReceiveBufferSize 2048
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyRemote" id="ProxyRemote">ProxyRemote</a> <a name="proxyremote" id="proxyremote">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Mandataire distant � utiliser pour traiter certaines
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRemote <var>comparaison</var> <var>serveur-distant</var></code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive permet de d�finir des mandataires distants pour
f072359f493a5209335799da85ac16d6a273303bgryzor ce mandataire. <var>comparaison</var> est soit le nom d'un protocole
f072359f493a5209335799da85ac16d6a273303bgryzor que supporte le serveur distant, soit une URL partielle pour
f072359f493a5209335799da85ac16d6a273303bgryzor laquelle le serveur distant devra �tre utilis�, soit <code>*</code>
f072359f493a5209335799da85ac16d6a273303bgryzor pour indiquer que le serveur distant doit �tre utilis� pour toutes
f072359f493a5209335799da85ac16d6a273303bgryzor les requ�tes. <var>serveur-distant</var> est une URL partielle
f072359f493a5209335799da85ac16d6a273303bgryzor correspondant au serveur distant. Syntaxe : </p>
f072359f493a5209335799da85ac16d6a273303bgryzor <var>protocole</var>://<var>nom-serveur</var>[:<var>port</var>]
f072359f493a5209335799da85ac16d6a273303bgryzor <p><var>protocole</var> est effectivement le protocole � utiliser
f072359f493a5209335799da85ac16d6a273303bgryzor pour communiquer avec le serveur distant ; ce module ne supporte que
6d20aeba2c4aa0938bc6e0659d13adc7670ff421poirier <code>http</code> et <code>https</code>. Lorsqu'on utilise
6d20aeba2c4aa0938bc6e0659d13adc7670ff421poirier <code>https</code>, les requ�tes sont redirig�es par le mandataire
6d20aeba2c4aa0938bc6e0659d13adc7670ff421poirier distant en utilisant la m�thode HTTP CONNECT.</p>
eef716e54c415709ca9d53aad4678bf9d96186e6nd ProxyRemote http://bons-gars.example.com/ http://gars-mirroirs.example.com:8000<br />
f072359f493a5209335799da85ac16d6a273303bgryzor ProxyRemote * http://mandataire-intelligent.localdomain<br />
f072359f493a5209335799da85ac16d6a273303bgryzor ProxyRemote ftp http://mandataire-ftp.mon-domaine:8080
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Dans la derni�re ligne de l'exemple, le mandataire va faire
f072359f493a5209335799da85ac16d6a273303bgryzor suivre les requ�tes FTP, encapsul�es dans une autre requ�te mandat�e
f072359f493a5209335799da85ac16d6a273303bgryzor HTTP, vers un autre mandataire capable de les traiter.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive supporte aussi les configurations de mandataire
f072359f493a5209335799da85ac16d6a273303bgryzor inverse - un serveur web d'arri�re-plan peut �tre int�gr� dans
f072359f493a5209335799da85ac16d6a273303bgryzor l'espace d'URL d'un serveur virtuel, m�me si ce serveur est cach�
f072359f493a5209335799da85ac16d6a273303bgryzor par un autre mandataire direct.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyRemoteMatch" id="ProxyRemoteMatch">ProxyRemoteMatch</a> <a name="proxyremotematch" id="proxyremotematch">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le mandataire distant � utiliser pour traiter les requ�tes
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRemoteMatch <var>regex</var> <var>serveur-distant</var></code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>La directive <code class="directive">ProxyRemoteMatch</code> est
f072359f493a5209335799da85ac16d6a273303bgryzor identique � la directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code>, � l'exception du
f072359f493a5209335799da85ac16d6a273303bgryzor premier argument qui est une <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression
f072359f493a5209335799da85ac16d6a273303bgryzor rationnelle</a> � mettre en correspondance avec l'URL de la
f072359f493a5209335799da85ac16d6a273303bgryzor requ�te.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyRequests" id="ProxyRequests">ProxyRequests</a> <a name="proxyrequests" id="proxyrequests">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la fonctionnalit� (standard) de mandataire
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRequests On|Off</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyRequests Off</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive permet d'activer/d�sactiver la fonctionnalit� de
48c64aeceef385e19025b384bd719b2a9789592dnd serveur mandataire direct d'Apache httpd. D�finir ProxyRequests �
f072359f493a5209335799da85ac16d6a273303bgryzor <code>Off</code> n'interdit pas l'utilisation de la directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Pour une configuration typique de mandataire inverse ou
f072359f493a5209335799da85ac16d6a273303bgryzor passerelle, cette directive doit �tre d�finie �
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Afin d'activer la fonctionnalit� de mandataire pour des sites
f072359f493a5209335799da85ac16d6a273303bgryzor HTTP et/ou FTP, les modules <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code> et/ou
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="module"><a href="/mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> doivent �galement �tre charg�s dans le
f072359f493a5209335799da85ac16d6a273303bgryzor serveur.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>N'activez pas la fonctionnalit� de mandataire avec la directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> avant
f072359f493a5209335799da85ac16d6a273303bgryzor d'avoir <a href="#access">s�curis� votre serveur</a>. Les serveurs
f072359f493a5209335799da85ac16d6a273303bgryzor mandataires ouverts sont dangereux non seulement pour votre
f072359f493a5209335799da85ac16d6a273303bgryzor r�seau, mais aussi pour l'Internet au sens large.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><a href="#forwardreverse">Mandataires/Passerelles directs et
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxySet" id="ProxySet">ProxySet</a> <a name="proxyset" id="proxyset">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit diff�rents param�tres relatifs � la r�partition de
f072359f493a5209335799da85ac16d6a273303bgryzorcharge des mandataires et aux membres des groupes de r�partition de
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxySet <var>url</var> <var>cl�=valeur [cl�=valeur ...]</var></code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>ProxySet n'est disponible que depuis la version 2.2
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive propose une m�thode alternative pour d�finir tout
f072359f493a5209335799da85ac16d6a273303bgryzor param�tre relatif aux r�partiteurs de charge et serveurs cibles de
f072359f493a5209335799da85ac16d6a273303bgryzor mandataires normalement d�finis via la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>. Si elle se trouve dans un
f072359f493a5209335799da85ac16d6a273303bgryzor conteneur <code><Proxy <var>url de r�partiteur|url de
f072359f493a5209335799da85ac16d6a273303bgryzor serveur cible</var>></code>, l'argument <var>url</var> n'est pas
f072359f493a5209335799da85ac16d6a273303bgryzor n�cessaire. Comme effet de bord, le r�partiteur ou serveur cible respectif
f072359f493a5209335799da85ac16d6a273303bgryzor est cr��. Ceci peut s'av�rer utile pour la mise en oeuvre d'un
f072359f493a5209335799da85ac16d6a273303bgryzor mandataire inverse via une directive <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> au lieu de <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <Proxy balancer://hotcluster><br />
eef716e54c415709ca9d53aad4678bf9d96186e6nd BalancerMember http://www2.example.com:8009 loadfactor=1<br />
eef716e54c415709ca9d53aad4678bf9d96186e6nd BalancerMember http://www3.example.com:8009 loadfactor=2<br />
f072359f493a5209335799da85ac16d6a273303bgryzor ProxySet lbmethod=bytraffic<br />
f072359f493a5209335799da85ac16d6a273303bgryzor </Proxy>
f072359f493a5209335799da85ac16d6a273303bgryzor ProxySet keepalive=On<br />
f072359f493a5209335799da85ac16d6a273303bgryzor </Proxy>
f072359f493a5209335799da85ac16d6a273303bgryzor ProxySet balancer://foo lbmethod=bytraffic timeout=15
f072359f493a5209335799da85ac16d6a273303bgryzor ProxySet ajp://backend:7001 timeout=15
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Gardez � l'esprit qu'une m�me cl� de param�tre peut avoir
f072359f493a5209335799da85ac16d6a273303bgryzor diff�rentes significations selon qu'elle s'applique � un
f072359f493a5209335799da85ac16d6a273303bgryzor r�partiteur ou � un serveur cible, et ceci est illustr� par les deux
f072359f493a5209335799da85ac16d6a273303bgryzor exemples pr�c�dents o� il est question d'un timeout.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyStatus" id="ProxyStatus">ProxyStatus</a> <a name="proxystatus" id="proxystatus">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Affiche l'�tat du r�partiteur de charge du mandataire dans
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyStatus Off|On|Full</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyStatus Off</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.2 d'Apache</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive permet de sp�cifier si les donn�es d'�tat du
f072359f493a5209335799da85ac16d6a273303bgryzor r�partiteur de charge du mandataire doivent �tre affich�es via la
f072359f493a5209335799da85ac16d6a273303bgryzor page d'�tat du serveur du module <code class="module"><a href="/mod/mod_status.html">mod_status</a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>L'argument <strong>Full</strong> produit le m�me effet que
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyTimeout" id="ProxyTimeout">ProxyTimeout</a> <a name="proxytimeout" id="proxytimeout">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�lai d'attente r�seau pour les requ�tes
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyTimeout <var>secondes</var></code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Valeur de la directive <code class="directive"><a href="/mod/core.html#timeout">Timeout</a></code></code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
48c64aeceef385e19025b384bd719b2a9789592dnd<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.0.31 du serveur HTTP Apache</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive permet � l'utilisateur de sp�cifier un d�lai pour
f072359f493a5209335799da85ac16d6a273303bgryzor les requ�tes mandat�es. Ceci s'av�re utile dans le cas d'un serveur
f072359f493a5209335799da85ac16d6a273303bgryzor d'applications lent et bogu� qui a tendance � se bloquer, et si vous
f072359f493a5209335799da85ac16d6a273303bgryzor pr�f�rez simplement renvoyer une erreur timeout et abandonner la
f072359f493a5209335799da85ac16d6a273303bgryzor connexion en douceur plut�t que d'attendre jusqu'� ce que le serveur
f072359f493a5209335799da85ac16d6a273303bgryzor veuille bien r�pondre.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="directive-section"><h2><a name="ProxyVia" id="ProxyVia">ProxyVia</a> <a name="proxyvia" id="proxyvia">Directive</a></h2>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Information fournie dans l'en-t�te de r�ponse HTTP
f072359f493a5209335799da85ac16d6a273303bgryzor<code>Via</code> pour les requ�tes mandat�es</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyVia On|Off|Full|Block</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyVia Off</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>Cette directive permet de contr�ler l'utilisation de l'en-t�te
f072359f493a5209335799da85ac16d6a273303bgryzor HTTP <code>Via:</code> par le mandataire. Le but recherch� est de
f072359f493a5209335799da85ac16d6a273303bgryzor contr�ler le flux des requ�tes mandat�es tout au long d'une cha�ne
f072359f493a5209335799da85ac16d6a273303bgryzor de serveurs mandataires. Voir <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> (HTTP/1.1),
f072359f493a5209335799da85ac16d6a273303bgryzor section 14.45 pour une description des lignes d'en-t�te
f072359f493a5209335799da85ac16d6a273303bgryzor <li>Si elle est d�finie � <code>Off</code>, valeur par d�faut, cette
f072359f493a5209335799da85ac16d6a273303bgryzor directive n'effectue aucun traitement particulier. Si une requ�te ou
f072359f493a5209335799da85ac16d6a273303bgryzor une r�ponse contient un en-t�te <code>Via:</code>, il est transmis
f072359f493a5209335799da85ac16d6a273303bgryzor sans modification.</li>
f072359f493a5209335799da85ac16d6a273303bgryzor <li>Si elle est d�finie � <code>On</code>, chaque requ�te ou r�ponse
f072359f493a5209335799da85ac16d6a273303bgryzor se verra ajouter une ligne d'en-t�te <code>Via:</code> pour le
f072359f493a5209335799da85ac16d6a273303bgryzor serveur courant.</li>
f072359f493a5209335799da85ac16d6a273303bgryzor <li>Si elle est d�finie � <code>Full</code>, chaque ligne d'en-t�te
48c64aeceef385e19025b384bd719b2a9789592dnd <code>Via:</code> se verra ajouter la version du serveur Apache
48c64aeceef385e19025b384bd719b2a9789592dnd httpd sous la forme d'un champ de commentaire <code>Via:</code>.</li>
f072359f493a5209335799da85ac16d6a273303bgryzor <li>Si elle est d�finie � <code>Block</code>, chaque requ�te
f072359f493a5209335799da85ac16d6a273303bgryzor mandat�e verra ses lignes d'en-t�te <code>Via:</code> supprim�es.
f072359f493a5209335799da85ac16d6a273303bgryzor Aucun nouvel en-t�te <code>Via:</code> ne sera g�n�r�.</li>
f072359f493a5209335799da85ac16d6a273303bgryzor<p><span>Langues Disponibles: </span><a href="/en/mod/mod_proxy.html" hreflang="en" rel="alternate" title="English"> en </a> |
f072359f493a5209335799da85ac16d6a273303bgryzor<a href="/fr/mod/mod_proxy.html" title="Fran�ais"> fr </a> |
f072359f493a5209335799da85ac16d6a273303bgryzor<a href="/ja/mod/mod_proxy.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
50039065d571fe01fd458a3f031c995a1fd53c22rbowen<p class="apache">Copyright 2010 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<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>