From: Lucien Gentis <lgentis@apache.org>
Date: Sat, 18 Dec 2021 14:53:39 +0000 (+0000)
Subject: fr doc XML file update.
X-Git-Tag: 2.4.53-rc1-candidate~119
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=11e77e5f7adc7ff5f9a4d5859c2cd7faf46f5285;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@1896134 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mod_proxy.xml.fr b/docs/manual/mod/mod_proxy.xml.fr
index b18beed8839..6cd6a5c18fd 100644
--- a/docs/manual/mod/mod_proxy.xml.fr
+++ b/docs/manual/mod/mod_proxy.xml.fr
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1888962:1896064 (outdated) -->
+<!-- English Revision: 1896064 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -1417,6 +1417,46 @@ ProxyPass "/mirror/foo/i" "!"
 	l'en-tête Upgrade. Voir	la documentation de ce module pour plus de
 	détails.</p>
     </td></tr>
+    <tr><td>mapping</td>
+        <td>-</td>
+        <td><p>Type de mappage entre le <var>chemin</var> et l'<var>url</var>.
+	Détermine la normalisation et/ou le (non-)décodage que
+	<module>mod_proxy</module> appliquera au <var>chemin de l'uri</var>
+	demandé avant de rechercher une correspondance avec le <var>chemin</var>.
+	Si un mappage correspond, il est appliqué au <var>chemin de l'uri</var>
+	de façon à ce que tous les contextes de répertoire qui utilisent un
+	chemin (comme <code>&lt;Location&gt;</code>) fassent l'objet d'une
+	recherche de correspondance en utilisant le même mappage.</p>
+        <p><code>mapping=encoded</code> empêche le décodage des caractères %
+	contenus dans le <var>chemin de l'uri</var> de façon à ce que l'on
+	puisse par exemple utiliser des configurations telles que :</p>
+        <highlight language="config">ProxyPass "/special%3Fsegment" "https://example.com/special%3Fsegment" mapping=encoded</highlight>
+        <highlight language="config">&lt;Location "/special%3Fsegment"&gt;
+  Require ip 172.17.2.0/24
+&lt;/Location&gt;</highlight>
+        <p><code>mapping=servlet</code> se réfère à la normalisation définie par
+	la spécification de la Servlet qui sera par exemple appliquée par Apache
+	Tomcat pour les conteneurs de servlet (en particulier, les paramètres du
+	chemin sont ignorés pour le mappage). Un <var>chemin d'uri</var> comme
+	<code>/some;foo/path</code> sera alors mappé comme
+	<code>/some/path</code> et correspondra donc à tout ce qui suit sans
+	tenir compte des paramètres du chemin demandé :</p>
+        <highlight language="config">ProxyPass "/some/path" "https://servlet.example.com/some/path" mapping=servlet</highlight>
+        <highlight language="config">&lt;Location "/some/path"&gt;
+  Require valid-user
+&lt;/Location&gt;</highlight>
+        <note><title>Note</title>
+            <p>Il est recommandé d'utiliser le même mappage côté Apache httpd
+	    que celui utilisé côté arrière-plan. Par exemple, lors de la
+	    configuration des autorisations dans les sections
+	    <code>&lt;Location&gt;</code> pour des chemins mappés par
+	    <module>mod_proxy</module> comme conteneurs de servlet (comme les
+	    applications s'exécutant sous Apache Tomcat), on doit utiliser la
+	    définition <code>mapping=servlet</code> pour éviter que les
+	    paramètres du chemin et similaires n'interfèrent avec les
+	    autorisations qui doivent être définies par Apache httpd.</p>
+        </note>
+    </td></tr>
 
     </table>