XML update.

<?xml version="1.0"?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>

<!-- English Revision: 1690350:1696884 (outdated) -->

<!-- English Revision: 1696884 -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->

      demand&eacute;</em>. Pour obtenir un contenu h&eacute;berg&eacute; par

      le serveur demandé, le client envoie une requête au

      mandataire en nommant le serveur demandé comme

      cible, puis le mandataire extrait le contenu depuis le

      cible. Le mandataire extrait alors le contenu depuis le

      serveur demandé et le renvoie enfin au client. Le client doit être

      configuré de manière appropriée pour pouvoir utiliser le mandataire

      direct afin d'acc&eacute;der &agrave; d'autres sites.</p>

      <p>Cette directive va cr&eacute;er un worker associ&eacute; &agrave; l'URL du serveur

      original <code>http://backend.example.com</code>, et utilisant les

      original <code>http://backend.example.com</code> 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 <directive module="mod_proxy">ProxySet</directive>,</p>

<usage>

    <p>Lorsqu'elle est activ&eacute;e, cette directive va transmettre l'en-t&ecirc;te

    Host: de la requête entrante vers le serveur mandaté, au lieu du nom

    d'h&ocirc;te sp&eacute;cifi&eacute; par la directive <directive>ProxyPass</directive>.</p>

    d'h&ocirc;te sp&eacute;cifi&eacute; par la directive <directive

    module="mod_proxy">ProxyPass</directive>.</p>

    <p>Cette directive est habituellement d&eacute;finie &agrave; <code>Off</code>.

    Elle est principalement utile dans les configurations particulières

    HTTP, vers un autre mandataire capable de les traiter.</p>

    <p>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.</p>

</usage>

<usage>

    <p>Cette directive permet de r&eacute;f&eacute;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&eacute; <dfn>mandataire inverse</dfn> ou

    <code>unix:</code> tient compte de la directive

    <directive>DefaultRuntimeDir</directive>.</note>

    <p>Lorsque cette directive est utilis&eacute;e dans une section <directive

    type="section" module="core">Location</directive>, le premier

    argument est omis et le répertoire local est obtenu à partir de

    l'argument de la directive <directive type="section"

    module="core">Location</directive>. Il en est de m&ecirc;me &agrave; l'int&eacute;rieur

    d'une section <directive type="section"

    module="core">LocationMatch</directive>, mais le r&eacute;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 <directive type="section"

    module="core">Location</directive> s&eacute;par&eacute;e.</p>

    <p>Supposons que le serveur local a pour adresse

    <code>http://example.com/</code> ; alors la ligne</p>

    <code>http://example.com/miroir/foo/bar</code> en une requ&ecirc;te

    mandat&eacute;e pour <code>http://backend.example.com/bar</code>.</p>

    <p>La directive ProxyPass ne peut pas &ecirc;tre plac&eacute;e dans une section

    <directive type="section" module="core">Directory</directive> ou

    <directive type="section" module="core">Files</directive>.</p>

    <p>Si vous avez besoin d'un configuration de mandataire inverse plus

    souple, reportez-vous &agrave; la documentaion de la directive <directive

    module="mod_rewrite">RewriteRule</directive> et son drapeau

    <code>[P]</code>.</p>

    <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

    </note> <!-- /ordering_proxypass -->

    <p><strong>ProxyPass <code>cl&eacute;=valeur</code> Param&egrave;tres</strong></p>

    <p>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 <directive>ProxyPass</directive> au moyen de param&egrave;tres

    <code>cl&eacute;=valeur</code> dont la description fait l'objet du tableau

    ci-dessous.</p>

    <code>cl&eacute;=valeur</code> dont la description fait l'objet des

    tableaux ci-dessous.</p>

    <p>Par d&eacute;faut, mod_proxy permet et met en r&eacute;serve le nombre maximum

    de connexions pouvant être utilisées simultanément par le processus

        <td>off</td>

        <td>Permet de d&eacute;finir si le module mandataire doit vider

	automatiquement le tampon de sortie après chaque tronçon de

	données. 'off' signifie que le tampon sera vidé si nécessaire,

	'on' que le tampon sera vidé après chaque envoi d'un

	données. 'off' signifie que le tampon sera vidé si

	nécessaire ;

	'on' signifie que le tampon sera vidé après chaque envoi d'un

	tronçon de données, et 'auto' que le tampon sera vidé après un

	délai de 'flushwait' millisecondes si aucune entrée n'est reçue.

	Actuellement, cette clé n'est supportée que par AJP.

</Proxy>

    </highlight>

    <p><strong>Mots-cl&eacute;s additionnels de ProxyPass</strong></p>

    <p>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

    </p>

    <p><var>chemin</var> est le nom d'un chemin virtuel local.

    <var>url</var> est une URL partielle pour le serveur distant - ils

    sont utilis&eacute;s de la m&ecirc;me fa&ccedil;on qu'avec la directive <directive

    module="mod_proxy">ProxyPass</directive>.</p>

    <var>url</var> est une URL partielle pour le serveur distant. Ces

    paramètres s'utilisent de la même façon qu'avec la

    directive <directive module="mod_proxy">ProxyPass</directive>.</p>

    <p>Supposons par exemple que le serveur local a pour adresse

    <code>http://example.com/</code> ; alors</p>

    requ&ecirc;te mandat&eacute;e pour <code>http://backend.example.com/bar</code>

    (la fonctionnalit&eacute; fournie par <code>ProxyPass</code>). Il va

    aussi s'occuper des redirections que le serveur

    <code>backend.example.com</code> envoie : lorsque

    <code>http://backend.example.com/bar</code> est redirig&eacute; par

    celui-ci vers <code>http://backend.example.com/quux</code>, Apache

    <code>backend.example.com</code> envoie lorsqu'il redirige

    <code>http://backend.example.com/bar</code> vers

    <code>http://backend.example.com/quux</code>. Apache

    httpd corrige ceci en <code>http://example.com/miroir/foo/quux</code>

    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

    module="core">UseCanonicalName</directive>.</p>

    <p>Notez que la directive <directive>ProxyPassReverse</directive>

    peut aussi être utilisée en conjonction avec la fonctionnalité

    pass-through (<code>RewriteRule ...  [P]</code>) du module

    peut aussi être utilisée en conjonction avec la

    fonctionnalité de mandataire

    (<code>RewriteRule ...  [P]</code>) du module

    <module>mod_rewrite</module>, car elle ne d&eacute;pend pas d'une directive

    <directive module="mod_proxy">ProxyPass</directive>

    correspondante.</p>