<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1690350:1696884 (outdated) -->
+<!-- English Revision: 1696884 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
demandé</em>. Pour obtenir un contenu hébergé par
le serveur demandé, le client envoie une requête au
mandataire en nommant le serveur demandé comme
- cible, puis le mandataire extrait le contenu depuis le
+ cible. Le mandataire extrait alors le contenu depuis le
serveur demandé et le renvoie enfin au client. Le client doit être
configuré de manière appropriée pour pouvoir utiliser le mandataire
direct afin d'accéder à d'autres sites.</p>
<p>Cette directive va créer un worker associé à l'URL du serveur
- original <code>http://backend.example.com</code>, et utilisant les
+ original <code>http://backend.example.com</code> qui utilisera les
valeurs de timeout données. Lorsqu'ils sont utilisés dans le cadre
d'un mandataire direct, les workers sont en général définis via la
directive <directive module="mod_proxy">ProxySet</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
+ module="mod_proxy">ProxyPass</directive>.</p>
<p>Cette directive est habituellement définie à <code>Off</code>.
Elle est principalement utile dans les configurations particulières
HTTP, vers un autre mandataire capable de les traiter.</p>
<p>Cette directive supporte aussi les configurations de mandataire
- inverse - un serveur web d'arrière-plan peut être intégré dans
+ inverse ; un serveur web d'arrière-plan peut être intégré dans
l'espace d'URL d'un serveur virtuel, même si ce serveur est caché
par un autre mandataire direct.</p>
</usage>
<usage>
<p>Cette directive permet de référencer des serveurs distants depuis
- l'espace d'URLs du serveur local ; le serveur
+ l'espace d'URLs du serveur local. Le serveur
local n'agit pas en tant que mandataire au sens conventionnel, mais
plutôt comme miroir du serveur distant. Le serveur local est
souvent nommé <dfn>mandataire inverse</dfn> ou
<code>unix:</code> tient compte de la directive
<directive>DefaultRuntimeDir</directive>.</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>Supposons que le serveur local a pour adresse
<code>http://example.com/</code> ; alors la ligne</p>
<code>http://example.com/miroir/foo/bar</code> en une requête
mandatée pour <code>http://backend.example.com/bar</code>.</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>La syntaxe alternative suivante est valide, bien qu'elle puisse
induire une dégradation des performances lorsqu'elle est
présente en très grand nombre. Elle possède l'avantage de
</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 groupements de connexions vers un serveur d'arrière-plan. Les
connexions créées à la demande peuvent être enregistrées dans un
groupement pour une utilisation ultérieure. La taille du groupe
ainsi que d'autres caractéristiques peuvent être définies via la
directive <directive>ProxyPass</directive> au moyen de paramètres
- <code>clé=valeur</code> dont la description fait l'objet du tableau
- ci-dessous.</p>
+ <code>clé=valeur</code> dont la description fait l'objet des
+ tableaux ci-dessous.</p>
<p>Par défaut, mod_proxy permet et met en réserve le nombre maximum
de connexions pouvant être utilisées simultanément par le processus
<td>off</td>
<td>Permet de définir si le module mandataire doit vider
automatiquement le tampon de sortie après chaque tronçon de
- données. 'off' signifie que le tampon sera vidé si nécessaire,
- 'on' que le tampon sera vidé après chaque envoi d'un
+ données. 'off' signifie que le tampon sera vidé si
+ nécessaire ;
+ 'on' signifie que le tampon sera vidé après chaque envoi d'un
tronçon de données, et 'auto' que le tampon sera vidé après un
délai de 'flushwait' millisecondes si aucune entrée n'est reçue.
Actuellement, cette clé n'est supportée que par AJP.
</Proxy>
</highlight>
+ <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
</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
- module="mod_proxy">ProxyPass</directive>.</p>
+ <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
<code>http://example.com/</code> ; alors</p>
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
httpd 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>
projects / apache / commitdiff