From: Lucien Gentis Date: Sun, 17 May 2026 15:05:56 +0000 (+0000) Subject: fr doc XML file update. X-Git-Tag: 2.4.68-rc1-candidate~119 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=8b55052ee18e4a16bb1432829ec30d18d197b3a4;p=thirdparty%2Fapache%2Fhttpd.git fr doc XML file update. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1934302 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_proxy.xml.fr b/docs/manual/mod/mod_proxy.xml.fr index fec6b7968c..f681d6e8e2 100644 --- a/docs/manual/mod/mod_proxy.xml.fr +++ b/docs/manual/mod/mod_proxy.xml.fr @@ -1,7 +1,7 @@ - + @@ -380,6 +380,15 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10 </Proxy> + Requêtes HTTPS/CONNECT +

L’instruction générique <Proxy "*"> ci-dessus + correspond à toutes les requêtes, y compris les requêtes HTTPS sous tunnel + via la méthode CONNECT. Notez que le contrôle d’accès pour les tunnels + CONNECT ne peut fonctionner qu’avec l’hôte et le port — le contrôle avec + le chemin (par exemple <Proxy + "https://example.com/path/">) ne fonctionnera pas, car les + requêtes CONNECT ne comportent pas de chemin.

 +

Pour plus de détails sur les directives de contrôle d'accès, voir la documentation du module mod_authz_host.

@@ -459,7 +468,13 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10 SetEnv force-proxy-request-1.0 1 SetEnv proxy-nokeepalive 1 </Location> - + + +

Notez que force-proxy-request-1.0 implique aussi + proxy-sendcl, car HTTP/1.0 ne prend pas en charge l’encodage + de transfert fractionné. La redirection des corps de requête fractionnés + (via proxy-sendchunked) est désactivée si cette option est + définie.

A partir de la version 2.4.26 du serveur HTTP Apache, la définition de la variable d'environnement "no-proxy" permet de désactiver @@ -822,6 +837,7 @@ serveur HTTP Apache être ajoutés au groupe de répartition de charge préconfiguré d'un serveur virtuel. Elle n'est active que si le groupe a été préconfiguré avec un membre au minimum.

+

La valeur doit être entre 0 et 1000.

@@ -1023,20 +1039,22 @@ sont supportés à partir de la version 2.4.7 du serveur HTTP Apacheunix:/home/www.socket|http://localhost/whatever/.

- Note :Le chemin associé à l'URL + Le chemin associé à l'URL 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 + type="section" module="core">Location, le premier argument est + omis et le répertoire local est obtenu à partir de l'argument de la + directive Location. + Lorsque cette directive est utilisée en dehors d’une section Location ou LocationMatch, l’argument + chemin est requis. 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.

@@ -1126,16 +1144,22 @@ ProxyPass "/mirror/foo/i" "!" règles situées après une règle dont l'URL correspond au début de leur propre URL seront ignorées. Notez que tout ceci est en relation avec le partage de workers.

- - Chronologie de prise en compte des directives + + <note type="warning"><title>Chronologie de prise en compte des directives ProxyPass au sein des sections Locations -

On ne peut placer - qu'une seule directive ProxyPass dans une section - Location, et c'est la section - la plus spécifique qui l'emportera.

+

On ne peut placer qu'une seule directive ProxyPass dans une section Location, et c'est la dernière section + Location correspondante qui + l'emportera, suivant en cela les règles standards de fusion des sections. Placez les + sections Location les plus + spécifiques après les moins spécifiques afin de s’assurer que la + directive ProxyPass attendue + s’applique.

 + Exclusions et variable d'environnement no-proxy

Les exclusions doivent se situer avant les directives ProxyPass générales. A partir de la @@ -1171,6 +1195,15 @@ ProxyPass "/mirror/foo/i" "!" autres réglages n'étant pas coordonnés entre ces différents processus, sauf bien entendu lorsqu'un seul processus enfant n'est autorisé par la configuration ou le MPM utilisé.

 + + Mise en commun des connexions avec le MPM prefork +

