<?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: 1910254 -->
+<!-- English Revision: 1913931 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<name>ProxyRemote</name>
<description>Mandataire distant à utiliser pour traiter certaines
requêtes</description>
-<syntax>ProxyRemote <var>comparaison</var> <var>serveur-distant</var></syntax>
+<syntax>ProxyRemote <var>match</var> <var>remote-server</var> [<var>username:password</var>]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
+<compatibility>Le troisième argument facultatif est disponible depuis la version
+2.5.1 du serveur HTTP Apache.</compatibility>
<usage>
<p>Cette directive permet de définir des mandataires distants pour
- ce mandataire. <var>comparaison</var> est soit le nom d'un protocole
+ ce mandataire. <var>match</var> est soit le nom d'un protocole
que supporte le serveur distant, soit une URL partielle pour
laquelle le serveur distant devra être utilisé, soit <code>*</code>
pour indiquer que le serveur distant doit être utilisé pour toutes
- les requêtes. <var>serveur-distant</var> est une URL partielle
+ les requêtes. <var>remote-server</var> est une URL partielle
correspondant au serveur distant. Syntaxe : </p>
<example>
- <dfn>serveur-distant</dfn> =
- <var>protocole</var>://<var>nom-serveur</var>[:<var>port</var>]
+ <dfn>remote-server</dfn> =
+ <var>scheme</var>://<var>hostname</var>[:<var>port</var>]
</example>
- <p><var>protocole</var> est effectivement le protocole à utiliser
+ <p><var>scheme</var> est effectivement le protocole à utiliser
pour communiquer avec le serveur distant ; ce module ne supporte que
<code>http</code> et <code>https</code>. Lorsqu'on utilise
<code>https</code>, les requêtes sont redirigées par le mandataire
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.</p>
+
+ <p>Le troisième argument optionnel <var>username:password</var> permet de
+ spécifier des données d'authentification basiques à transmettre au mandataire
+ distant défini. Ces données d'authentification seront toujoujours envoyées
+ sans attendre que le mandataire distant n'effectue une demande
+ d'authentification. La variable d'environnement <a
+ href="mod_proxy_http.html#env">Proxy-Chain-Auth</a> n'est plus prise en
+ compte si cet argument est utilisé.</p>
</usage>
</directivesynopsis>
autorisations qui doivent être définies par Apache httpd.</p>
</note>
</td></tr>
+ <tr><td><a id="addressttl" name="addressttl">addressttl</a></td>
+ <td>-1</td>
+ <td><p>Durée de vie (TTL) en secondes des résolutions DNS de l'adresse
+ du serveur d'arrière-plan dans le cache.
+ -1 signifie jusqu'au redémarrage de Apache httpd.</p>
+ </td></tr>
</table>
<name>ProxyPassMatch</name>
<description>Fait correspondre des serveurs distants dans l'espace d'URL
du serveur local en utilisant des expressions rationnelles</description>
-<syntax>ProxyPassMatch [<var>regex</var>] !|<var>url</var>
-[<var>clé=valeur</var>
- <var>[clé=valeur</var> ...]]</syntax>
+<syntax>ProxyPassMatch [<var>regex</var>] !|<var>url</var> [<var>key=value</var>
+ <var>[key=value</var> ...]]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context>
</contextlist>
+<compatibility>Depuis la version 2.4.47, les paramètres <var>key=value</var>
+sont pris en compte lorsque le paramètre <var>url</var> contient des références
+arrières (voir note ci-dessous).
+</compatibility>
<usage>
<p>Cette directive est identique à la directive <directive
<code>http://example.com/foo/bar.gif</code> en une requête mandatée
pour <code>http://backend.example.com/foo/bar.gif</code>.</p>
- <note><title>Note</title>
- <p>L'argument URL doit pouvoir être interprété en tant qu'URL
- <em>avant</em> les substitutions d'expressions rationnelles (et
- doit aussi l'être après). Ceci limite les correspondances que vous
- pouvez utiliser. Par exemple, si l'on avait utilisé</p>
- <highlight language="config">
- ProxyPassMatch "^(/.*\.gif)$"
- "http://backend.example.com:8000$1"
- </highlight>
- <p>dans l'exemple précédent, nous aurions provoqué une erreur de
- syntaxe au démarrage du serveur. C'est une bogue (PR 46665 dans
- ASF bugzilla), et il est possible de la contourner en reformulant
- la correspondance :</p>
- <highlight language="config">
- ProxyPassMatch "^/(.*\.gif)$" "http://backend.example.com:8000/$1"
- </highlight>
- </note>
-
<p>Le drapeau <code>!</code> vous permet de ne pas mandater un
sous-répertoire donné.</p>
</p>
</note>
+ <note>
+ <title>Paramètres <code>key=value</code> et <var>url</var> avec
+ références arrières</title>
+ <p>Depuis la version 2.4.47, les paramètres <code>key=value</code> ne sont
+ plus ignorés dans une directive <directive>ProxyPassMatch</directive>
+ lorsqu'on utilise une <var>url</var> contenant des références arrières.
+ Cependant, pour conserver le comportement précédent relatif à la
+ réutilisation/conservation des connexions d'arrière-plan (qui n'avaient
+ jamais été réutilisées auparavant pour ces URLs), les paramètres
+ <var>enablereuse</var> et <var>disablereuse</var> prendront dans ce cas
+ respectivement comme valeurs par défaut <code>off</code> et
+ <code>on</code>. Définir explicitement <code>enablereuse=on</code> permet
+ de réutiliser les connexions, <strong>sauf si</strong> des références
+ arrières se trouvent dans la partie <code>authority</code> (nom d'hôte
+ et/ou port) de l'<var>url</var> (cette condition est imposée depuis la
+ version 2.4.55 du serveur HTTP Apache et provoque un avertissement au
+ démarrage car ces URLs ne sont pas réutilisables sous cette forme).</p>
+ </note>
+
<note type="warning">
<title>Avertissement à propos de la sécurité</title>
<p>Lors de la construction de l'URL cible de la règle, il convient
projects / thirdparty / apache / httpd.git / commitdiff
