1<?xml version="1.0" encoding="ISO-8859-1"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- 4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 5 This file is generated from xml source: DO NOT EDIT 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 --> 8<title>mod_proxy - Serveur Apache HTTP</title> 9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 11<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" /> 12<script src="/style/scripts/prettify.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body> 17<div id="page-header"> 18<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p> 19<p class="apache">Serveur Apache HTTP Version 2.2</p> 20<img alt="" src="/images/feather.gif" /></div> 21<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 22<div id="path"> 23<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.2</a> > <a href="./">Modules</a></div> 24<div id="page-content"> 25<div id="preamble"><h1>Module Apache mod_proxy</h1> 26<div class="toplang"> 27<p><span>Langues Disponibles: </span><a href="/en/mod/mod_proxy.html" hreflang="en" rel="alternate" title="English"> en </a> | 28<a href="/fr/mod/mod_proxy.html" title="Fran�ais"> fr </a> | 29<a href="/ja/mod/mod_proxy.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> 30</div> 31<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Serveur mandataire/passerelle HTTP/1.1</td></tr> 32<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 33<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>proxy_module</td></tr> 34<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_proxy.c</td></tr></table> 35<h3>Sommaire</h3> 36 37 <div class="warning"><h3>Avertissement</h3> 38 <p>N'activez pas la fonctionnalit� de mandataire avec la directive 39 <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> avant 40 d'avoir <a href="#access">s�curis� votre serveur</a>. Les serveurs 41 mandataires ouverts sont dangereux pour votre r�seau, 42 mais aussi pour l'Internet au sens large.</p> 43 </div> 44 45 <p>Ce module impl�mente un mandataire/passerelle pour Apache. Il 46 impl�mente la fonctionnalit� de mandataire pour <code>AJP13</code> 47 (Apache JServe Protocol version 1.3), <code>FTP</code>, 48 <code>CONNECT</code> (pour SSL), <code>HTTP/0.9</code>, 49 <code>HTTP/1.0</code>, et <code>HTTP/1.1</code>. Le module peut �tre 50 configur� pour se connecter aux autres modules mandataires qui 51 g�rent ces protocoles.</p> 52 53 <p>Les diverses fonctionnalit�s de 54 mandataire d'Apache sont r�parties entre plusieurs modules 55 compl�mentaires de <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> : 56 <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>, 57 <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>, 58 et <code class="module"><a href="/mod/mod_proxy_connect.html">mod_proxy_connect</a></code>. Ainsi, si vous voulez 59 utiliser une ou plusieurs fonctionnalit�s de mandataire 60 particuli�res, chargez <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> <em>et</em> le(s) 61 module(s) appropri�(s) dans le serveur (soit statiquement � la 62 compilation, soit dynamiquement via la directive <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code>).</p> 63 64 <p>En outre, d'autres modules fournissent des fonctionnalit�s 65 �tendues. <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code> et ses modules associ�s 66 fournissent la mise en cache. Les directives <code>SSLProxy*</code> 67 du module <code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code> permettent de contacter des 68 serveurs distants en utilisant le protocole SSL/TLS. Ces modules 69 additionnels devront �tre charg�s et configur�s pour pouvoir 70 disposer de ces fonctionnalit�s.</p> 71</div> 72<div id="quickview"><h3 class="directives">Directives</h3> 73<ul id="toc"> 74<li><img alt="" src="/images/down.gif" /> <a href="#allowconnect">AllowCONNECT</a></li> 75<li><img alt="" src="/images/down.gif" /> <a href="#balancermember">BalancerMember</a></li> 76<li><img alt="" src="/images/down.gif" /> <a href="#noproxy">NoProxy</a></li> 77<li><img alt="" src="/images/down.gif" /> <a href="#proxy"><Proxy></a></li> 78<li><img alt="" src="/images/down.gif" /> <a href="#proxybadheader">ProxyBadHeader</a></li> 79<li><img alt="" src="/images/down.gif" /> <a href="#proxyblock">ProxyBlock</a></li> 80<li><img alt="" src="/images/down.gif" /> <a href="#proxydomain">ProxyDomain</a></li> 81<li><img alt="" src="/images/down.gif" /> <a href="#proxyerroroverride">ProxyErrorOverride</a></li> 82<li><img alt="" src="/images/down.gif" /> <a href="#proxyftpdircharset">ProxyFtpDirCharset</a></li> 83<li><img alt="" src="/images/down.gif" /> <a href="#proxyiobuffersize">ProxyIOBufferSize</a></li> 84<li><img alt="" src="/images/down.gif" /> <a href="#proxymatch"><ProxyMatch></a></li> 85<li><img alt="" src="/images/down.gif" /> <a href="#proxymaxforwards">ProxyMaxForwards</a></li> 86<li><img alt="" src="/images/down.gif" /> <a href="#proxypass">ProxyPass</a></li> 87<li><img alt="" src="/images/down.gif" /> <a href="#proxypassinterpolateenv">ProxyPassInterpolateEnv</a></li> 88<li><img alt="" src="/images/down.gif" /> <a href="#proxypassmatch">ProxyPassMatch</a></li> 89<li><img alt="" src="/images/down.gif" /> <a href="#proxypassreverse">ProxyPassReverse</a></li> 90<li><img alt="" src="/images/down.gif" /> <a href="#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></li> 91<li><img alt="" src="/images/down.gif" /> <a href="#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></li> 92<li><img alt="" src="/images/down.gif" /> <a href="#proxypreservehost">ProxyPreserveHost</a></li> 93<li><img alt="" src="/images/down.gif" /> <a href="#proxyreceivebuffersize">ProxyReceiveBufferSize</a></li> 94<li><img alt="" src="/images/down.gif" /> <a href="#proxyremote">ProxyRemote</a></li> 95<li><img alt="" src="/images/down.gif" /> <a href="#proxyremotematch">ProxyRemoteMatch</a></li> 96<li><img alt="" src="/images/down.gif" /> <a href="#proxyrequests">ProxyRequests</a></li> 97<li><img alt="" src="/images/down.gif" /> <a href="#proxyset">ProxySet</a></li> 98<li><img alt="" src="/images/down.gif" /> <a href="#proxystatus">ProxyStatus</a></li> 99<li><img alt="" src="/images/down.gif" /> <a href="#proxytimeout">ProxyTimeout</a></li> 100<li><img alt="" src="/images/down.gif" /> <a href="#proxyvia">ProxyVia</a></li> 101</ul> 102<h3>Sujets</h3> 103<ul id="topics"> 104<li><img alt="" src="/images/down.gif" /> <a href="#forwardreverse">Mandataires directs et 105 mandataires/passerelles inverses</a></li> 106<li><img alt="" src="/images/down.gif" /> <a href="#examples">Exemples simples</a></li> 107<li><img alt="" src="/images/down.gif" /> <a href="#workers">Gestionnaires de serveurs (workers)</a></li> 108<li><img alt="" src="/images/down.gif" /> <a href="#access">Contr�ler l'acc�s � votre 109 mandataire</a></li> 110<li><img alt="" src="/images/down.gif" /> <a href="#startup">Ralentissement au d�marragep</a></li> 111<li><img alt="" src="/images/down.gif" /> <a href="#intranet">Mandataire d'Intranet</a></li> 112<li><img alt="" src="/images/down.gif" /> <a href="#envsettings">Ajustements relatifs au 113 protocole</a></li> 114<li><img alt="" src="/images/down.gif" /> <a href="#request-bodies">Corps de requ�tes</a></li> 115<li><img alt="" src="/images/down.gif" /> <a href="#x-headers">En-t�tes de requ�te du mandataire 116 inverse</a></li> 117</ul><h3>Voir aussi</h3> 118<ul class="seealso"> 119<li><code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code></li> 120<li><code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code></li> 121<li><code class="module"><a href="/mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code></li> 122<li><code class="module"><a href="/mod/mod_proxy_connect.html">mod_proxy_connect</a></code></li> 123<li><code class="module"><a href="/mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></li> 124<li><code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code></li> 125</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> 126<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 127<div class="section"> 128<h2><a name="forwardreverse" id="forwardreverse">Mandataires directs et 129 mandataires/passerelles inverses</a></h2> 130 <p>Apache peut �tre configur� dans les deux modes mandataire 131 <dfn>direct</dfn> et mandataire <dfn>inverse</dfn> (aussi nomm� 132 mode <dfn>passerelle</dfn>).</p> 133 134 <p>Un <dfn>mandataire direct</dfn> standard est un serveur 135 interm�diaire qui s'intercale entre le client et le <em>serveur 136 demand�</em>. Pour obtenir un contenu h�berg� par 137 le serveur demand�, le client envoie une requ�te au 138 mandataire en nommant le serveur demand� comme 139 cible, puis le mandataire extrait le contenu depuis le 140 serveur demand� et le renvoie enfin au client. Le client doit �tre 141 configur� de mani�re appropri�e pour pouvoir utiliser le mandataire 142 direct afin d'acc�der � d'autres sites.</p> 143 144 <p>L'acc�s � Internet depuis des clients situ�s derri�re un 145 pare-feu est une utilisation typique du mandataire direct. Le 146 mandataire direct peut aussi utiliser la mise en cache (fournie 147 par <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code>) pour r�duire la charge du 148 r�seau.</p> 149 150 <p>La fonctionnalit� de mandataire direct est activ�e via la 151 directive <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code>. 152 Comme les mandataires directs permettent aux clients d'acc�der � 153 des sites quelconques via votre serveur et de dissimuler leur 154 v�ritable origine, il est indispensable de <a href="#access">s�curiser votre serveur</a> de fa�on � ce que seuls 155 les clients autoris�s puissent acc�der � votre serveur avant 156 d'activer la fonctionnalit� de mandataire direct.</p> 157 158 <p>Un <dfn>mandataire inverse</dfn> (ou <dfn>passerelle</dfn>), 159 quant � lui, appara�t au client comme un serveur web standard. 160 Aucune configuration particuli�re du client n'est n�cessaire. Le 161 client adresse ses demandes de contenus ordinaires dans l'espace 162 de nommage du mandataire inverse. Ce dernier d�cide alors o� 163 envoyer ces requ�tes, et renvoie le contenu au client comme s'il 164 l'h�bergeait lui-m�me.</p> 165 166 <p>L'acc�s des utilisateurs � Internet pour un serveur situ� 167 derri�re un pare-feu est une utilisation typique du mandataire 168 inverse. On peut aussi utiliser les mandataires inverses pour 169 mettre en oeuvre une r�partition de charge entre plusieurs 170 serveurs en arri�re-plan, ou fournir un cache pour un serveur 171 d'arri�re-plan plus lent. Les mandataires inverses peuvent aussi 172 tout simplement servir � rassembler plusieurs serveurs dans le 173 m�me espace de nommage d'URLs.</p> 174 175 <p>La fonctionnalit� de mandataire inverse est activ�e via la 176 directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> ou 177 le drapeau <code>[P]</code> de la directive <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>. Il n'est 178 <strong>pas</strong> n�cessaire de d�finir <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> � on pour configurer 179 un mandataire inverse.</p> 180 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 181<div class="section"> 182<h2><a name="examples" id="examples">Exemples simples</a></h2> 183 184 <p>Les exemples ci-dessous illustrent de mani�re tr�s basique la 185 mise en oeuvre de la fonctionnalit� de mandataire et ne sont l� que 186 pour vous aider � d�marrer. Reportez-vous � la documentation de 187 chaque directive.</p> 188 189 <p>Si en outre, vous d�sirez activer la mise en cache, consultez la 190 documentation de <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code>.</p> 191 192 <div class="example"><h3>Mandataire inverse</h3><p><code> 193 ProxyPass /foo http://foo.example.com/bar<br /> 194 ProxyPassReverse /foo http://foo.example.com/bar 195 </code></p></div> 196 197 <div class="example"><h3>Mandataire direct</h3><p><code> 198 ProxyRequests On<br /> 199 ProxyVia On<br /> 200 <br /> 201 <Proxy *><br /> 202 <span class="indent"> 203 Order deny,allow<br /> 204 Deny from all<br /> 205 Allow from interne.example.com<br /> 206 </span> 207 </Proxy> 208 </code></p></div> 209 210 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 211<div class="section"> 212<h2><a name="workers" id="workers">Gestionnaires de serveurs (workers)</a></h2> 213 <p>Le mandataire g�re la configuration des serveurs originaux, 214 ainsi que leurs param�tres de communication dans des objets 215 appel�s <dfn>workers</dfn> ou Gestionnaires de serveur. Deux 216 workers int�gr�s par d�faut sont disponibles : le worker de 217 mandataire direct et le worker de mandataire inverse. Des workers 218 suppl�mentaires peuvent �tre configur�s explicitement.</p> 219 220 <p>Les deux workers par d�faut ont une configuration fixe et 221 seront utilis�s si aucun autre worker ne correspond � la requ�te. 222 Ils n'utilisent ni les connexions HTTP persistantes, ni les jeux 223 de connexions. Les connexions TCP vers le serveur original seront 224 donc ouvertes et ferm�es pour chaque requ�te.</p> 225 226 <p>Les workers configur�s explicitement sont identifi�s par leur 227 URL. Dans le cas d'un mandataire inverse, ils sont g�n�ralement 228 cr��s et configur�s via les directives <code class="directive"><a href="#proxypass">ProxyPass</a></code> ou <code class="directive"><a href="#proxypassmatch">ProxyPassMatch</a></code> :</p> 229 230 <div class="example"><p><code> 231 ProxyPass /example http://backend.example.com connectiontimeout=5 timeout=30 232 </code></p></div> 233 234 <p>Cet exemple cr�e un worker associ� � l'URL du serveur original 235 <code>http://backend.example.com</code>, et utilisant les d�lais 236 sp�cifi�s. Dans le cas d'un mandataire direct, les workers sont 237 g�n�ralement d�finis via la directive <code class="directive"><a href="#proxyset">ProxySet</a></code> directive :</p> 238 239 <div class="example"><p><code> 240 ProxySet http://backend.example.com connectiontimeout=5 timeout=30 241 </code></p></div> 242 243 <p>ou encore via une combinaison des directives <code class="directive"><a href="#proxy">Proxy</a></code> et <code class="directive"><a href="#proxyset">ProxySet</a></code> :</p> 244 245 <div class="example"><p><code> 246 <Proxy http://backend.example.com><br /> 247 <span class="indent"> 248 ProxySet connectiontimeout=5 timeout=30 249 </span> 250 </Proxy> 251 </code></p></div> 252 253 <p>L'utilisation de workers configur�s explicitement dans le mode 254 direct n'est pas tr�s courante, car les mandataires directs 255 communiquent avec de nombreux serveurs originaux. Il est cependant 256 int�ressant de cr�er des workers explicites pour certains serveurs 257 originaux si ces derniers sont utilis�s tr�s souvent. Les workers 258 configur�s explicitement n'ont en eux-m�mes aucun concept de 259 mandataire direct ou inverse. Ils encapsulent un concept de 260 communication commun avec les serveurs originaux. Un worker cr�� 261 via la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> pour �tre utilis� avec un 262 mandataire inverse, sera aussi utilis� pour les requ�tes mandat�es 263 en direct chaque fois que l'URL du serveur original correspondra � 264 l'URL du worker, et vice versa.</p> 265 266 <p>L'URL identifiant un worker direct correspond � l'URL de son 267 serveur original comportant tout �l�ment de chemin �ventuel :</p> 268 269 <div class="example"><p><code> 270 ProxyPass /examples http://backend.example.com/examples<br /> 271 ProxyPass /docs http://backend.example.com/docs 272 </code></p></div> 273 274 <p>Cet exemple d�finit deux workers diff�rents, chacun d'entre eux 275 utilisant une configuration et un jeu de connexions s�par�s.</p> 276 277 <div class="warning"><h3>Partage de worker</h3> 278 <p>Le partage de worker se produit lorsque les URLs des workers 279 se chevauchent, c'est � dire lorsque l'URL d'un worker 280 correspond � une partie du d�but de l'URL d'un autre worker 281 d�fini plus loin dans le fichier de configuration. Dans 282 l'exemple suivant,</p> 283 284 <div class="example"><p><code> 285 ProxyPass /apps http://backend.example.com/ timeout=60<br /> 286 ProxyPass /examples http://backend.example.com/examples timeout=10 287 </code></p></div> 288 289 <p>le second worker n'est pas vraiment cr��. C'est le premier 290 worker qui est utilis� � sa place. L'avantage de ceci r�side 291 dans le fait qu'il n'y a plus qu'un jeu de connexions, celles-ci 292 �tant donc r�utilis�es plus souvent. Notez que tous les 293 attributs de configuration d�finis explicitement pour le second 294 worker et certaines valeurs par d�faut vont �craser la 295 configuration d�finie pour le premier worker, ce qui va 296 provoquer la journalisation d'un avertissement. Dans l'exemple 297 pr�c�dent, la valeur de d�lai finale pour l'URL 298 <code>/apps</code> sera <code>10</code> au lieu de <code>60</code> !</p> 299 300 <p>Pour �viter ce partage, classez vos d�finitions de workers de 301 l'URL la plus longue � la plus courte. Si au contraire, vous 302 voulez favoriser ce partage, utilisez l'ordre de classement 303 inverse. Voir aussi l'avertissement en rapport � propos de 304 l'ordre de classement des directives <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p> 305 306 </div> 307 308 <p>Les workers configur�s explicitement sont de deux sortes : 309 <dfn>workers directs</dfn> et <dfn>workers � r�partition (de 310 charge)</dfn>. Ils supportent de nombreux attributs de 311 configuration importants d�crits ci-dessous dans la directive 312 <code class="directive"><a href="#proxypass">ProxyPass</a></code>. Tous ces 313 attributs peuvent aussi �tre d�finis via la directive <code class="directive"><a href="#proxyset">ProxySet</a></code>.</p> 314 315 <p>Le jeu d'options disponibles pour un worker direct d�pend du 316 protocole, qui est sp�cifi� dans l'URL du serveur original. Parmi 317 les protocoles disponibles, on trouve <code>ajp</code>, 318 <code>ftp</code>, <code>http</code> et <code>scgi</code>.</p> 319 320 <p>Les workers � r�partition sont des workers virtuels qui 321 utilisent des workers directs consid�r�s comme leurs membres pour 322 le traitement effectif des requ�tes. Chaque r�partiteur peut 323 poss�der plusieurs membres. Pour traiter une requ�te, il choisit 324 un de ses membres en fonction de l'algorithme de r�partition de 325 charge d�fini.</p> 326 327 <p>Un worker � r�partition est cr�� si son URL utilise 328 <code>balancer</code> comme protocole. L'URL de r�partition 329 identifie de mani�re unique le worker � r�partition. On peut 330 ajouter des membres � un r�partiteur via la directive <code class="directive"><a href="#balancermember">BalancerMember</a></code>.</p> 331 332 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 333<div class="section"> 334<h2><a name="access" id="access">Contr�ler l'acc�s � votre 335 mandataire</a></h2> 336 <p>Vous pouvez restreindre l'acc�s � votre mandataire via le bloc 337 de contr�le <code class="directive"><a href="#proxy"><Proxy></a></code> comme dans 338 l'exemple suivant :</p> 339 340 <div class="example"><p><code> 341 <Proxy *><br /> 342 <span class="indent"> 343 Order Deny,Allow<br /> 344 Deny from all<br /> 345 Allow from 192.168.0<br /> 346 </span> 347 </Proxy> 348 </code></p></div> 349 350 <p>Pour plus de d�tails sur les directives de contr�le d'acc�s, 351 voir la documentation du module 352 <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code>.</p> 353 354 <p>Restreindre l'acc�s de mani�re stricte est essentiel si vous 355 mettez en oeuvre un mandataire direct (en d�finissant la directive 356 <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> � "on"). 357 Dans le cas contraire, votre serveur pourrait �tre utilis� par 358 n'importe quel client pour acc�der � des serveurs quelconques, 359 tout en masquant sa v�ritable identit�. Ceci repr�sente un danger 360 non seulement pour votre r�seau, mais aussi pour l'Internet au 361 sens large. Dans le cas de la mise en oeuvre d'un mandataire 362 inverse (en utilisant la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> avec <code>ProxyRequests Off</code>), le contr�le 363 d'acc�s est moins critique car les clients ne peuvent contacter 364 que les serveurs que vous avez sp�cifi�s.</p> 365 366 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 367<div class="section"> 368<h2><a name="startup" id="startup">Ralentissement au d�marragep</a></h2> 369 <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 370 IP puis ces derni�res mises en cache au cours du d�marrage 371 � des fins de tests de comparaisons ult�rieurs. Ce processus peut 372 durer plusieurs secondes (ou d'avantage) en fonction de la vitesse 373 � laquelle s'effectue la r�solution des noms d'h�tes.</p> 374 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 375<div class="section"> 376<h2><a name="intranet" id="intranet">Mandataire d'Intranet</a></h2> 377 <p>Un serveur mandataire Apache situ� � l'int�rieur d'un Intranet 378 doit faire suivre les requ�tes destin�es � un serveur externe � 379 travers le pare-feu de l'entreprise (pour ce faire, d�finissez la 380 directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code> de 381 fa�on � ce qu'elle fasse suivre le <var>protocole</var> concern� 382 vers le mandataire du pare-feu). Cependant, lorsqu'il doit acc�der 383 � des ressources situ�es dans l'Intranet, il peut se passer du 384 pare-feu pour acc�der aux serveurs. A cet effet, la directive 385 <code class="directive"><a href="#noproxy">NoProxy</a></code> permet de 386 sp�cifier quels h�tes appartiennent � l'Intranet et peuvent donc 387 �tre acc�d�s directement.</p> 388 389 <p>Les utilisateurs d'un Intranet ont tendance � oublier le nom du 390 domaine local dans leurs requ�tes WWW, et demandent par exemple 391 "http://un-serveur/" au lieu de 392 <code>http://un-serveur.example.com/</code>. Certains serveurs 393 mandataires commerciaux acceptent ce genre de requ�te et les 394 traitent simplement en utilisant un nom de domaine local 395 implicite. Lorsque la directive <code class="directive"><a href="#proxydomain">ProxyDomain</a></code> est utilis�e et si le 396 serveur est <a href="#proxyrequests">configur� comme 397 mandataire</a>, Apache peut renvoyer une r�ponse de redirection et 398 ainsi fournir au client l'adresse de serveur correcte, 399 enti�rement qualifi�e. C'est la m�thode � privil�gier car le 400 fichier des marque-pages de l'utilisateur contiendra alors des 401 noms de serveurs enti�rement qualifi�s.</p> 402 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 403<div class="section"> 404<h2><a name="envsettings" id="envsettings">Ajustements relatifs au 405 protocole</a></h2> 406 <p>Pour les cas o� <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> envoie des requ�tes 407 vers un serveur qui n'impl�mente pas correctement les connexions 408 persistantes ou le protocole HTTP/1.1, il existe deux variables 409 d'environnement qui permettent de forcer les requ�tes � utiliser 410 le protocole HTTP/1.0 avec connexions non persistantes. Elles 411 peuvent �tre d�finies via la directive <code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code>.</p> 412 413 <p>Il s'agit des variables <code>force-proxy-request-1.0</code> et 414 <code>proxy-nokeepalive</code>.</p> 415 416 <div class="example"><p><code> 417 <Location /serveur-non-conforme/><br /> 418 <span class="indent"> 419 ProxyPass http://serveur-non-conforme:7001/foo/<br /> 420 SetEnv force-proxy-request-1.0 1<br /> 421 SetEnv proxy-nokeepalive 1<br /> 422 </span> 423 </Location> 424 </code></p></div> 425 426 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 427<div class="section"> 428<h2><a name="request-bodies" id="request-bodies">Corps de requ�tes</a></h2> 429 430 <p>Certaines m�thodes de requ�tes comme POST comportent un corps de 431 requ�te. Le protocole HTTP stipule que les requ�tes qui comportent 432 un corps doivent soit utiliser un codage de transmission 433 fractionn�e, soit envoyer un en-t�te de requ�te 434 <code>Content-Length</code>. Lorsqu'il fait suivre ce genre de 435 requ�te vers le serveur demand�, <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code> 436 s'efforce toujours d'envoyer l'en-t�te <code>Content-Length</code>. 437 Par contre, si la taille du corps est importante, et si la requ�te 438 originale utilise un codage � fractionnement, ce dernier peut aussi 439 �tre utilis� dans la requ�te montante. Ce comportement peut �tre 440 contr�l� � l'aide de <a href="/env.html">variables 441 d'environnement</a>. Ainsi, si elle est d�finie, la variable 442 <code>proxy-sendcl</code> assure une compatibilit� maximale avec les 443 serveurs demand�s en imposant l'envoi de l'en-t�te 444 <code>Content-Length</code>, alors que 445 <code>proxy-sendchunked</code> diminue la consommation de ressources 446 en imposant l'utilisation d'un codage � fractionnement.</p> 447 448 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 449<div class="section"> 450<h2><a name="x-headers" id="x-headers">En-t�tes de requ�te du mandataire 451 inverse</a></h2> 452 453 <p>Lorsqu'il est configur� en mode mandataire inverse (en utilisant 454 par exemple la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>), 455 <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code> ajoute plusieurs en-t�tes de requ�te 456 afin de transmettre des informations au serveur demand�. Ces 457 en-t�tes sont les suivants :</p> 458 459 <dl> 460 <dt><code>X-Forwarded-For</code></dt> 461 <dd>L'adresse IP du client.</dd> 462 <dt><code>X-Forwarded-Host</code></dt> 463 <dd>L'h�te d'origine demand� par le client dans l'en-t�te de 464 requ�te HTTP <code>Host</code>.</dd> 465 <dt><code>X-Forwarded-Server</code></dt> 466 <dd>Le nom d'h�te du serveur mandataire.</dd> 467 </dl> 468 469 <p>Ces en-t�tes doivent �tre utilis�s avec pr�cautions sur le 470 serveur demand�, car ils contiendront plus d'une valeur (s�par�es 471 par des virgules) si la requ�te original contenait d�j� un de ces 472 en-t�tes. Par exemple, vous pouvez utiliser 473 <code>%{X-Forwarded-For}i</code> dans la cha�ne de format du journal 474 du serveur demand� pour enregistrer les adresses IP des clients 475 originaux, mais il est possible que vous obteniez plusieurs adresses 476 si la requ�te passe � travers plusieurs mandataires.</p> 477 478 <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 479 de contr�ler d'autres en-t�tes de requ�te.</p> 480 481 </div> 482<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 483<div class="directive-section"><h2><a name="AllowCONNECT" id="AllowCONNECT">AllowCONNECT</a> <a name="allowconnect" id="allowconnect">Directive</a></h2> 484<table class="directive"> 485<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ports autoris�s � se <code>CONNECT</code>er � travers le 486mandataire</td></tr> 487<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowCONNECT <var>port</var> [<var>port</var>] ...</code></td></tr> 488<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AllowCONNECT 443 563</code></td></tr> 489<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 490<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 491<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 492</table> 493 <p>La directive <code class="directive">AllowCONNECT</code> permet de 494 sp�cifier une liste de num�ros de ports auxquels la m�thode de 495 mandataire <code>CONNECT</code> pourra se connecter. Les navigateurs 496 d'aujourd'hui utilisent cette m�thode dans le cas o� une connexion 497 <code>https</code> est requise et o� le tunneling mandataire sur 498 HTTP est en service.</p> 499 500 <p>Par d�faut, seuls les ports par d�fauts https (<code>443</code>) 501 et snews (<code>563</code>) sont pris en compte. Vous pouvez 502 utiliser la directive <code class="directive">AllowCONNECT</code> pour 503 outrepasser ces valeurs par d�faut et n'autoriser les connexions que 504 vers les ports sp�cifi�s.</p> 505 506 <p>Notez que le module <code class="module"><a href="/mod/mod_proxy_connect.html">mod_proxy_connect</a></code> doit �tre 507 charg� dans le serveur pour pouvoir acc�der au support de 508 <code>CONNECT</code>.</p> 509 510</div> 511<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 512<div class="directive-section"><h2><a name="BalancerMember" id="BalancerMember">BalancerMember</a> <a name="balancermember" id="balancermember">Directive</a></h2> 513<table class="directive"> 514<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un membre � un groupe de r�partition de 515charge</td></tr> 516<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> 517<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire</td></tr> 518<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 519<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 520<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.2 d'Apache.</td></tr> 521</table> 522 <p>Cette directive parmet d'ajouter un membre � un groupe de 523 r�partition de charge. Elle peut se trouver dans un conteneur 524 <code><Proxy <var>balancer://</var>...></code>, et accepte 525 tous les param�tres de paires cl�/valeur que supporte la directive 526 <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p> 527 <p>L'argument balancerurl n'est requis que s'il ne se trouve pas 528 d�j� dans la directive de conteneur <code><Proxy 529 <var>balancer://</var>...></code>. Il correspond � l'URL d'un 530 r�partiteur de charge d�fini par une directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p> 531 532</div> 533<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 534<div class="directive-section"><h2><a name="NoProxy" id="NoProxy">NoProxy</a> <a name="noproxy" id="noproxy">Directive</a></h2> 535<table class="directive"> 536<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Serveurs, domaines ou r�seaux auquels on se connectera 537directement</td></tr> 538<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NoProxy <var>domaine</var> [<var>domaine</var>] ...</code></td></tr> 539<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 540<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 541<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 542</table> 543 <p>Cette directive n'a d'utilit� que pour les serveurs mandataires 544 Apache au sein d'Intranets. La directive 545 <code class="directive">NoProxy</code> permet de sp�cifier une liste de 546 sous-r�seaux, d'adresses IP, de serveurs et/ou de domaines s�par�s 547 par des espaces. Une requ�te pour un serveur qui correspond � un ou 548 plusieurs crit�res sera toujours servie par ce serveur directement, 549 sans �tre redirig�e vers le(s) serveur(s) mandataire(s) d�fini(s) par 550 la directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code>.</p> 551 552 <div class="example"><h3>Exemple</h3><p><code> 553 ProxyRemote * http://pare-feu.example.com:81<br /> 554 NoProxy .example.com 192.168.112.0/21 555 </code></p></div> 556 557 <p>Le type des arguments <var>serveur</var> de la directive 558 <code class="directive">NoProxy</code> appartiennent � la liste suivante 559 :</p> 560 561 <dl> 562 563 <dt><var><a name="domain" id="domain">Domaine</a></var></dt> 564 <dd> 565 <p>Un <dfn>domaine</dfn> est ici un nom de domaine DNS partiellement 566 qualifi� pr�c�d� d'un point. Il repr�sente une liste de serveurs qui 567 appartiennent logiquement au m�me domaine ou � la m�me zonz DNS 568 (en d'autres termes, les nom des serveurs se terminent tous par 569 <var>domaine</var>).</p> 570 571 <div class="example"><h3>Exemple</h3><p><code> 572 .com .apache.org. 573 </code></p></div> 574 575 <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 576 syntaxique et 577 s�mantique, un domaine DNS pouvant aussi avoir un enregistrement DNS 578 de type A !), les <var>domaine</var>s sont toujours sp�cifi�s en les 579 pr�fixant par un point.</p> 580 581 <div class="note"><h3>Note</h3> 582 <p>Les comparaisons de noms de domaines s'effectuent sans tenir 583 compte de la casse, et les parties droites des <var>Domaine</var>s 584 sont toujours cens�es correspondre � la racine de l'arborescence 585 DNS, si bien que les domaines <code>.ExEmple.com</code> et 586 <code>.example.com.</code> (notez le point � la fin du nom) sont 587 consid�r�s comme identiques. Comme une comparaison de domaines ne 588 n�cessite pas de recherche DNS, elle est beaucoup plus efficace 589 qu'une comparaison de sous-r�seaux.</p> 590 </div></dd> 591 592 593 <dt><var><a name="subnet" id="subnet">Sous-r�seau</a></var></dt> 594 <dd> 595 <p>Un <dfn>Sous-r�seau</dfn> est une adresse internet partiellement 596 qualifi�e sous forme num�rique (quatre nombres s�par�s par des 597 points), optionnellement suivie d'un slash et du masque de 598 sous-r�seau sp�cifiant le nombre de bits significatifs dans le 599 <var>Sous-r�seau</var>. Il repr�sente un sous-r�seau de serveurs qui 600 peuvent �tre atteints depuis la m�me interface r�seau. En l'absence 601 de masque de sous-r�seau explicite, il est sous-entendu que les 602 digits manquants (ou caract�res 0) de fin sp�cifient le masque de 603 sous-r�seau (Dans ce cas, le masque de sous-r�seau ne peut �tre 604 qu'un multiple de 8). Voici quelques exemples :</p> 605 606 <dl> 607 <dt><code>192.168</code> ou <code>192.168.0.0</code></dt> 608 <dd>le sous-r�seau 192.168.0.0 avec un masque de sous-r�seau 609 implicite de 16 bits significatifs (parfois exprim� sous la forme 610 <code>255.255.0.0</code>)</dd> 611 <dt><code>192.168.112.0/21</code></dt> 612 <dd>le sous-r�seau <code>192.168.112.0/21</code> avec un masque de 613 sous-r�seau implicite de 21 bits significatifs (parfois exprim� 614 sous la forme<code>255.255.248.0</code>)</dd> 615 </dl> 616 617 <p>Comme cas extr�mes, un <em>Sous-r�seau</em> avec un masque de 618 sous-r�seau de 32 bits significatifs est �quivalent � une <var><a href="#ipaddr">adresse IP</a></var>, alors qu'un <em>Sous-r�seau</em> avec un masque de 619 sous-r�seau de 0 bit significatif (c'est � dire 0.0.0.0/0) est 620 identique � la constante <var>_Default_</var>, et peut correspondre 621 � toute adresse IP.</p></dd> 622 623 624 <dt><var><a name="ipaddr" id="ipaddr">Adresse IP</a></var></dt> 625 <dd> 626 <p>Une <dfn>Adresse IP</dfn> est une adresse internet pleinement 627 qualifi�e sous forme num�rique (quatre nombres s�par�s par des 628 points). En g�n�ral, cette adresse repr�sente un serveur, mais elle 629 ne doit pas n�cessairement correspondre � un nom de domaine DNS.</p> 630 <div class="example"><h3>Exemple</h3><p><code> 631 192.168.123.7 632 </code></p></div> 633 634 <div class="note"><h3>Note</h3> 635 <p>Une <dfn>Adresse IP</dfn> ne n�cessite pas de r�solution DNS, 636 et peut ainsi s'av�rer plus efficace quant aux performances 637 d'Apache.</p> 638 </div></dd> 639 640 641 <dt><var><a name="hostname" id="hostname">Nom de serveur</a></var></dt> 642 <dd> 643 <p>Un <dfn>Nom de serveur</dfn> est un nom de domaine DNS pleinement 644 qualifi� qui peut �tre r�solu en une ou plusieurs adresses IP par le 645 service de noms de domaines DNS. Il repr�sente un h�te logique (par 646 opposition aux <var><a href="#domain">Domaine</a></var>s, voir 647 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 648 d'h�tes avec diff�rentes <var><a href="#ipaddr">adresses 649 IP</a></var>).</p> 650 651 <div class="example"><h3>Exemples</h3><p><code> 652 prep.ai.example.com<br /> 653 www.apache.org 654 </code></p></div> 655 656 <div class="note"><h3>Note</h3> 657 <p>Dans de nombreuses situations, il est plus efficace de 658 sp�cifier une <var><a href="#ipaddr">adresse IP</a></var> qu'un 659 <var>Nom de serveur</var> car cela �vite d'avoir � effectuer une 660 recherche DNS. La r�solution de nom dans Apache peut prendre un 661 temps tr�s long lorsque la connexion avec le serveur de noms 662 utilise une liaison PPP lente.</p> 663 <p>Les comparaisons de <var>Nom de serveur</var> s'effectuent sans tenir 664 compte de la casse, et les parties droites des <var>Noms de serveur</var> 665 sont toujours cens�es correspondre � la racine de l'arborescence 666 DNS, si bien que les domaines <code>WWW.ExEmple.com</code> et 667 <code>www.example.com.</code> (notez le point � la fin du nom) sont 668 consid�r�s comme identiques.</p> 669 </div></dd> 670 </dl> 671 672<h3>Voir aussi</h3> 673<ul> 674<li><a href="/dns-caveats.html">Probl�mes li�s au DNS</a></li> 675</ul> 676</div> 677<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 678<div class="directive-section"><h2><a name="Proxy" id="Proxy"><Proxy></a> <a name="proxy" id="proxy">Directive</a></h2> 679<table class="directive"> 680<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Conteneur de directives s'appliquant � des ressources 681mandat�es</td></tr> 682<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Proxy <var>url-avec-jokers</var>> ...</Proxy></code></td></tr> 683<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 684<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 685<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 686</table> 687 <p>Les directives situ�es dans une section <code class="directive"><Proxy></code> ne s'appliquent qu'au contenu 688 mandat� concern�. Les jokers de style shell sont autoris�s.</p> 689 690 <p>Par eexemple, les lignes suivantes n'autoriseront � acc�der � un 691 contenu via votre serveur mandataire que les h�tes appartenant � 692 <code>votre-reseau.example.com</code> :</p> 693 694 <div class="example"><p><code> 695 <Proxy *><br /> 696 <span class="indent"> 697 Order Deny,Allow<br /> 698 Deny from all<br /> 699 Allow from votre-reseau.example.com<br /> 700 </span> 701 </Proxy> 702 </code></p></div> 703 704 <p>Dans l'exemple suivant, tous les fichiers du r�pertoire 705 <code>foo</code> de <code>example.com</code> seront trait�s par le 706 filtre <code>INCLUDES</code> lorsqu'ils seront envoy�s par 707 l'interm�diaire du serveur mandataire :</p> 708 709 <div class="example"><p><code> 710 <Proxy http://example.com/foo/*><br /> 711 <span class="indent"> 712 SetOutputFilter INCLUDES<br /> 713 </span> 714 </Proxy> 715 </code></p></div> 716 717 718<h3>Voir aussi</h3> 719<ul> 720<li><code class="directive"><a href="#proxymatch"><ProxyMatch></a></code></li> 721</ul> 722</div> 723<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 724<div class="directive-section"><h2><a name="ProxyBadHeader" id="ProxyBadHeader">ProxyBadHeader</a> <a name="proxybadheader" id="proxybadheader">Directive</a></h2> 725<table class="directive"> 726<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 727incorrectes d'une r�ponse</td></tr> 728<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyBadHeader IsError|Ignore|StartBody</code></td></tr> 729<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyBadHeader IsError</code></td></tr> 730<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 731<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 732<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 733<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.0.44 d'Apache</td></tr> 734</table> 735 <p>La directive <code class="directive">ProxyBadHeader</code> permet de 736 d�terminer le comportement de <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> lorsqu'il 737 re�oit des lignes d'en-t�te de r�ponse dont la syntaxe n'est pas valide (c'est 738 � dire ne contenant pas de caract�re ':') en provenance du serveur 739 original. Les arguments disponibles sont :</p> 740 741 <dl> 742 <dt><code>IsError</code></dt> 743 <dd>Annule la requ�te et renvoie une r�ponse de code 502 (mauvaise 744 passerelle). C'est le comportement par d�faut.</dd> 745 746 <dt><code>Ignore</code></dt> 747 <dd>Traite les lignes d'en-t�te incorrectes comme si elles n'avaient 748 pas �t� envoy�es.</dd> 749 750 <dt><code>StartBody</code></dt> 751 <dd>A la r�ception de la premi�re ligne d'en-t�te incorrecte, les 752 autres en-t�tes sont lus et ce qui reste est trait� en tant que 753 corps. Ceci facilite la prise en compte des serveurs d'arri�re-plan 754 bogu�s qui oublient d'ins�rer une ligne vide entre les 755 en-t�tes et le corps.</dd> 756 </dl> 757 758</div> 759<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 760<div class="directive-section"><h2><a name="ProxyBlock" id="ProxyBlock">ProxyBlock</a> <a name="proxyblock" id="proxyblock">Directive</a></h2> 761<table class="directive"> 762<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Termes, serveurs ou domaines bloqu�s par le 763mandataire</td></tr> 764<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyBlock *|<var>terme</var>|<var>serveur</var>|<var>domaine</var> 765[<var>terme</var>|<var>serveur</var>|<var>domaine</var>] ...</code></td></tr> 766<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 767<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 768<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 769</table> 770 <p>La directive <code class="directive">ProxyBlock</code> permet de 771 sp�cifier une liste de termes, serveurs et/ou domaines, s�par�s par 772 des espaces. Les requ�tes de documents HTTP, HTTPS, FTP vers des 773 sites dont les noms contiennent des termes, noms de serveur ou 774 domaine correspondants seront <em>bloqu�s</em> par le serveur 775 mandataire. La module proxy va aussi tenter de d�terminer les 776 adresses IP des items de la liste qui peuvent correspondre � des 777 noms d'h�tes au cours du d�marrage, et les mettra en cache � des 778 fins de comparaisons ult�rieures. Ceci peut ralentir le d�marrage du 779 serveur.</p> 780 781 <div class="example"><h3>Exemple</h3><p><code> 782 ProxyBlock joes-garage.com some-host.co.uk rocky.wotsamattau.edu 783 </code></p></div> 784 785 <p><code>rocky.wotsamattau.edu</code> aurait aussi correspondu s'il 786 avait �t� sp�cifi� par son adresse IP.</p> 787 788 <p>Notez que <code>wotsamattau</code> aurait suffi pour correspondre 789 � <code>wotsamattau.edu</code>.</p> 790 791 <p>Notez aussi que</p> 792 793 <div class="example"><p><code> 794 ProxyBlock * 795 </code></p></div> 796 797 <p>bloque les connexions vers tous les sites.</p> 798 799</div> 800<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 801<div class="directive-section"><h2><a name="ProxyDomain" id="ProxyDomain">ProxyDomain</a> <a name="proxydomain" id="proxydomain">Directive</a></h2> 802<table class="directive"> 803<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom de domaine par d�faut pour les requ�tes 804mandat�es</td></tr> 805<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyDomain <var>Domaine</var></code></td></tr> 806<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 807<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 808<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 809</table> 810 <p>Cette directive n'a d'utilit� que pour les serveurs mandataires 811 Apache au sein d'un Intranet. La directive 812 <code class="directive">ProxyDomain</code> permet de sp�cifier le domaine 813 par d�faut auquel le serveur mandataire apache appartient. Si le 814 serveur re�oit une requ�te pour un h�te sans nom de domaine, il va 815 g�n�rer une r�ponse de redirection vers le m�me h�te suffix� par le 816 <var>Domaine</var> sp�cifi�.</p> 817 818 <div class="example"><h3>Exemple</h3><p><code> 819 ProxyRemote * http://firewall.example.com:81<br /> 820 NoProxy .example.com 192.168.112.0/21<br /> 821 ProxyDomain .example.com 822 </code></p></div> 823 824</div> 825<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 826<div class="directive-section"><h2><a name="ProxyErrorOverride" id="ProxyErrorOverride">ProxyErrorOverride</a> <a name="proxyerroroverride" id="proxyerroroverride">Directive</a></h2> 827<table class="directive"> 828<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Outrepasser les pages d'erreur pour les contenus 829mandat�s</td></tr> 830<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyErrorOverride On|Off</code></td></tr> 831<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyErrorOverride Off</code></td></tr> 832<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 833<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 834<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 835<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.0 d'Apache</td></tr> 836</table> 837 <p>Cette directive est utile pour les configurations de mandataires 838 inverses, lorsque vous souhaitez que les pages d'erreur envoy�es 839 aux utilisateurs finaux pr�sentent un aspect homog�ne. Elle permet 840 aussi l'inclusion de fichiers (via les SSI de 841 <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>) pour obtenir le code d'erreur et agir 842 en cons�quence (le comportement par d�faut afficherait la page 843 d'erreur du serveur mandat�, alors que c'est le message d'erreur SSI 844 qui sera affich� si cette directive est � "on").</p> 845 846 <p>Cette directive n'affecte pas le traitement des r�ponses 847 informatives (1xx), de type succ�s normal (2xx), ou de redirection 848 (3xx).</p> 849 850</div> 851<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 852<div class="directive-section"><h2><a name="ProxyFtpDirCharset" id="ProxyFtpDirCharset">ProxyFtpDirCharset</a> <a name="proxyftpdircharset" id="proxyftpdircharset">Directive</a></h2> 853<table class="directive"> 854<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit le jeu de caract�res des listings FTP 855mandat�s</td></tr> 856<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpDirCharset <var>jeu-caract�res</var></code></td></tr> 857<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyFtpDirCharset ISO-8859-1</code></td></tr> 858<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 859<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 860<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 861<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.2.7 d'Apache</td></tr> 862</table> 863 <p>La directive <code class="directive">ProxyFtpDirCharset</code> permet de 864 d�finir le jeu de caract�res � utiliser pour les listings FTP en 865 HTML g�n�r�s par <code class="module"><a href="/mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>.</p> 866 867</div> 868<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 869<div class="directive-section"><h2><a name="ProxyIOBufferSize" id="ProxyIOBufferSize">ProxyIOBufferSize</a> <a name="proxyiobuffersize" id="proxyiobuffersize">Directive</a></h2> 870<table class="directive"> 871<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�termine la taille du tampon interne de transfert de 872donn�es</td></tr> 873<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyIOBufferSize <var>octets</var></code></td></tr> 874<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyIOBufferSize 8192</code></td></tr> 875<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 876<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 877<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 878</table> 879 <p>La directive <code class="directive">ProxyIOBufferSize</code> permet 880 d'ajuster la taille du tampon interne utilis� comme bloc-note pour 881 les transferts de donn�es entre entr�e et sortie. La taille doit 882 �tre au minimum �gale � <code>8192</code> octets.</p> 883 884 <p>Lorsqu'on utilise <code class="module"><a href="/mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code>, la valeur 885 minimale est align�e sur la limite de 1024 octets, et les valeurs 886 sup�rieures � 65536 octets sont ramen�es � 65536 octets, comme pr�conis� 887 par le protocole AJP.</p> 888 889 <p>Dans la plupart des cas, il n'y a aucune raison de modifier cette 890 valeur.</p> 891 892 893</div> 894<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 895<div class="directive-section"><h2><a name="ProxyMatch" id="ProxyMatch"><ProxyMatch></a> <a name="proxymatch" id="proxymatch">Directive</a></h2> 896<table class="directive"> 897<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Conteneur de directives s'appliquant � des ressources 898mandat�es correspondant � une expression rationnelle</td></tr> 899<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><ProxyMatch <var>regex</var>> ...</ProxyMatch></code></td></tr> 900<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 901<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 902<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 903</table> 904 <p>La directive <code class="directive"><ProxyMatch></code> est 905 identique � la directive <code class="directive"><a href="#proxy"><Proxy></a></code>, � l'exception qu'elle d�finit 906 les URLs auxquelles elle s'applique en utilisant une <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression rationnelle</a>.</p> 907 908<h3>Voir aussi</h3> 909<ul> 910<li><code class="directive"><a href="#proxy"><Proxy></a></code></li> 911</ul> 912</div> 913<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 914<div class="directive-section"><h2><a name="ProxyMaxForwards" id="ProxyMaxForwards">ProxyMaxForwards</a> <a name="proxymaxforwards" id="proxymaxforwards">Directive</a></h2> 915<table class="directive"> 916<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de mandataires � travers lesquelles une 917requ�te peut �tre redirig�e</td></tr> 918<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyMaxForwards <var>nombre</var></code></td></tr> 919<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyMaxForwards -1</code></td></tr> 920<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 921<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 922<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 923<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis Apache 2.0 ; comportement par d�faut 924modifi� dans 2.2.7</td></tr> 925</table> 926 <p>La directive <code class="directive">ProxyMaxForwards</code> permet de 927 sp�cifier le nombre maximum de mandataires � travers lesquels une 928 requ�te peut passer dans le cas o� la la requ�te ne contient pas 929 d'en-t�te <code>Max-Forwards</code>. Ceci permet de se pr�munir 930 contre les boucles infinies de mandataires ou contre les attaques de 931 type d�ni de service.</p> 932 933 <div class="example"><h3>Exemple</h3><p><code> 934 ProxyMaxForwards 15 935 </code></p></div> 936 937 <p>Notez que la d�finition de la directive 938 <code class="directive">ProxyMaxForwards</code> constitue une violation du 939 protocole HTTP/1.1 (RFC2616), qui interdit � un mandataire de 940 d�finir <code>Max-Forwards</code> si le client ne l'a pas fait 941 lui-m�me. Les versions pr�c�dentes d'Apache la d�finissaient 942 syst�matiquement. Une valeur n�gative de 943 <code class="directive">ProxyMaxForwards</code>, y compris la valeur par 944 d�faut -1, implique un comportement compatible avec le protocole, 945 mais vous expose aux bouclages infinis.</p> 946 947</div> 948<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 949<div class="directive-section"><h2><a name="ProxyPass" id="ProxyPass">ProxyPass</a> <a name="proxypass" id="proxypass">Directive</a></h2> 950<table class="directive"> 951<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>R�f�rencer des serveurs distants depuis 952l'espace d'URLs du serveur local</td></tr> 953<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPass [<var>chemin</var>] !|<var>url</var> [<var>cl�=valeur</var> 954 <var>[cl�=valeur</var> ...]] [nocanon] [interpolate]</code></td></tr> 955<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 956<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 957<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 958</table> 959 <p>Cette directive permet r�f�rencer des serveurs distants depuis 960 l'espace d'URLs du serveur local ; le serveur 961 local n'agit pas en tant que mandataire au sens conventionnel, mais 962 plut�t comme miroir du serveur distant. Le serveur local est 963 souvent nomm� <dfn>mandataire inverse</dfn> ou 964 <dfn>passerelle</dfn>. L'argument <var>chemin</var> est le nom d'un 965 chemin virtuel local ; <var>url</var> est une URL partielle pour le 966 serveur distant et ne doit pas contenir de cha�ne d'arguments.</p> 967 968 <div class="warning">En g�n�ral, la directive <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> doit �tre d�finie � 969 <strong>off</strong> lorsqu'on utilise la directive 970 <code class="directive">ProxyPass</code>.</div> 971 972 <p>Supposons que le serveur local a pour adresse 973 <code>http://example.com/</code> ; alors la ligne</p> 974 975 <div class="example"><p><code> 976 ProxyPass /miroir/foo/ http://backend.example.com/ 977 </code></p></div> 978 979 <p>va convertir en interne toute requ�te pour 980 <code>http://example.com/miroir/foo/bar</code> en une requ�te 981 mandat�e pour <code>http://backend.example.com/bar</code>.</p> 982 983 <div class="warning"> 984 <p>Si le premier argument se termine par un slash 985 <strong>/</strong>, il doit en �tre de m�me pour le second argument 986 et vice versa. Dans le cas contraire, il risque de manquer des 987 slashes n�cessaires dans la requ�te r�sultante vers le serveur 988 d'arri�re-plan et les r�sulats ne seront pas ceux attendus. 989 </p> 990 </div> 991 992 <p>Le drapeau <code>!</code> permet de soustraire un sous-r�pertoire 993 du mandat inverse, comme dans l'exemple suivant :</p> 994 995 <div class="example"><p><code> 996 ProxyPass /miroir/foo/i !<br /> 997 ProxyPass /miroir/foo http://backend.example.com 998 </code></p></div> 999 1000 <p>va mandater toutes les requ�tes pour <code>/miroir/foo</code> 1001 vers <code>backend.example.com</code>, <em>sauf</em> les requ�tes 1002 pour <code>/miroir/foo/i</code>.</p> 1003 1004 <div class="warning"><h3>Ordre de classement des directives 1005 ProxyPass</h3> 1006 <p>Les directives <code class="directive"><a href="#proxypass">ProxyPass</a></code> et <code class="directive"><a href="#proxypassmatch">ProxyPassMatch</a></code> sont trait�es selon 1007 leur ordre d'apparition dans le fichier de configuration. La 1008 premi�re qui correspond s'applique. Ainsi, vous devez classer les 1009 directives <code class="directive"><a href="#proxypass">ProxyPass</a></code> qui 1010 peuvent entrer en conflit, de l'URL la plus longue � la plus 1011 courte. Dans le cas contraire, les directives dont l'URL 1012 constitue une partie du d�but de l'URL de directives 1013 apparaissant plus loin dans la configuration vont occulter ces 1014 derni�res. Notez que tout ceci est en relation avec le partage de 1015 worker.</p> 1016 1017 <p>Pour les m�mes raisons, les exclusions doivent appara�tre 1018 <em>avant</em> les directives <code class="directive">ProxyPass</code> 1019 g�n�rales.</p> 1020 1021 </div> 1022 1023 <p>Depuis la version 2.1 du serveur HTTP Apache, mod_proxy supporte 1024 les jeux de connexions vers un serveur d'arri�re-plan. Ainsi, les 1025 connexions cr��es � la demande peuvent �tre conserv�es dans un 1026 jeu pour une utilisation ult�rieure. Les limites de la taille 1027 du jeu de connexions et d'autres param�tres peuvent �tre d�finis au 1028 niveau de la directive <code class="directive">ProxyPass</code> via des 1029 arguments <code>cl�=valeur</code> d�crits dans la table ci-dessous.</p> 1030 1031 <p>Par d�faut, mod_proxy permettra de conserver le nombre maximum de 1032 connexions pouvant �tre utilis�es simultan�ment par le processus 1033 enfant concern� du serveur web. Vous pouvez utiliser le param�tre 1034 <code>max</code> pour r�duire ce nombre par rapport � la valeur par 1035 d�faut. Vous pouvez aussi utiliser le param�tre <code>ttl</code> 1036 pour d�finir une dur�e de vie optionnelle ; ainsi, les connections 1037 qui n'ont pas �t� utilis�es au bout de <code>ttl</code> secondes 1038 seront ferm�es. Le param�tre <code>ttl</code> permet aussi 1039 d'emp�cher l'utilisation d'une connexion susceptible d'�tre ferm�e 1040 suite � l'expiration de la dur�e de vie des connexions persistantes 1041 sur le serveur d'arri�re-plan.</p> 1042 1043 <p>Le jeu de connexions est maintenu au niveau de chaque processus 1044 enfant du serveur web, et <code>max</code> et les autres param�tres 1045 ne font l'objet d'aucune coordination entre les diff�rents processus 1046 enfants, sauf bien sur dans le cas o� un seul processus enfant est 1047 permis par la configuration du module multiprocessus.</p> 1048 1049 <div class="example"><p><code> 1050 ProxyPass /example http://backend.example.com max=20 ttl=120 retry=300 1051 </code></p></div> 1052 1053 <table> 1054 <tr><th>Param�tre</th> 1055 <th>D�faut</th> 1056 <th>Description</th></tr> 1057 <tr><td>min</td> 1058 <td>0</td> 1059 <td>Nombre minimum d'entr�es dans le jeu de connexions, sans 1060 rapport avec le nombre r�el de connexions. Ne doit �tre modifi� 1061 par rapport � la valeur par d�faut que dans des circonstances 1062 sp�ciales o� la m�moire du tas associ�e aux connexions 1063 d'arri�re-plan doit �tre pr�allou�e ou conserv�e.</td></tr> 1064 <tr><td>max</td> 1065 <td>1...n</td> 1066 <td>Nombre maximum de connexions permises vers le serveur 1067 d'arri�re-plan. La valeur par d�faut pour cette limite est le 1068 nombre de threads par processus pour le module multiprocessus 1069 actif. Pour le MPM Prefork, la valeur est toujours 1, alors que 1070 pour les autres, on peut la contr�ler via la directive 1071 <code class="directive">ThreadsPerChild</code>.</td></tr> 1072 <tr><td>smax</td> 1073 <td>max</td> 1074 <td>Les entr�es conserv�es du jeu de connexions au dessus de 1075 cette limite sont lib�r�es au cours de certaines op�rations si 1076 elles n'ont pas �t� utilis�es au bout de leur dur�e de vie 1077 d�finie par le param�tre <code>ttl</code>. Si l'entr�e du jeu de 1078 connexions est associ�e � une connexion, cette derni�re sera 1079 alors ferm�e. Ce param�tre ne doit �tre modifi� par rapport � la 1080 valeur par d�faut que dans des circonstances sp�ciales o� les 1081 entr�es du jeu de connexions, et toutes connexions associ�es qui 1082 ont d�pass� leur dur�e de vie doivent �tre respectivement 1083 lib�r�es ou ferm�es plus imp�rativement.</td></tr> 1084 <tr><td>acquire</td> 1085 <td>-</td> 1086 <td>Cette cl� permet de d�finir le d�lai maximum d'attente pour 1087 une connexion libre dans le jeu de connexions, en millisecondes. 1088 S'il n'y a pas de connexion libre dans le jeu, Apache renverra 1089 l'�tat <code>SERVER_BUSY</code> au client. 1090 </td></tr> 1091 <tr><td>connectiontimeout</td> 1092 <td>timeout</td> 1093 <td>D�lai d'attente d'une connexion en secondes. 1094 La dur�e en secondes pendant laquelle Apache va attendre pour 1095 l'�tablissement d'une connexion vers le serveur d'arri�re-plan. 1096 Le d�lai peut �tre sp�cifi� en millisecondes en ajoutant le 1097 suffixe ms. 1098 </td></tr> 1099 <tr><td>disablereuse</td> 1100 <td>Off</td> 1101 <td>Vous pouvez utiliser cette cl� pour forcer mod_proxy � 1102 fermer imm�diatement une connexion vers le serveur 1103 d'arri�re-plan apr�s utilisation, et ainsi d�sactiver le jeu de 1104 connexions permanentes vers ce serveur. Ceci peut s'av�rer utile 1105 dans des situations o� un pare-feu situ� entre Apache et le 1106 serveur d'arri�re-plan (quelque soit le protocole) interrompt 1107 des connexions de mani�re silencieuse, ou lorsque le serveur 1108 d'arri�re-plan lui-m�me est accessible par rotation de DNS 1109 (round-robin DNS). Pour d�sactiver la r�utilisation du jeu de 1110 connexions, d�finissez cette cl� � <code>On</code>. 1111 </td></tr> 1112 <tr><td>flushpackets</td> 1113 <td>off</td> 1114 <td>Permet de d�finir si le module mandataire doit vider 1115 automatiquement le tampon de sortie apr�s chaque tron�on de 1116 donn�es. 'off' signifie que le tampon sera vid� si n�cessaire, 1117 'on' que le tampon sera vid� apr�s chaque envoi d'un 1118 tron�on de donn�es, et 'auto' que le tampon sera vid� apr�s un 1119 d�lai de 'flushwait' millisecondes si aucune entr�e n'est re�ue. 1120 Actuellement, cette cl� n'est support�e que par AJP. 1121 </td></tr> 1122 <tr><td>flushwait</td> 1123 <td>10</td> 1124 <td>Le d�lai d'attente pour une entr�e additionnelle, en 1125 millisecondes, avant le vidage du tampon en sortie dans le cas 1126 o� 'flushpackets' est � 'auto'. 1127 </td></tr> 1128 <tr><td>keepalive</td> 1129 <td>Off</td> 1130 <td><p>Cette cl� doit �tre utilis�e lorsque vous avez un pare-feu 1131 entre Apache httpd et le serveur d'arri�re-plan, et si ce dernier tend 1132 � interrompre les connexions inactives. Cette cl� va faire en 1133 sorte que le syst�me d'exploitation envoie des messages 1134 <code>KEEP_ALIVE</code> sur chacune des connexions inactives et 1135 ainsi �viter la fermeture de la connexion par le pare-feu. 1136 Pour conserver les connexions persistantes, definissez cette 1137 propri�t� � <code>On</code>.</p> 1138 <p>La fr�quence de v�rification des connexions TCP persistantes 1139 initiale et subs�quentes d�pend de la configuration globale de l'OS, 1140 et peut atteindre 2 heures. Pour �tre utile, la fr�quence configur�e 1141 dans l'OS doit �tre inf�rieure au seuil utilis� par le pare-feu.</p> 1142 </td></tr> 1143 <tr><td>lbset</td> 1144 <td>0</td> 1145 <td>D�finit le groupe de r�partition de charge dont le serveur cible 1146 est membre. Le r�partiteur de charge va essayer tous les membres 1147 d'un groupe de r�partition de charge de num�ro inf�rieur avant 1148 d'essayer ceux dont le groupe poss�de un num�ro sup�rieur. 1149 </td></tr> 1150 <tr><td>ping</td> 1151 <td>0</td> 1152 <td>Avec la cl� ping, le serveur web envoie une requ�te 1153 <code>CPING</code> sur la connexion ajp13 avant de rediriger une 1154 requ�te. La valeur correspond au d�lai d'attente de la r�ponse 1155 <code>CPONG</code>. Cette fonctionnalit� a �t� ajout�e afin de 1156 pallier aux probl�mes de blocage et de surcharge des serveurs 1157 Tomcat, et n�cessite le support de ping/pong ajp13 qui a �t� 1158 impl�ment� dans Tomcat 3.3.2+, 4.1.28+ et 5.0.13+. Le trafic 1159 r�seau peut s'en trouver augment� en fonctionnement normal, ce 1160 qui peut poser probl�me, mais peut s'en trouver diminu� dans les 1161 cas o� les noeuds de cluster sont arr�t�s ou surcharg�s. Cette 1162 cl� n'est actuellement utilisable qu'avec AJP. Le d�lai peut 1163 aussi �tre d�fini en millisecondes en ajoutant le suffixe 1164 ms. 1165 </td></tr> 1166 <tr><td>loadfactor</td> 1167 <td>1</td> 1168 <td>Facteur de charge du serveur cible � utiliser avec les 1169 membres d'un groupe de r�partition de charge. Il s'agit d'un 1170 nombre entre 1 et 100 d�finissant le facteur de charge appliqu� 1171 au serveur cible. 1172 </td></tr> 1173 <tr><td>redirect</td> 1174 <td>-</td> 1175 <td>Route pour la redirection du serveur cible. Cette valeur est en 1176 g�n�ral d�finie dynamiquement pour permettre une suppression 1177 s�curis�e du noeud du cluster. Si cette cl� est d�finie, toutes 1178 les requ�tes sans identifiant de session seront redirig�es vers 1179 le membre de groupe de r�partition de charge dont la route 1180 correspond � la valeur de la cl�. 1181 </td></tr> 1182 <tr><td>retry</td> 1183 <td>60</td> 1184 <td>D�lai entre deux essais du serveur cible du jeu de connexions en 1185 secondes. Si le serveur cible du jeu de connexions vers le serveur 1186 d'arri�re-plan est dans un �tat d'erreur, Apache ne redirigera 1187 pas de requ�te vers ce serveur avant l'expiration du d�lai 1188 sp�cifi�. Ceci permet d'arr�ter le serveur d'arri�re-plan pour 1189 maintenance, et de le remettre en ligne plus tard. Une valeur de 1190 0 signifie toujours essayer les serveurs cibles dans un �tat d'erreur 1191 sans d�lai. 1192 </td></tr> 1193 <tr><td>route</td> 1194 <td>-</td> 1195 <td>La route du serveur cible lorsqu'il est utilis� au sein d'un 1196 r�partiteur de charge. La route est une valeur ajout�e � 1197 l'identifiant de session. 1198 </td></tr> 1199 <tr><td>status</td> 1200 <td>-</td> 1201 <td>Valeur constitu�e d'une simple lettre et d�finissant l'�tat 1202 initial de ce serveur cible : 'D' correspond � "d�sactiv�", 'S' � 1203 "arr�t�", 'I' � "erreurs ignor�es", 'H' � "interruption � chaud" 1204 et 'E' � "erreur". Une valeur d'�tat peut �tre d�finie (ce qui 1205 correspond au comportement par d�faut) en pr�fixant la valeur 1206 par '+', ou annul�e en pr�fixant la valeur par '-'. Ainsi, la 1207 valeur 'S-E' d�finit l'�tat de ce serveur cible � "arr�t�" et supprime 1208 le drapeau "en-erreur". 1209 </td></tr> 1210 <tr><td>timeout</td> 1211 <td><code class="directive"><a href="#proxytimeout">ProxyTimeout</a></code></td> 1212 <td>D�lai d'attente de la connexion en secondes. Le nombre de 1213 secondes pendant lesquelles Apache attend l'envoi de 1214 donn�es vers le serveur d'arri�re-plan. 1215 </td></tr> 1216 <tr><td>ttl</td> 1217 <td>-</td> 1218 <td>Dur�e de vie des connexions inactives et des entr�es 1219 associ�es du jeu de connexions. Lorsque cette limite est 1220 atteinte, la connexion concern�e ne sera plus utilis�e ; elle 1221 sera ensuite ferm�e au bout d'un certain temps. 1222 </td></tr> 1223 1224 </table> 1225 1226 <p>Si l'URL de la directive <code class="directive">ProxyPass</code> d�bute par 1227 <code>balancer://</code> (par exemple: 1228 <code>balancer://cluster/</code>, toute information relative au 1229 chemin est ignor�e), alors un serveur cible virtuel ne communiquant pas 1230 r�ellement avec le serveur d'arri�re-plan sera cr��. Celui-ci sera 1231 en fait responsable de la gestion de plusieurs serveurs cibles "r�els". Dans 1232 ce cas, un jeu de param�tres particuliers s'applique � ce serveur cible 1233 virtuel. Voir <code class="module"><a href="/mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> pour plus 1234 d'informations � propos du fonctionnement du r�partiteur de 1235 charge. 1236 </p> 1237 <table> 1238 <tr><th>Param�tre</th> 1239 <th>D�faut</th> 1240 <th>Description</th></tr> 1241 <tr><td>lbmethod</td> 1242 <td>byrequests</td> 1243 <td>M�thode de r�partition de charge utilis�e. Permet de 1244 s�lectionner la m�thode de planification de la r�partition de 1245 charge � utiliser. La valeur est soit <code>byrequests</code>, 1246 pour effectuer un d�compte de requ�tes pond�r�es, soit 1247 <code>bytraffic</code>, pour effectuer une r�partition en 1248 fonction du d�compte des octets transmis, soit 1249 <code>bybusyness</code> (� partir de la version 2.2.10 du 1250 serveur HTTP Apache), pour effectuer une r�partition en 1251 fonction des requ�tes en attente. La valeur par d�faut est 1252 <code>byrequests</code>. 1253 </td></tr> 1254 <tr><td>maxattempts</td> 1255 <td>1 de moins que le nombre de workers, ou 1 avec un seul 1256 worker</td> 1257 <td>Nombre maximum d'�checs avant abandon. 1258 </td></tr> 1259 <tr><td>nofailover</td> 1260 <td>Off</td> 1261 <td>Si ce param�tre est d�fini � <code>On</code>, la session va 1262 s'interrompre si le serveur cible est dans un �tat d'erreur ou 1263 d�sactiv�. D�finissez ce param�tre � On si le serveur 1264 d'arri�re-plan ne supporte pas la r�plication de session. 1265 </td></tr> 1266 <tr><td>stickysession</td> 1267 <td>-</td> 1268 <td>Nom de session persistant du r�partiteur. La valeur est 1269 g�n�ralement du style <code>JSESSIONID</code> ou 1270 <code>PHPSESSIONID</code>, et d�pend du serveur d'application 1271 d'arri�re-plan qui supporte les sessions. Si le serveur 1272 d'application d'arri�re-plan utilise des noms diff�rents pour 1273 les cookies et les identifiants cod�s d'URL (comme les 1274 conteneurs de servlet), s�parez-les par le caract�re '|'. La 1275 premi�re partie contient le cookie et la seconde le chemin. 1276 </td></tr> 1277 <tr><td>scolonpathdelim</td> 1278 <td>Off</td> 1279 <td>Si ce param�tre est d�fini � <code>On</code>, le caract�re 1280 ';' sera utilis� comme s�parateur de chemin de session 1281 persistante additionnel. Ceci permet principalement de simuler 1282 le comportement de mod_jk lorsqu'on utilise des chemins du style 1283 <code>JSESSIONID=6736bcf34;foo=aabfa</code>. 1284 </td></tr> 1285 <tr><td>timeout</td> 1286 <td>0</td> 1287 <td>D�lai du r�partiteur en secondes. Si ce param�tre est 1288 d�fini, sa valeur correspond � la dur�e maximale d'attente pour 1289 un serveur cible libre. Le comportement par d�faut est de ne pas 1290 attendre. 1291 </td></tr> 1292 <tr><td>failonstatus</td> 1293 <td>-</td> 1294 <td>Un code ou une liste de codes d'�tat HTTP s�par�s par des 1295 virgules. S'il est d�fini, ce param�tre va forcer le worker dans 1296 un �tat d'erreur lorsque le serveur d'arri�re-plan retounera un 1297 code d'�tat sp�cifi� dans la liste. Le r�tablissement du worker 1298 est le m�me qu'avec les autres erreurs de worker. 1299 Disponible � partir de la version 2.2.17 du serveur HTTP Apache. 1300 </td></tr> 1301 <tr><td>failontimeout</td> 1302 <td>Off</td> 1303 <td>Si ce param�tre est d�fini � "On", un d�lai d'attente 1304 d�pass� en entr�e/sortie apr�s envoi d'une requ�te au serveur 1305 d'arri�re-plan va mettre le processus en �tat d'erreur. La 1306 sortie de cet �tat d'erreur se passe de la m�me fa�on que pour 1307 les autres erreurs. Disponible � partir de la version 2.2.25 du 1308 serveur HTTP Apache. 1309 </td></tr> 1310 <tr><td>forcerecovery</td> 1311 <td>On</td> 1312 <td>Force la r�cup�ration imm�diate de tous les membres du 1313 r�partiteur sans tenir compte de leur param�tre de nouvel essai 1314 si tous les membres du r�partiteur sont dans un �tat d'erreur. 1315 Dans certains cas cependant, un serveur d'arri�re-plan d�j� 1316 surcharg� peut voir ses probl�mes s'aggraver si la r�cup�ration 1317 de tous les membres du r�partiteur est forc�e sans tenir compte 1318 de leur param�tre de nouvel essai. Dans ce cas, d�finissez ce 1319 param�tre � <code>Off</code>. Disponible depuis la version 1320 2.2.23 du serveur HTTP Apache. 1321 </td></tr> 1322 1323 </table> 1324 <p>Exemple de configuration d'un r�partiteur</p> 1325 <div class="example"><p><code> 1326 ProxyPass /zone-speciale http://special.example.com smax=5 max=10<br /> 1327 ProxyPass / balancer://mon-cluster/ stickysession=JSESSIONID|jsessionid nofailover=On<br /> 1328 <Proxy balancer://mon-cluster><br /> 1329 <span class="indent"> 1330 BalancerMember ajp://1.2.3.4:8009<br /> 1331 BalancerMember ajp://1.2.3.5:8009 loadfactor=20<br /> 1332 # Serveur moins puissant ; faites-lui traiter moins de requ�tes,<br /> 1333 BalancerMember ajp://1.2.3.6:8009 loadfactor=5<br /> 1334 </span> 1335 </Proxy> 1336 </code></p></div> 1337 1338 <p>Configuration d'un serveur cible de r�serve qui ne sera utilis� que si 1339 aucun autre serveur cible n'est disponible</p> 1340 <div class="example"><p><code> 1341 ProxyPass / balancer://hotcluster/ <br /> 1342 <Proxy balancer://hotcluster><br /> 1343 <span class="indent"> 1344 BalancerMember ajp://1.2.3.4:8009 loadfactor=1<br /> 1345 BalancerMember ajp://1.2.3.5:8009 loadfactor=2<br /> 1346 # La ligne suivante configure le serveur cible de r�serve<br /> 1347 BalancerMember ajp://1.2.3.6:8009 status=+H<br /> 1348 ProxySet lbmethod=bytraffic 1349 </span> 1350 </Proxy> 1351 </code></p></div> 1352 1353 <p>Normalement, mod_proxy va mettre sous leur forme canonique les 1354 URLs trait�es par ProxyPass. Mais ceci peut �tre incompatible avec 1355 certains serveurs d'arri�re-plan, et en particulier avec ceux qui 1356 utilisent <var>PATH_INFO</var>. Le mot-cl� optionnel 1357 <var>nocanon</var> modifie ce comportement et permet de transmettre 1358 le chemin d'URL sous sa forme brute au serveur d'arri�re-plan. Notez 1359 que ceci peut affecter la s�curit� de votre serveur d'arri�re-plan, 1360 car la protection limit�e contre les attaques � base d'URL que 1361 fournit le mandataire est alors supprim�e.</p> 1362 1363 <p>Lorsque la directive ProxyPass est utilis�e � l'int�rieur d'une 1364 section <code class="directive"><a href="/mod/core.html#location"><Location></a></code>, le premier argument est omis et le r�pertoire 1365 local est obtenu � partir de la section <code class="directive"><a href="/mod/core.html#location"><Location></a></code>. Il en est de 1366 m�me � l'int�rieur 1367 d'une section <code class="directive"><a href="/mod/core.html#locationmatch"><LocationMatch></a></code> ; cependant, ProxyPass 1368 n'interpr�te pas les expressions rationnelles, et dans ce cas, il 1369 est n�cessaire d'utiliser la directive 1370 <code class="directive">ProxyPassMatch</code>. 1371 </p> 1372 1373 <p>Cette directive ne peut pas �tre plac�e dans une section 1374 <code class="directive"><a href="/mod/core.html#directory"><Directory></a></code> ou 1375 <code class="directive"><a href="/mod/core.html#files"><Files></a></code>.</p> 1376 1377 <p>Si vous avez besoin d'un configuration de mandataire inverse plus 1378 souple, reportez-vous � la documentaion de la directive <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> et son drapeau 1379 <code>[P]</code>.</p> 1380 1381 <p>Le mot-cl� optionnel <var>interpolate</var> (disponible depuis 1382 httpd 2.2.9), en combinaison avec la directive 1383 <code class="directive">ProxyPassInterpolateEnv</code>, permet � ProxyPass 1384 d'interpoler les variables d'environnement � l'aide de la syntaxe 1385 <var>${VARNAME}</var>. Notez que de nombreuses variables 1386 d'environnement standard d�riv�es de CGI n'existeront pas lorsque 1387 l'interpolation se produit ; vous devrez alors encore avoir avoir 1388 recours � <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> pour des r�gles 1389 complexes. Notez aussi que l'interpolation n'est pas support�e dans 1390 la partie protocole d'une URL. La d�termination dynamique du 1391 protocole peut �tre effectu�e � l'aide de 1392 <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> comme dans l'exemple suivant :</p> 1393 1394 <pre class="prettyprint lang-config"> 1395RewriteEngine On 1396 1397RewriteCond %{HTTPS} =off 1398RewriteRule . - [E=protocol:http] 1399RewriteCond %{HTTPS} =on 1400RewriteRule . - [E=protocol:https] 1401 1402RewriteRule ^/mirror/foo/(.*) %{ENV:protocol}://backend.example.com/$1 [P] 1403ProxyPassReverse /mirror/foo/ http://backend.example.com/ 1404ProxyPassReverse /mirror/foo/ https://backend.example.com/ 1405 </pre> 1406 1407 1408 1409</div> 1410<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1411<div class="directive-section"><h2><a name="ProxyPassInterpolateEnv" id="ProxyPassInterpolateEnv">ProxyPassInterpolateEnv</a> <a name="proxypassinterpolateenv" id="proxypassinterpolateenv">Directive</a></h2> 1412<table class="directive"> 1413<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active l'interpolation des variables d'environnement dans 1414les configurations de mandataires inverses</td></tr> 1415<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassInterpolateEnv On|Off</code></td></tr> 1416<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyPassInterpolateEnv Off</code></td></tr> 1417<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 1418<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1419<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1420<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.2.9 d'Apache</td></tr> 1421</table> 1422 <p>Cette directive, ainsi que l'argument <var>interpolate</var> des 1423 directives <code class="directive">ProxyPass</code>, 1424 <code class="directive">ProxyPassReverse</code>, 1425 <code class="directive">ProxyPassReverseCookieDomain</code> et 1426 <code class="directive">ProxyPassReverseCookiePath</code>, permet de 1427 configurer dynamiquement un mandataire inverse � l'aide de 1428 variables d'environnement, ces derni�res pouvant �tre d�finies par un 1429 autre module comme <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>. Elle affecte les 1430 directives <code class="directive">ProxyPass</code>, 1431 <code class="directive">ProxyPassReverse</code>, 1432 <code class="directive">ProxyPassReverseCookieDomain</code>, et 1433 <code class="directive">ProxyPassReverseCookiePath</code>, en leur indiquant 1434 de remplacer la cha�ne <code>${nom_var}</code> dans les directives 1435 de configuration par la valeur de la variable d'environnement 1436 <code>nom_var</code> (si l'option <var>interpolate</var> est 1437 sp�cifi�e).</p> 1438 <p>Conservez cette directive � off (pour les performances du 1439 serveur), sauf si vous en avez r�ellement besoin.</p> 1440 1441</div> 1442<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1443<div class="directive-section"><h2><a name="ProxyPassMatch" id="ProxyPassMatch">ProxyPassMatch</a> <a name="proxypassmatch" id="proxypassmatch">Directive</a></h2> 1444<table class="directive"> 1445<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre des serveurs distants dans l'espace d'URL 1446du serveur local en utilisant des expressions rationnelles</td></tr> 1447<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassMatch [<var>regex</var>] !|<var>url</var> 1448[<var>cl�=valeur</var> 1449 <var>[cl�=valeur</var> ...]]</code></td></tr> 1450<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 1451<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1452<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1453<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.2.5 1454d'Apache</td></tr> 1455</table> 1456 <p>Cette directive est identique � la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>, mais fait usage des 1457 expressions rationnelles, au lieu d'une simple comparaison de 1458 pr�fixes. L'expression rationnelle sp�cifi�e est compar�e � 1459 l'<var>url</var>, et si elle correspond, le serveur va substituer 1460 toute correspondance entre parenth�ses dans la cha�ne donn�e et 1461 l'utiliser comme nouvelle <var>url</var>.</p> 1462 1463 <p>Supposons que le serveur local a pour adresse 1464 <code>http://example.com/</code> ; alors</p> 1465 1466 <div class="example"><p><code> 1467 ProxyPassMatch ^(/.*\.gif)$ http://backend.example.com$1 1468 </code></p></div> 1469 1470 <p>va provoquer la conversion interne de la requ�te locale 1471 <code>http://example.com/foo/bar.gif</code> en une requ�te mandat�e 1472 pour <code>http://backend.example.com/foo/bar.gif</code>.</p> 1473 1474 <div class="note"><h3>Note</h3> 1475 <p>L'argument URL doit pouvoir �tre interpr�t� en tant qu'URL 1476 <em>avant</em> les substitutions d'expressions rationnelles (et 1477 doit aussi l'�tre apr�s). Ceci limite les correspondances que vous 1478 pouvez utiliser. Par exemple, si l'on avait utilis�</p> 1479 <div class="example"><p><code> 1480 ProxyPassMatch ^(/.*\.gif)$ http://backend.example.com:8000$1 1481 </code></p></div> 1482 <p>dans l'exemple pr�c�dent, nous aurions provoqu� une erreur de 1483 syntaxe au d�marrage du serveur. C'est une bogue (PR 46665 dans 1484 ASF bugzilla), et il est possible de la contourner en reformulant 1485 la correspondance :</p> 1486 <div class="example"><p><code> 1487 ProxyPassMatch ^/(.*\.gif)$ http://backend.example.com:8000/$1 1488 </code></p></div> 1489 </div> 1490 1491 <p>Le drapeau <code>!</code> vous permet de ne pas mandater un 1492 sous-r�pertoire donn�.</p> 1493 1494 <p>Lorsque cette directive se situe � l'int�rieur d'une section 1495 <code class="directive"><a href="/mod/core.html#locationmatch"><LocationMatch></a></code>, 1496 le premier argument est omis et l'expression rationnelle est obtenue 1497 � partir de la directive <code class="directive"><a href="/mod/core.html#locationmatch"><LocationMatch></a></code>.</p> 1498 1499 <p>Si vous avez besoin d'une configuration de mandataire inverse 1500 plus flexible, reportez-vous � la directive <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> avec le drapeau 1501 <code>[P]</code>.</p> 1502 1503 <div class="warning"> 1504 <h3>Avertissement � propos de la s�curit�</h3> 1505 <p>Lors de la construction de l'URL cible de la r�gle, il convient 1506 de prendre en compte l'impact en mati�re de s�curit� qu'aura le 1507 fait de permettre au client d'influencer le jeu d'URLs pour 1508 lesquelles votre serveur agira en tant que mandataire. 1509 Assurez-vous que la partie protocole://nom-serveur de l'URL soit 1510 fixe, ou ne permette pas au client de l'influencer induement.</p> 1511 </div> 1512 1513</div> 1514<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1515<div class="directive-section"><h2><a name="ProxyPassReverse" id="ProxyPassReverse">ProxyPassReverse</a> <a name="proxypassreverse" id="proxypassreverse">Directive</a></h2> 1516<table class="directive"> 1517<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 1518par un serveur mandat� en inverse</td></tr> 1519<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverse [<var>chemin</var>] <var>url</var> 1520[<var>interpolate</var>]</code></td></tr> 1521<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 1522<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1523<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1524</table> 1525 <p>Cette directive permet de faire en sorte qu'Apache ajuste l'URL 1526 dans les en-t�tes <code>Location</code>, 1527 <code>Content-Location</code> et <code>URI</code> des r�ponses de 1528 redirection HTTP. Ceci est essentiel lorsqu'Apache est utilis� en 1529 tant que mandataire inverse (ou passerelle), afin d'�viter de 1530 court-circuiter le mandataire inverse suite aux redirections HTTP 1531 sur le serveur d'arri�re-plan qui restent derri�re le mandataire 1532 inverse.</p> 1533 1534 <p>Seuls les en-t�tes de r�ponse HTTP sp�cialement mentionn�s 1535 ci-dessus seront r��crits. Apache ne r��crira ni les autres en-t�tes 1536 de r�ponse, ni les r�f�rences d'URLs dans les pages HTML. Cela 1537 signifie que dans le cas o� un contenu mandat� contient des 1538 r�f�rences � des URLs absolues, elles court-circuiteront le 1539 mandataire. Le module <a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a> 1540 de Nick Kew est un module tiers qui parcourt le code HTML et r��crit 1541 les r�f�rences d'URL.</p> 1542 1543 <p><var>chemin</var> est le nom d'un chemin virtuel local. 1544 <var>url</var> est une URL partielle pour le serveur distant - ils 1545 sont utilis�s de la m�me fa�on qu'avec la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p> 1546 1547 <p>Supposons par exemple que le serveur local a pour adresse 1548 <code>http://example.com/</code> ; alors</p> 1549 1550 <div class="example"><p><code> 1551 ProxyPass /miroir/foo/ http://backend.example.com/<br /> 1552 ProxyPassReverse /miroir/foo/ http://backend.example.com/<br /> 1553 ProxyPassReverseCookieDomain backend.example.com public.example.com<br /> 1554 ProxyPassReverseCookiePath / /miroir/foo/ 1555 </code></p></div> 1556 1557 <p>ne va pas seulement provoquer la conversion interne d'une requ�te 1558 locale pour <code>http://example.com/miroir/foo/bar</code> en une 1559 requ�te mandat�e pour <code>http://backend.example.com/bar</code> 1560 (la fonctionnalit� fournie par <code>ProxyPass</code>). Il va 1561 aussi s'occuper des redirections que le serveur 1562 <code>backend.example.com</code> envoie : lorsque 1563 <code>http://backend.example.com/bar</code> est redirig� par 1564 celui-ci vers <code>http://backend.example.com/quux</code>, Apache 1565 corrige ceci en <code>http://example.com/miroir/foo/quux</code> 1566 avant de faire suivre la redirection HTTP au client. Notez que le 1567 nom d'h�te utilis� pour construire l'URL est choisi en respectant la 1568 d�finition de la directive <code class="directive"><a href="/mod/core.html#usecanonicalname">UseCanonicalName</a></code>.</p> 1569 1570 <p>Notez que la directive <code class="directive">ProxyPassReverse</code> 1571 peut aussi �tre utilis�e en conjonction avec la fonctionnalit� 1572 pass-through (<code>RewriteRule ... [P]</code>) du module 1573 <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>, car elle ne d�pend pas d'une directive 1574 <code class="directive"><a href="#proxypass">ProxyPass</a></code> 1575 correspondante.</p> 1576 1577 <p>Le mot-cl� optionnel <var>interpolate</var> (disponible depuis 1578 httpd 2.2.9), utilis� en combinaison avec la directive 1579 <code class="directive">ProxyPassInterpolateEnv</code>, permet 1580 l'interpolation des variables d'environnement sp�cifi�es en 1581 utilisant le format <var>${VARNAME}</var> Notez que l'interpolation 1582 n'est pas support�e dans la partie protocole d'une URL. 1583 </p> 1584 1585 <p>Lorsque cette directive est utilis�e dans une section <code class="directive"><a href="/mod/core.html#location"><Location></a></code>, le premier 1586 argument est omis et le r�pertoire local est obtenu � partir de 1587 l'argument de la directive <code class="directive"><a href="/mod/core.html#location"><Location></a></code>. Il en est de m�me � l'int�rieur 1588 d'une section <code class="directive"><a href="/mod/core.html#locationmatch"><LocationMatch></a></code>, mais le r�sultat ne 1589 correspondra probablement pas � ce que vous attendez, car 1590 ProxyPassReverse interpr�te l'expression rationnelle litt�ralement 1591 comme un chemin ; si n�cessaire dans cette situation, sp�cifiez la 1592 directive ProxyPassReverse en dehors de la section, ou dans une 1593 section <code class="directive"><a href="/mod/core.html#location"><Location></a></code> 1594 s�par�e. 1595 </p> 1596 1597 <p>Cette directive ne peut pas �tre plac�e dans une section 1598 <code class="directive"><a href="/mod/core.html#directory"><Directory></a></code> ou 1599 <code class="directive"><a href="/mod/core.html#files"><Files></a></code>.</p> 1600 1601</div> 1602<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1603<div class="directive-section"><h2><a name="ProxyPassReverseCookieDomain" id="ProxyPassReverseCookieDomain">ProxyPassReverseCookieDomain</a> <a name="proxypassreversecookiedomain" id="proxypassreversecookiedomain">Directive</a></h2> 1604<table class="directive"> 1605<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajuste la cha�ne correspondant au domaine dans les en-t�tes 1606Set-Cookie en provenance d'un serveur mandat�</td></tr> 1607<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverseCookieDomain <var>domaine-interne</var> 1608<var>domaine-public</var> [<var>interpolate</var>]</code></td></tr> 1609<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 1610<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1611<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1612</table> 1613<p>L'utilisation de cette directive est similaire � celle de la 1614directive <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>, 1615mais au lieu de r��crire des en-t�tes qui contiennent des URLs, elle 1616r��crit la cha�ne correspondant au domaine dans les en-t�tes 1617<code>Set-Cookie</code>.</p> 1618 1619</div> 1620<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1621<div class="directive-section"><h2><a name="ProxyPassReverseCookiePath" id="ProxyPassReverseCookiePath">ProxyPassReverseCookiePath</a> <a name="proxypassreversecookiepath" id="proxypassreversecookiepath">Directive</a></h2> 1622<table class="directive"> 1623<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajuste la cha�ne correspondant au chemin dans les en-t�tes 1624Set-Cookie en provenance d'un serveur mandat�</td></tr> 1625<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverseCookiePath <var>chemin-interne</var> 1626<var>chemin-public</var> [<var>interpolate</var>]</code></td></tr> 1627<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 1628<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1629<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1630</table> 1631<p> 1632Cette directive s'av�re utile en conjonction avec la directive 1633<code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code> dans les 1634situations o� les chemins d'URL d'arri�re-plan correspondent � des 1635chemins publics sur le mandataire inverse. Cette directive permet de 1636r��crire la cha�ne <code>path</code> dans les en-t�tes 1637<code>Set-Cookie</code>. Si le d�but du chemin du cookie correspond � 1638<var>chemin-interne</var>, le chemin du cookie sera remplac� par 1639<var>chemin-public</var>. 1640</p><p> 1641Dans l'exemple fourni avec la directive <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>, la directive :</p> 1642 <div class="example"><p><code> 1643 ProxyPassReverseCookiePath / /mirror/foo/ 1644 </code></p></div> 1645<p>va r��crire un cookie poss�dant un chemin d'arri�re-plan <code>/</code> 1646(ou <code>/example</code> ou en fait tout chemin) 1647en <code>/mirror/foo/</code>.. 1648</p> 1649 1650</div> 1651<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1652<div class="directive-section"><h2><a name="ProxyPreserveHost" id="ProxyPreserveHost">ProxyPreserveHost</a> <a name="proxypreservehost" id="proxypreservehost">Directive</a></h2> 1653<table class="directive"> 1654<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 1655du mandataire</td></tr> 1656<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPreserveHost On|Off</code></td></tr> 1657<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyPreserveHost Off</code></td></tr> 1658<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 1659<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1660<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1661<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.0.31 d'Apache.</td></tr> 1662</table> 1663 <p>Lorsqu'elle est activ�e, cette directive va transmettre l'en-t�te 1664 Host: de la requ�te entrante vers le serveur mandat�, au lieu du nom 1665 d'h�te sp�cifi� par la directive <code class="directive">ProxyPass</code>.</p> 1666 1667 <p>Cette directive est habituellement d�finie � <code>Off</code>. 1668 Elle est principalement utile dans les configurations particuli�res 1669 comme l'h�bergement virtuel mandat� en masse � base de nom, o� 1670 l'en-t�te Host d'origine doit �tre �valu� par le serveur 1671 d'arri�re-plan.</p> 1672 1673</div> 1674<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1675<div class="directive-section"><h2><a name="ProxyReceiveBufferSize" id="ProxyReceiveBufferSize">ProxyReceiveBufferSize</a> <a name="proxyreceivebuffersize" id="proxyreceivebuffersize">Directive</a></h2> 1676<table class="directive"> 1677<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du tampon r�seau pour les connexions mandat�es HTTP 1678et FTP</td></tr> 1679<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyReceiveBufferSize <var>octets</var></code></td></tr> 1680<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyReceiveBufferSize 0</code></td></tr> 1681<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 1682<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1683<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1684</table> 1685 <p>La directive <code class="directive">ProxyReceiveBufferSize</code> permet 1686 de sp�cifier une taille de tampon r�seau explicite (TCP/IP) pour les 1687 connexions mandat�es HTTP et FTP, afin d'am�liorer le d�bit de 1688 donn�es. Elle doit �tre sup�rieure � <code>512</code> ou d�finie � 1689 <code>0</code> pour indiquer que la taille de tampon par d�faut du 1690 syst�me doit �tre utilis�e.</p> 1691 1692 <div class="example"><h3>Exemple</h3><p><code> 1693 ProxyReceiveBufferSize 2048 1694 </code></p></div> 1695 1696</div> 1697<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1698<div class="directive-section"><h2><a name="ProxyRemote" id="ProxyRemote">ProxyRemote</a> <a name="proxyremote" id="proxyremote">Directive</a></h2> 1699<table class="directive"> 1700<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Mandataire distant � utiliser pour traiter certaines 1701requ�tes</td></tr> 1702<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRemote <var>comparaison</var> <var>serveur-distant</var></code></td></tr> 1703<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 1704<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1705<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1706</table> 1707 <p>Cette directive permet de d�finir des mandataires distants pour 1708 ce mandataire. <var>comparaison</var> est soit le nom d'un protocole 1709 que supporte le serveur distant, soit une URL partielle pour 1710 laquelle le serveur distant devra �tre utilis�, soit <code>*</code> 1711 pour indiquer que le serveur distant doit �tre utilis� pour toutes 1712 les requ�tes. <var>serveur-distant</var> est une URL partielle 1713 correspondant au serveur distant. Syntaxe : </p> 1714 1715 <div class="example"><p><code> 1716 <dfn>serveur-distant</dfn> = 1717 <var>protocole</var>://<var>nom-serveur</var>[:<var>port</var>] 1718 </code></p></div> 1719 1720 <p><var>protocole</var> est effectivement le protocole � utiliser 1721 pour communiquer avec le serveur distant ; ce module ne supporte que 1722 <code>http</code> et <code>https</code>. Avec <code>https</code>, 1723 les requ�tes sont transmises par le mandataire distant via la 1724 m�thode HTTP CONNECT.</p> 1725 1726 <div class="example"><h3>Exemple</h3><p><code> 1727 ProxyRemote http://bons-gars.example.com/ http://gars-mirroirs.example.com:8000<br /> 1728 ProxyRemote * http://mandataire-intelligent.localdomain<br /> 1729 ProxyRemote ftp http://mandataire-ftp.mon-domaine:8080 1730 </code></p></div> 1731 1732 <p>Dans la derni�re ligne de l'exemple, le mandataire va faire 1733 suivre les requ�tes FTP, encapsul�es dans une autre requ�te mandat�e 1734 HTTP, vers un autre mandataire capable de les traiter.</p> 1735 1736 <p>Cette directive supporte aussi les configurations de mandataire 1737 inverse - un serveur web d'arri�re-plan peut �tre int�gr� dans 1738 l'espace d'URL d'un serveur virtuel, m�me si ce serveur est cach� 1739 par un autre mandataire direct.</p> 1740 1741</div> 1742<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1743<div class="directive-section"><h2><a name="ProxyRemoteMatch" id="ProxyRemoteMatch">ProxyRemoteMatch</a> <a name="proxyremotematch" id="proxyremotematch">Directive</a></h2> 1744<table class="directive"> 1745<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le mandataire distant � utiliser pour traiter les requ�tes 1746correspondant � une expression rationnelle</td></tr> 1747<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRemoteMatch <var>regex</var> <var>serveur-distant</var></code></td></tr> 1748<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 1749<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1750<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1751</table> 1752 <p>La directive <code class="directive">ProxyRemoteMatch</code> est 1753 identique � la directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code>, � l'exception que le 1754 premier argument est une <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression 1755 rationnelle</a> � mettre en correspondance avec l'URL de la 1756 requ�te.</p> 1757 1758</div> 1759<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1760<div class="directive-section"><h2><a name="ProxyRequests" id="ProxyRequests">ProxyRequests</a> <a name="proxyrequests" id="proxyrequests">Directive</a></h2> 1761<table class="directive"> 1762<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la fonctionnalit� (standard) de mandataire 1763direct</td></tr> 1764<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRequests On|Off</code></td></tr> 1765<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyRequests Off</code></td></tr> 1766<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 1767<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1768<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1769</table> 1770 <p>Cette directive permet d'activer/d�sactiver la fonctionnalit� de 1771 serveur mandataire direct d'Apache. D�finir ProxyRequests � 1772 <code>Off</code> n'interdit pas l'utilisation de la directive 1773 <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p> 1774 1775 <p>Pour une configuration typique de mandataire inverse ou 1776 passerelle, cette directive doit �tre d�finie � 1777 <code>Off</code>.</p> 1778 1779 <p>Afin d'activer la fonctionnalit� de mandataire pour des sites 1780 HTTP et/ou FTP, les modules <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code> et/ou 1781 <code class="module"><a href="/mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> doivent aussi �tre charg�s dans le 1782 serveur.</p> 1783 1784 <p><code class="module"><a href="/mod/mod_proxy_connect.html">mod_proxy_connect</a></code> doit �tre activ� pour pouvoir 1785 mandater (en direct) des sites HTTPS.</p> 1786 1787 <div class="warning"><h3>Avertissement</h3> 1788 <p>N'activez pas la fonctionnalit� de mandataire avec la directive 1789 <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> avant 1790 d'avoir <a href="#access">s�curis� votre serveur</a>. Les serveurs 1791 mandataires ouverts sont dangereux non seulement pour votre 1792 r�seau, mais aussi pour l'Internet au sens large.</p> 1793 </div> 1794 1795<h3>Voir aussi</h3> 1796<ul> 1797<li><a href="#forwardreverse">Mandataires/Passerelles directs et 1798inverses</a></li> 1799</ul> 1800</div> 1801<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1802<div class="directive-section"><h2><a name="ProxySet" id="ProxySet">ProxySet</a> <a name="proxyset" id="proxyset">Directive</a></h2> 1803<table class="directive"> 1804<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit diff�rents param�tres relatifs � la r�partition de 1805charge des mandataires et aux membres des groupes de r�partition de 1806charge</td></tr> 1807<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> 1808<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire</td></tr> 1809<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1810<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1811<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>ProxySet n'est disponible que depuis la version 2.2 1812d'Apache.</td></tr> 1813</table> 1814 <p>Cette directive propose une m�thode alternative pour d�finir tout 1815 param�tre relatif aux r�partiteurs de charge et serveurs cibles de 1816 mandataires normalement d�fini via la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>. Si elle se trouve dans un 1817 conteneur <code><Proxy <var>url de r�partiteur|url de 1818 serveur cible</var>></code>, l'argument <var>url</var> n'est pas 1819 n�cessaire. Comme effet de bord, le r�partiteur ou serveur cible respectif 1820 est cr��. Ceci peut s'av�rer utile pour la mise en oeuvre d'un 1821 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> 1822 1823 <div class="example"><p><code> 1824 <Proxy balancer://hotcluster><br /> 1825 <span class="indent"> 1826 BalancerMember http://www2.example.com:8080 loadfactor=1<br /> 1827 BalancerMember http://www3.example.com:8080 loadfactor=2<br /> 1828 ProxySet lbmethod=bytraffic<br /> 1829 </span> 1830 </Proxy> 1831 </code></p></div> 1832 1833 <div class="example"><p><code> 1834 <Proxy http://backend><br /> 1835 <span class="indent"> 1836 ProxySet keepalive=On<br /> 1837 </span> 1838 </Proxy> 1839 </code></p></div> 1840 1841 <div class="example"><p><code> 1842 ProxySet balancer://foo lbmethod=bytraffic timeout=15 1843 </code></p></div> 1844 1845 <div class="example"><p><code> 1846 ProxySet ajp://backend:7001 timeout=15 1847 </code></p></div> 1848 1849 <div class="warning"><h3>Avertissement</h3> 1850 <p>Gardez � l'esprit qu'une m�me cl� de param�tre peut avoir 1851 diff�rentes significations selon qu'elle s'applique � un 1852 r�partiteur ou � un serveur cible, et ceci est illustr� par les deux 1853 exemples pr�c�dents o� il est question d'un timeout.</p> 1854 </div> 1855 1856 1857</div> 1858<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1859<div class="directive-section"><h2><a name="ProxyStatus" id="ProxyStatus">ProxyStatus</a> <a name="proxystatus" id="proxystatus">Directive</a></h2> 1860<table class="directive"> 1861<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Affiche l'�tat du r�partiteur de charge du mandataire dans 1862mod_status</td></tr> 1863<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyStatus Off|On|Full</code></td></tr> 1864<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyStatus Off</code></td></tr> 1865<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 1866<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1867<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1868<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.2 d'Apache</td></tr> 1869</table> 1870 <p>Cette directive permet de sp�cifier si les donn�es d'�tat du 1871 r�partiteur de charge du mandataire doivent �tre affich�es via la 1872 page d'�tat du serveur du module <code class="module"><a href="/mod/mod_status.html">mod_status</a></code>.</p> 1873 <div class="note"><h3>Note</h3> 1874 <p>L'argument <strong>Full</strong> produit le m�me effet que 1875 l'argument <strong>On</strong>.</p> 1876 </div> 1877 1878 1879</div> 1880<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1881<div class="directive-section"><h2><a name="ProxyTimeout" id="ProxyTimeout">ProxyTimeout</a> <a name="proxytimeout" id="proxytimeout">Directive</a></h2> 1882<table class="directive"> 1883<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�lai d'attente r�seau pour les requ�tes 1884mandat�es</td></tr> 1885<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyTimeout <var>secondes</var></code></td></tr> 1886<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> 1887<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 1888<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1889<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1890<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.0.31 d'Apache</td></tr> 1891</table> 1892 <p>Cette directive permet � l'utilisateur de sp�cifier un d�lai pour 1893 les requ�tes mandat�es. Ceci s'av�re utile dans le cas d'un serveur 1894 d'applications lent et bogu� qui a tendance � se bloquer, et si vous 1895 pr�f�rez simplement renvoyer une erreur timeout et abandonner la 1896 connexion en douceur plut�t que d'attendre jusqu'� ce que le serveur 1897 veuille bien r�pondre.</p> 1898 1899</div> 1900<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1901<div class="directive-section"><h2><a name="ProxyVia" id="ProxyVia">ProxyVia</a> <a name="proxyvia" id="proxyvia">Directive</a></h2> 1902<table class="directive"> 1903<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Information fourni dans l'en-t�te de r�ponse HTTP 1904<code>Via</code> pour les requ�tes mandat�es</td></tr> 1905<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyVia On|Off|Full|Block</code></td></tr> 1906<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyVia Off</code></td></tr> 1907<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 1908<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 1909<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr> 1910</table> 1911 <p>Cette directive permet de contr�ler l'utilisation de l'en-t�te 1912 HTTP <code>Via:</code> par le mandataire. Le but recherch� est de 1913 contr�ler le flux des requ�tes mandat�es tout au long d'une cha�ne 1914 de serveurs mandataires. Voir <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> (HTTP/1.1), 1915 section 14.45 pour une description des lignes d'en-t�te 1916 <code>Via:</code>.</p> 1917 1918 <ul> 1919 <li>Si elle est d�finie � <code>Off</code>, valeur par d�faut, cette 1920 directive n'effectue aucun traitement particulier. Si une requ�te ou 1921 une r�ponse contient un en-t�te <code>Via:</code>, il est transmis 1922 sans modification.</li> 1923 1924 <li>Si elle est d�finie � <code>On</code>, chaque requ�te ou r�ponse 1925 se verra ajouter une ligne d'en-t�te <code>Via:</code> pour le 1926 serveur courant.</li> 1927 1928 <li>Si elle est d�finie � <code>Full</code>, chaque ligne d'en-t�te 1929 <code>Via:</code> se verra ajouter la version du serveur Apache sous 1930 la forme d'un champ de commentaire <code>Via:</code>.</li> 1931 1932 <li>Si elle est d�finie � <code>Block</code>, chaque requ�te 1933 mandat�e verra ses lignes d'en-t�te <code>Via:</code> supprim�es. 1934 Aucun nouvel en-t�te <code>Via:</code> ne sera g�n�r�.</li> 1935 </ul> 1936 1937</div> 1938</div> 1939<div class="bottomlang"> 1940<p><span>Langues Disponibles: </span><a href="/en/mod/mod_proxy.html" hreflang="en" rel="alternate" title="English"> en </a> | 1941<a href="/fr/mod/mod_proxy.html" title="Fran�ais"> fr </a> | 1942<a href="/ja/mod/mod_proxy.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> 1943</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> 1944<script type="text/javascript"><!--//--><![CDATA[//><!-- 1945var comments_shortname = 'httpd'; 1946var comments_identifier = 'http://httpd.apache.org/docs/2.2/mod/mod_proxy.html'; 1947(function(w, d) { 1948 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 1949 d.write('<div id="comments_thread"><\/div>'); 1950 var s = d.createElement('script'); 1951 s.type = 'text/javascript'; 1952 s.async = true; 1953 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 1954 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 1955 } 1956 else { 1957 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 1958 } 1959})(window, document); 1960//--><!]]></script></div><div id="footer"> 1961<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> 1962<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- 1963if (typeof(prettyPrint) !== 'undefined') { 1964 prettyPrint(); 1965} 1966//--><!]]></script> 1967</body></html>