From: Lucien Gentis
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
,
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
@@ -1111,6 +1111,15 @@ sont support
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
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 @@ -1178,14 +1195,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 @@ -1279,8 +1298,9 @@ ProxyPass "/mirror/foo" "http://backend.example.com"
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 @@ -1791,8 +1813,9 @@ par un serveur mandat
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
.
ProxyPass
.
Supposons par exemple que le serveur local a pour adresse
http://example.com/
; alors
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
définition de la directive 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.
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
.
ProxyPass
.
Cette directive est habituellement définie à Off
.
Elle est principalement utile dans les configurations particulières
@@ -1981,7 +2005,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.
diff --git a/docs/manual/mod/mod_proxy.xml.meta b/docs/manual/mod/mod_proxy.xml.meta index f0185375d44..38a79fdda73 100644 --- a/docs/manual/mod/mod_proxy.xml.meta +++ b/docs/manual/mod/mod_proxy.xml.meta @@ -8,7 +8,7 @@