<?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 -->
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><Location></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"><Location "/special%3Fsegment">
+ Require ip 172.17.2.0/24
+</Location></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"><Location "/some/path">
+ Require valid-user
+</Location></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><Location></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>