Avec le MPM prefork, les connexions avec les serveurs dorsaux ne sont pas + mises en commun (chaque processus enfant gère une connexion à la fois). Les + paramètres acquire et ttl qui contrôlent le + comportement des pools de connexions n’ont aucun effet si on utilise + prefork. Les paramètres de dimensionnement min, + smax et hmax sont eux aussi ignorés.

+

Le paramètre ttl, quant à lui, permet de définir une durée de vie optionnelle ; les @@ -1427,13 +1460,11 @@ ProxyPass "/mirror/foo/i" "!" upgrade - -

Protocole pris en charge par mod_proxy_http ou +

Protocole pris en charge par mod_proxy_http ou mod_proxy_wstunnel pour le mécanisme de promotion de protocole HTTP lors d'une négociation du client/navigateur HTTP (en - accord avec RFC 9110 - - Upgrade). Voir la note Promotion de - protocole ci-dessous

+ accord avec la 9110 - Upgrade). Voir la + note Promotion de protocole ci-dessous

mapping - @@ -1747,8 +1778,7 @@ ProxyPassReverse "/mirror/foo/" "https://backend.example.com/" des versions 2.4.48 et ultérieures désactive la prise en charge par mod_proxy_http), voir la documentation de mod_proxy_wstunnel pour la méthode permettant de mandater - le protocole WebSocket.

- + le protocole WebSocket.

@@ -1776,9 +1806,29 @@ arrières (voir note ci-dessous). toute correspondance entre parenthèses dans la chaîne donnée et l'utiliser comme nouvelle url.

- Note : Cette directive ne peut pas être + Cette directive ne peut pas être utilisée dans un contexte de niveau répertoire. + Correspondance de worker avec les références + arrières +

Quand ProxyPassMatch contient des références + arrières (par exemple $1) dans l’URL cible, chaque requête + produit un URL résolu différent. Comme la recherche de correspondance des workers s’effectue par URL, ces requêtes ne + correspondront pas au worker créé par cette directive et utiliseront à la + place le worker du mandataire inverse par défaut, qui ne réutilise pas les + connexions, ni ne met en cache les recherches DNS. Pour activer la mise en + commun des connexions, définissez un worker explicite pour le serveur dorsal + séparément :

+ +ProxyPass "/notused" "http://backend.example.com/" connectiontimeout=5 timeout=30 +ProxyPassMatch "^/(.*\.gif)$" "http://backend.example.com/$1" + +

La définition explicite du worker ProxyPass permet + de s’assurer que le jeu de connexions d’arrière-plan est disponible pour les + requêtes ProxyPassMatch.

+ +

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

@@ -1794,9 +1844,12 @@ arrières (voir note ci-dessous). sous-répertoire donné.

Dans une section LocationMatch, le premier argument est - omis et l'expression rationnelle est obtenue à partir de la directive - LocationMatch.

+ module="core">LocationMatch, le premier argument est omis et + l'expression rationnelle est obtenue à partir de la directive LocationMatch. En dehors d’une + section Location ou + LocationMatch, + l’argument regex est requis.

Si vous avez besoin d'une configuration du mandataire inverse plus flexible, voyez la directive

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, le premier argument est + omis et le répertoire local est obtenu à partir de l'argument de la + directive Location. En + dehors d’une section Location ou LocationMatch, l’argument chemin est + requis. 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.

Cette directive ne peut pas être placée dans une section @@ -2333,8 +2388,7 @@ ProxyDomain ".example.com"

Cette directive permet de contrôler l'utilisation de l'en-tête HTTP Via: par le mandataire. Le but recherché est de contrôler le flux des requêtes mandatées tout au long d'une chaîne - de serveurs mandataires. Voir RFC 2616 (HTTP/1.1), + de serveurs mandataires. Voir la 2616 (HTTP/1.1), section 14.45 pour une description des lignes d'en-tête Via:.