From 4b95ad9cddf6fe43c8f42ffe8b691c5e723d69eb Mon Sep 17 00:00:00 2001 From: Lucien Gentis Date: Sat, 22 Aug 2015 16:40:39 +0000 Subject: [PATCH] XML update. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1697099 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/mod_proxy.xml.fr | 65 +++++++++++++++++++++++--------- 1 file changed, 47 insertions(+), 18 deletions(-) diff --git a/docs/manual/mod/mod_proxy.xml.fr b/docs/manual/mod/mod_proxy.xml.fr index 0e2b7371fd..0b1d5edf77 100644 --- a/docs/manual/mod/mod_proxy.xml.fr +++ b/docs/manual/mod/mod_proxy.xml.fr @@ -1,7 +1,7 @@ - + @@ -110,7 +110,7 @@ demandé. 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.

@@ -239,7 +239,7 @@ ProxyVia On

Cette directive va créer un worker associé à l'URL du serveur - original http://backend.example.com, et utilisant les + original http://backend.example.com 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 ProxySet,

@@ -657,7 +657,8 @@ dans un contexte de répertoire depuis la version 2.3.3.

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 ProxyPass.

+ d'hôte spécifié par la directive ProxyPass.

Cette directive est habituellement définie à Off. Elle est principalement utile dans les configurations particulières @@ -748,7 +749,7 @@ ProxyRemote "ftp" "http://ftpproxy.mydomain:8080" HTTP, vers un autre mandataire capable de les traiter.

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.

 @@ -958,7 +959,7 @@ sont supportés à partir de la version 2.4.7 du serveur HTTP Apache

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é mandataire inverse ou @@ -985,6 +986,19 @@ sont supportés à partir de la version 2.4.7 du serveur HTTP Apache unix: tient compte de la directive DefaultRuntimeDir. +

Lorsque cette directive est utilisée dans une section Location, le premier + argument est omis et le répertoire local est obtenu à partir de + l'argument de la directive Location. Il en est de même à l'intérieur + d'une section LocationMatch, 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 Location séparée.

+

Supposons que le serveur local a pour adresse http://example.com/ ; alors la ligne

@@ -998,6 +1012,15 @@ sont supportés à partir de la version 2.4.7 du serveur HTTP Apache http://example.com/miroir/foo/bar en une requête mandatée pour http://backend.example.com/bar.

+

La directive ProxyPass ne peut pas être placée dans une section + Directory ou + Files.

+ +

Si vous avez besoin d'un configuration de mandataire inverse plus + souple, reportez-vous à la documentaion de la directive RewriteRule et son drapeau + [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 @@ -1061,14 +1084,16 @@ ProxyPass "/mirror/foo" "http://backend.example.com" +

ProxyPass clé=valeur Paramètres

+

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 ProxyPass au moyen de paramètres - clé=valeur dont la description fait l'objet du tableau - ci-dessous.

+ clé=valeur dont la description fait l'objet des + tableaux ci-dessous.

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 @@ -1165,8 +1190,9 @@ ProxyPass "/mirror/foo" "http://backend.example.com" off 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. @@ -1455,6 +1481,8 @@ ProxyPass "/" "balancer://hotcluster/" </Proxy> +

Mots-clés additionnels de ProxyPass

+

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 @@ -1635,9 +1663,9 @@ par un serveur mandaté en inverse

chemin est le nom d'un chemin virtuel local. - url est une URL partielle pour le serveur distant - ils - sont utilisés de la même façon qu'avec la directive ProxyPass.

+ url est une URL partielle pour le serveur distant. Ces + paramètres s'utilisent de la même façon qu'avec la + directive ProxyPass.

Supposons par exemple que le serveur local a pour adresse http://example.com/ ; alors

@@ -1654,9 +1682,9 @@ ProxyPassReverseCookiePath "/" "/mirror/foo/" requête mandatée pour http://backend.example.com/bar (la fonctionnalité fournie par ProxyPass). Il va aussi s'occuper des redirections que le serveur - backend.example.com envoie : lorsque - http://backend.example.com/bar est redirigé par - celui-ci vers http://backend.example.com/quux, Apache + backend.example.com envoie lorsqu'il redirige + http://backend.example.com/bar vers + http://backend.example.com/quux. Apache httpd corrige ceci en http://example.com/miroir/foo/quux 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 @@ -1664,8 +1692,9 @@ ProxyPassReverseCookiePath "/" "/mirror/foo/" module="core">UseCanonicalName.

Notez que la directive ProxyPassReverse - peut aussi être utilisée en conjonction avec la fonctionnalité - pass-through (RewriteRule ... [P]) du module + peut aussi être utilisée en conjonction avec la + fonctionnalité de mandataire + (RewriteRule ... [P]) du module mod_rewrite, car elle ne dépend pas d'une directive ProxyPass correspondante.

-- 2.50.1