<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1559613:1696886 (outdated) -->
+<!-- English Revision: 1696886 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
</example>
<p>Cet exemple crée un worker associé à l'URL du serveur original
- <code>http://backend.example.com</code>, et utilisant les délais
+ <code>http://backend.example.com</code>, qui utilisera les délais
spécifiés. Dans le cas d'un mandataire direct, les workers sont
généralement définis via la directive <directive
module="mod_proxy">ProxySet</directive> directive :</p>
<usage>
<p>Lorsqu'elle est activée, cette directive va transmettre l'en-tête
Host: de la requête entrante vers le serveur mandaté, au lieu du nom
- d'hôte spécifié par la directive <directive>ProxyPass</directive>.</p>
+ d'hôte spécifié par la directive
+ <directive>ProxyPass module="mod_proxy"</directive>.</p>
<p>Cette directive est habituellement définie à <code>Off</code>.
Elle est principalement utile dans les configurations particulières
</p>
</note>
+ <p>Lorsque cette directive est utilisée dans une section <directive
+ type="section" module="core">Location</directive>, le premier
+ argument est omis et le répertoire local est obtenu à partir de
+ l'argument de la directive <directive type="section"
+ module="core">Location</directive>. Il en est de même à l'intérieur
+ d'une section <directive type="section"
+ module="core">LocationMatch</directive>, mais le résultat ne sera
+ probablement pas celui attendu car ProxyPassReverse va interpréter
+ l'expression rationnelle littéralement comme un chemin ; si besoin
+ est dans ce cas, définissez la directive ProxyPassReverse en dehors
+ de la section, ou dans une section <directive type="section"
+ module="core">Location</directive> séparée.</p>
+
+ <p>La directive ProxyPass ne peut pas être placée dans une section
+ <directive type="section" module="core">Directory</directive> ou
+ <directive type="section" module="core">Files</directive>.</p>
+
+ <p>Si vous avez besoin d'un configuration de mandataire inverse plus
+ souple, reportez-vous à la documentaion de la directive <directive
+ module="mod_rewrite">RewriteRule</directive> et son drapeau
+ <code>[P]</code>.</p>
+
<p>Le drapeau <code>!</code> permet de soustraire un sous-répertoire
- du mandat inverse, comme dans l'exemple suivant :</p>
+ du mandat inverse, comme dans l'exemple suivant :</p>
<example>
ProxyPass /miroir/foo/i !<br />
</note> <!-- /ordering_proxypass -->
+ <p><strong>ProxyPass <code>clé=valeur</code> Paramètres</strong></p>
+
<p>Depuis la version 2.1 du serveur HTTP Apache, mod_proxy supporte
les jeux de connexions vers un serveur d'arrière-plan. Ainsi, les
connexions créées à la demande peuvent être conservées dans un
jeu pour une utilisation ultérieure. Les limites de la taille
du jeu de connexions et d'autres paramètres peuvent être définis au
niveau de la directive <directive>ProxyPass</directive> via des
- arguments <code>clé=valeur</code> décrits dans la table ci-dessous.</p>
+ arguments <code>clé=valeur</code> décrits dans les
+ tables ci-dessous.</p>
<p>Par défaut, mod_proxy permettra de conserver le nombre maximum de
connexions pouvant être utilisées simultanément par le processus
</Proxy>
</example>
+ <p><strong>Mots-clés additionnels de ProxyPass</strong></p>
+
<p>Normalement, mod_proxy va mettre sous leur forme canonique les
URLs traitées par ProxyPass. Mais ceci peut être incompatible avec
certains serveurs d'arrière-plan, et en particulier avec ceux qui
car la protection limitée contre les attaques à base d'URL que
fournit le mandataire est alors supprimée.</p>
- <p>Lorsque la directive ProxyPass est utilisée à l'intérieur d'une
- section <directive type="section" module="core"
- >Location</directive>, le premier argument est omis et le répertoire
- local est obtenu à partir de la section <directive
- type="section" module="core">Location</directive>. Il en est de
- même à l'intérieur
- d'une section <directive type="section"
- module="core">LocationMatch</directive> ; cependant, ProxyPass
- n'interprète pas les expressions rationnelles, et dans ce cas, il
- est nécessaire d'utiliser la directive
- <directive>ProxyPassMatch</directive>.
- </p>
-
- <p>Cette directive ne peut pas être placée dans une section
- <directive type="section" module="core">Directory</directive> ou
- <directive type="section" module="core">Files</directive>.</p>
-
- <p>Si vous avez besoin d'un configuration de mandataire inverse plus
- souple, reportez-vous à la documentaion de la directive <directive
- module="mod_rewrite">RewriteRule</directive> et son drapeau
- <code>[P]</code>.</p>
-
<p>Le mot-clé optionnel <var>interpolate</var> (disponible depuis
httpd 2.2.9), en combinaison avec la directive
<directive>ProxyPassInterpolateEnv</directive>, permet à ProxyPass
les références d'URL.</p>
<p><var>chemin</var> est le nom d'un chemin virtuel local.
- <var>url</var> est une URL partielle pour le serveur distant - ils
- sont utilisés de la même façon qu'avec la directive <directive
+ <var>url</var> est une URL partielle pour le serveur distant. Ces
+ paramètres s'utilisent de la même façon qu'avec la directive <directive
module="mod_proxy">ProxyPass</directive>.</p>
<p>Supposons par exemple que le serveur local a pour adresse
requête mandatée pour <code>http://backend.example.com/bar</code>
(la fonctionnalité fournie par <code>ProxyPass</code>). Il va
aussi s'occuper des redirections que le serveur
- <code>backend.example.com</code> envoie : lorsque
- <code>http://backend.example.com/bar</code> est redirigé par
- celui-ci vers <code>http://backend.example.com/quux</code>, Apache
+ <code>backend.example.com</code> envoie lorsqu'il redirige
+ <code>http://backend.example.com/bar</code> vers
+ <code>http://backend.example.com/quux</code>. Apache
corrige ceci en <code>http://example.com/miroir/foo/quux</code>
avant de faire suivre la redirection HTTP au client. Notez que le
nom d'hôte utilisé pour construire l'URL est choisi en respectant la
module="core">UseCanonicalName</directive>.</p>
<p>Notez que la directive <directive>ProxyPassReverse</directive>
- peut aussi être utilisée en conjonction avec la fonctionnalité
- pass-through (<code>RewriteRule ... [P]</code>) du module
+ peut aussi être utilisée en conjonction avec la
+ fonctionnalité de mandataire (<code>RewriteRule ... [P]</code>) du module
<module>mod_rewrite</module>, car elle ne dépend pas d'une directive
<directive module="mod_proxy">ProxyPass</directive>
correspondante.</p>