You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by lg...@apache.org on 2016/02/13 15:43:05 UTC
svn commit: r1730220 [2/3] - in /httpd/httpd/branches/2.2.x/docs/manual:
mod/mod_proxy.xml.fr upgrading.xml.fr
Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy.xml.fr?rev=1730220&r1=1730219&r2=1730220&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy.xml.fr (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy.xml.fr Sat Feb 13 14:43:05 2016
@@ -1,7 +1,7 @@
-<?xml version="1.0"?>
+<?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: 1696886:1729281 (outdated) -->
+<!-- English Revision: 1729281 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -32,40 +32,40 @@
<summary>
<note type="warning"><title>Avertissement</title>
- <p>N'activez pas la fonctionnalité de mandataire avec la directive
+ <p>N'activez pas la fonctionnalité de mandataire avec la directive
<directive module="mod_proxy">ProxyRequests</directive> avant
- d'avoir <a href="#access">sécurisé votre serveur</a>. Les serveurs
- mandataires ouverts sont dangereux pour votre réseau,
+ d'avoir <a href="#access">sécurisé votre serveur</a>. Les serveurs
+ mandataires ouverts sont dangereux pour votre réseau,
mais aussi pour l'Internet au sens large.</p>
</note>
- <p>Ce module implémente un mandataire/passerelle pour Apache. Il
- implémente la fonctionnalité de mandataire pour <code>AJP13</code>
+ <p>Ce module implémente un mandataire/passerelle pour Apache. Il
+ implémente la fonctionnalité de mandataire pour <code>AJP13</code>
(Apache JServe Protocol version 1.3), <code>FTP</code>,
<code>CONNECT</code> (pour SSL), <code>HTTP/0.9</code>,
- <code>HTTP/1.0</code>, et <code>HTTP/1.1</code>. Le module peut être
- configuré pour se connecter aux autres modules mandataires qui
- gèrent ces protocoles.</p>
-
- <p>Les diverses fonctionnalités de
- mandataire d'Apache sont réparties entre plusieurs modules
- complémentaires de <module>mod_proxy</module> :
+ <code>HTTP/1.0</code>, et <code>HTTP/1.1</code>. Le module peut être
+ configuré pour se connecter aux autres modules mandataires qui
+ gèrent ces protocoles.</p>
+
+ <p>Les diverses fonctionnalités de
+ mandataire d'Apache sont réparties entre plusieurs modules
+ complémentaires de <module>mod_proxy</module> :
<module>mod_proxy_http</module>, <module>mod_proxy_ftp</module>,
<module>mod_proxy_ajp</module>, <module>mod_proxy_balancer</module>,
et <module>mod_proxy_connect</module>. Ainsi, si vous voulez
- utiliser une ou plusieurs fonctionnalités de mandataire
- particulières, chargez <module>mod_proxy</module> <em>et</em> le(s)
- module(s) approprié(s) dans le serveur (soit statiquement à la
+ utiliser une ou plusieurs fonctionnalités de mandataire
+ particulières, chargez <module>mod_proxy</module> <em>et</em> le(s)
+ module(s) approprié(s) dans le serveur (soit statiquement à la
compilation, soit dynamiquement via la directive <directive
module="mod_so">LoadModule</directive>).</p>
- <p>En outre, d'autres modules fournissent des fonctionnalités
- étendues. <module>mod_cache</module> et ses modules associés
+ <p>En outre, d'autres modules fournissent des fonctionnalités
+ étendues. <module>mod_cache</module> et ses modules associés
fournissent la mise en cache. Les directives <code>SSLProxy*</code>
du module <module>mod_ssl</module> permettent de contacter des
serveurs distants en utilisant le protocole SSL/TLS. Ces modules
- additionnels devront être chargés et configurés pour pouvoir
- disposer de ces fonctionnalités.</p>
+ additionnels devront être chargés et configurés pour pouvoir
+ disposer de ces fonctionnalités.</p>
</summary>
<seealso><module>mod_cache</module></seealso>
<seealso><module>mod_proxy_http</module></seealso>
@@ -76,69 +76,69 @@
<section id="forwardreverse"><title>Mandataires directs et
mandataires/passerelles inverses</title>
- <p>Apache peut être configuré dans les deux modes mandataire
- <dfn>direct</dfn> et mandataire <dfn>inverse</dfn> (aussi nommé
+ <p>Apache peut être configuré dans les deux modes mandataire
+ <dfn>direct</dfn> et mandataire <dfn>inverse</dfn> (aussi nommé
mode <dfn>passerelle</dfn>).</p>
<p>Un <dfn>mandataire direct</dfn> standard est un serveur
- intermédiaire qui s'intercale entre le client et le <em>serveur
- demandé</em>. Pour obtenir un contenu hébergé par
- le serveur demandé, le client envoie une requête au
- mandataire en nommant le serveur demandé comme
+ intermédiaire qui s'intercale entre le client et le <em>serveur
+ demandé</em>. Pour obtenir un contenu hébergé 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
- 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éder à d'autres sites.</p>
+ 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éder à d'autres sites.</p>
- <p>L'accès à Internet depuis des clients situés derrière un
+ <p>L'accès à Internet depuis des clients situés derrière un
pare-feu est une utilisation typique du mandataire direct. Le
mandataire direct peut aussi utiliser la mise en cache (fournie
- par <module>mod_cache</module>) pour réduire la charge du
- réseau.</p>
+ par <module>mod_cache</module>) pour réduire la charge du
+ réseau.</p>
- <p>La fonctionnalité de mandataire direct est activée via la
+ <p>La fonctionnalité de mandataire direct est activée via la
directive <directive module="mod_proxy">ProxyRequests</directive>.
- Comme les mandataires directs permettent aux clients d'accéder à
+ Comme les mandataires directs permettent aux clients d'accéder Ã
des sites quelconques via votre serveur et de dissimuler leur
- véritable origine, il est indispensable de <a
- href="#access">sécuriser votre serveur</a> de façon à ce que seuls
- les clients autorisés puissent accéder à votre serveur avant
- d'activer la fonctionnalité de mandataire direct.</p>
+ véritable origine, il est indispensable de <a
+ href="#access">sécuriser votre serveur</a> de façon à ce que seuls
+ les clients autorisés puissent accéder à votre serveur avant
+ d'activer la fonctionnalité de mandataire direct.</p>
<p>Un <dfn>mandataire inverse</dfn> (ou <dfn>passerelle</dfn>),
- quant à lui, apparaît au client comme un serveur web standard.
- Aucune configuration particulière du client n'est nécessaire. Le
+ quant à lui, apparaît au client comme un serveur web standard.
+ Aucune configuration particulière du client n'est nécessaire. Le
client adresse ses demandes de contenus ordinaires dans l'espace
- de nommage du mandataire inverse. Ce dernier décide alors où
- envoyer ces requêtes, et renvoie le contenu au client comme s'il
- l'hébergeait lui-même.</p>
+ de nommage du mandataire inverse. Ce dernier décide alors où
+ envoyer ces requêtes, et renvoie le contenu au client comme s'il
+ l'hébergeait lui-même.</p>
- <p>L'accès des utilisateurs à Internet pour un serveur situé
- derrière un pare-feu est une utilisation typique du mandataire
+ <p>L'accès des utilisateurs à Internet pour un serveur situé
+ derrière un pare-feu est une utilisation typique du mandataire
inverse. On peut aussi utiliser les mandataires inverses pour
- mettre en oeuvre une répartition de charge entre plusieurs
- serveurs en arrière-plan, ou fournir un cache pour un serveur
- d'arrière-plan plus lent. Les mandataires inverses peuvent aussi
- tout simplement servir à rassembler plusieurs serveurs dans le
- même espace de nommage d'URLs.</p>
+ mettre en oeuvre une répartition de charge entre plusieurs
+ serveurs en arrière-plan, ou fournir un cache pour un serveur
+ d'arrière-plan plus lent. Les mandataires inverses peuvent aussi
+ tout simplement servir à rassembler plusieurs serveurs dans le
+ même espace de nommage d'URLs.</p>
- <p>La fonctionnalité de mandataire inverse est activée via la
+ <p>La fonctionnalité de mandataire inverse est activée via la
directive <directive module="mod_proxy">ProxyPass</directive> ou
le drapeau <code>[P]</code> de la directive <directive
module="mod_rewrite">RewriteRule</directive>. Il n'est
- <strong>pas</strong> nécessaire de définir <directive
- module="mod_proxy">ProxyRequests</directive> à on pour configurer
+ <strong>pas</strong> nécessaire de définir <directive
+ module="mod_proxy">ProxyRequests</directive> Ã on pour configurer
un mandataire inverse.</p>
</section> <!-- /forwardreverse -->
<section id="examples"><title>Exemples simples</title>
- <p>Les exemples ci-dessous illustrent de manière très basique la
- mise en oeuvre de la fonctionnalité de mandataire et ne sont là que
- pour vous aider à démarrer. Reportez-vous à la documentation de
+ <p>Les exemples ci-dessous illustrent de manière très basique la
+ mise en oeuvre de la fonctionnalité de mandataire et ne sont là que
+ pour vous aider à démarrer. Reportez-vous à la documentation de
chaque directive.</p>
- <p>Si en outre, vous désirez activer la mise en cache, consultez la
+ <p>Si en outre, vous désirez activer la mise en cache, consultez la
documentation de <module>mod_cache</module>.</p>
<example><title>Mandataire inverse</title>
@@ -162,22 +162,22 @@
</section> <!-- /examples -->
<section id="workers"><title>Gestionnaires de serveurs (workers)</title>
- <p>Le mandataire gère la configuration des serveurs originaux,
- ainsi que leurs paramètres de communication dans des objets
- appelés <dfn>workers</dfn> ou Gestionnaires de serveur. Deux
- workers intégrés par défaut sont disponibles : le worker de
+ <p>Le mandataire gère la configuration des serveurs originaux,
+ ainsi que leurs paramètres de communication dans des objets
+ appelés <dfn>workers</dfn> ou Gestionnaires de serveur. Deux
+ workers intégrés par défaut sont disponibles : le worker de
mandataire direct et le worker de mandataire inverse. Des workers
- supplémentaires peuvent être configurés explicitement.</p>
+ supplémentaires peuvent être configurés explicitement.</p>
- <p>Les deux workers par défaut ont une configuration fixe et
- seront utilisés si aucun autre worker ne correspond à la requête.
+ <p>Les deux workers par défaut ont une configuration fixe et
+ seront utilisés si aucun autre worker ne correspond à la requête.
Ils n'utilisent ni les connexions HTTP persistantes, ni les jeux
de connexions. Les connexions TCP vers le serveur original seront
- donc ouvertes et fermées pour chaque requête.</p>
+ donc ouvertes et fermées pour chaque requête.</p>
- <p>Les workers configurés explicitement sont identifiés par leur
- URL. Dans le cas d'un mandataire inverse, ils sont généralement
- créés et configurés via les directives <directive
+ <p>Les workers configurés explicitement sont identifiés par leur
+ URL. Dans le cas d'un mandataire inverse, ils sont généralement
+ créés et configurés via les directives <directive
module="mod_proxy">ProxyPass</directive> ou <directive
module="mod_proxy">ProxyPassMatch</directive> :</p>
@@ -185,10 +185,10 @@
ProxyPass /example http://backend.example.com connectiontimeout=5 timeout=30
</example>
- <p>Cet exemple crée un worker associé à l'URL du serveur original
- <code>http://backend.example.com</code>, qui utilisera les délais
- spécifiés. Dans le cas d'un mandataire direct, les workers sont
- généralement définis via la directive <directive
+ <p>Cet exemple crée un worker associé à l'URL du serveur original
+ <code>http://backend.example.com</code>, qui utilisera les délais
+ spécifiés. Dans le cas d'un mandataire direct, les workers sont
+ généralement définis via la directive <directive
module="mod_proxy">ProxySet</directive> directive :</p>
<example>
@@ -207,36 +207,36 @@
</Proxy>
</example>
- <p>L'utilisation de workers configurés explicitement dans le mode
- direct n'est pas très courante, car les mandataires directs
+ <p>L'utilisation de workers configurés explicitement dans le mode
+ direct n'est pas très courante, car les mandataires directs
communiquent avec de nombreux serveurs originaux. Il est cependant
- intéressant de créer des workers explicites pour certains serveurs
- originaux si ces derniers sont utilisés très souvent. Les workers
- configurés explicitement n'ont en eux-mêmes aucun concept de
+ intéressant de créer des workers explicites pour certains serveurs
+ originaux si ces derniers sont utilisés très souvent. Les workers
+ configurés explicitement n'ont en eux-mêmes aucun concept de
mandataire direct ou inverse. Ils encapsulent un concept de
- communication commun avec les serveurs originaux. Un worker créé
+ communication commun avec les serveurs originaux. Un worker créé
via la directive <directive
- module="mod_proxy">ProxyPass</directive> pour être utilisé avec un
- mandataire inverse, sera aussi utilisé pour les requêtes mandatées
- en direct chaque fois que l'URL du serveur original correspondra à
+ module="mod_proxy">ProxyPass</directive> pour être utilisé avec un
+ mandataire inverse, sera aussi utilisé pour les requêtes mandatées
+ en direct chaque fois que l'URL du serveur original correspondra Ã
l'URL du worker, et vice versa.</p>
- <p>L'URL identifiant un worker direct correspond à l'URL de son
- serveur original comportant tout élément de chemin éventuel :</p>
+ <p>L'URL identifiant un worker direct correspond à l'URL de son
+ serveur original comportant tout élément de chemin éventuel :</p>
<example>
ProxyPass /examples http://backend.example.com/examples<br />
ProxyPass /docs http://backend.example.com/docs
</example>
- <p>Cet exemple définit deux workers différents, chacun d'entre eux
- utilisant une configuration et un jeu de connexions séparés.</p>
+ <p>Cet exemple définit deux workers différents, chacun d'entre eux
+ utilisant une configuration et un jeu de connexions séparés.</p>
<note type="warning"><title>Partage de worker</title>
<p>Le partage de worker se produit lorsque les URLs des workers
- se chevauchent, c'est à dire lorsque l'URL d'un worker
- correspond à une partie du début de l'URL d'un autre worker
- défini plus loin dans le fichier de configuration. Dans
+ se chevauchent, c'est à dire lorsque l'URL d'un worker
+ correspond à une partie du début de l'URL d'un autre worker
+ défini plus loin dans le fichier de configuration. Dans
l'exemple suivant,</p>
<example>
@@ -244,58 +244,58 @@
ProxyPass /examples http://backend.example.com/examples timeout=10
</example>
- <p>le second worker n'est pas vraiment créé. C'est le premier
- worker qui est utilisé à sa place. L'avantage de ceci réside
+ <p>le second worker n'est pas vraiment créé. C'est le premier
+ worker qui est utilisé à sa place. L'avantage de ceci réside
dans le fait qu'il n'y a plus qu'un jeu de connexions, celles-ci
- étant donc réutilisées plus souvent. Notez que tous les
- attributs de configuration définis explicitement pour le second
- worker et certaines valeurs par défaut vont écraser la
- configuration définie pour le premier worker, ce qui va
+ étant donc réutilisées plus souvent. Notez que tous les
+ attributs de configuration définis explicitement pour le second
+ worker et certaines valeurs par défaut vont écraser la
+ configuration définie pour le premier worker, ce qui va
provoquer la journalisation d'un avertissement. Dans l'exemple
- précédent, la valeur de délai finale pour l'URL
+ précédent, la valeur de délai finale pour l'URL
<code>/apps</code> sera <code>10</code> au lieu de <code>60</code> !</p>
- <p>Pour éviter ce partage, classez vos définitions de workers de
- l'URL la plus longue à la plus courte. Si au contraire, vous
+ <p>Pour éviter ce partage, classez vos définitions de workers de
+ l'URL la plus longue à la plus courte. Si au contraire, vous
voulez favoriser ce partage, utilisez l'ordre de classement
- inverse. Voir aussi l'avertissement en rapport à propos de
+ inverse. Voir aussi l'avertissement en rapport à propos de
l'ordre de classement des directives <directive
module="mod_proxy">ProxyPass</directive>.</p>
</note> <!-- /worker_sharing -->
- <p>Les workers configurés explicitement sont de deux sortes :
- <dfn>workers directs</dfn> et <dfn>workers à répartition (de
+ <p>Les workers configurés explicitement sont de deux sortes :
+ <dfn>workers directs</dfn> et <dfn>workers à répartition (de
charge)</dfn>. Ils supportent de nombreux attributs de
- configuration importants décrits ci-dessous dans la directive
+ configuration importants décrits ci-dessous dans la directive
<directive module="mod_proxy">ProxyPass</directive>. Tous ces
- attributs peuvent aussi être définis via la directive <directive
+ attributs peuvent aussi être définis via la directive <directive
module="mod_proxy">ProxySet</directive>.</p>
- <p>Le jeu d'options disponibles pour un worker direct dépend du
- protocole, qui est spécifié dans l'URL du serveur original. Parmi
+ <p>Le jeu d'options disponibles pour un worker direct dépend du
+ protocole, qui est spécifié dans l'URL du serveur original. Parmi
les protocoles disponibles, on trouve <code>ajp</code>,
<code>ftp</code>, <code>http</code> et <code>scgi</code>.</p>
- <p>Les workers à répartition sont des workers virtuels qui
- utilisent des workers directs considérés comme leurs membres pour
- le traitement effectif des requêtes. Chaque répartiteur peut
- posséder plusieurs membres. Pour traiter une requête, il choisit
- un de ses membres en fonction de l'algorithme de répartition de
- charge défini.</p>
-
- <p>Un worker à répartition est créé si son URL utilise
- <code>balancer</code> comme protocole. L'URL de répartition
- identifie de manière unique le worker à répartition. On peut
- ajouter des membres à un répartiteur via la directive <directive
+ <p>Les workers à répartition sont des workers virtuels qui
+ utilisent des workers directs considérés comme leurs membres pour
+ le traitement effectif des requêtes. Chaque répartiteur peut
+ posséder plusieurs membres. Pour traiter une requête, il choisit
+ un de ses membres en fonction de l'algorithme de répartition de
+ charge défini.</p>
+
+ <p>Un worker à répartition est créé si son URL utilise
+ <code>balancer</code> comme protocole. L'URL de répartition
+ identifie de manière unique le worker à répartition. On peut
+ ajouter des membres à un répartiteur via la directive <directive
module="mod_proxy">BalancerMember</directive>.</p>
</section> <!-- /workers -->
- <section id="access"><title>Contrôler l'accès à votre
+ <section id="access"><title>Contrôler l'accès à votre
mandataire</title>
- <p>Vous pouvez restreindre l'accès à votre mandataire via le bloc
- de contrôle <directive
+ <p>Vous pouvez restreindre l'accès à votre mandataire via le bloc
+ de contrôle <directive
module="mod_proxy" type="section">Proxy</directive> comme dans
l'exemple suivant :</p>
@@ -309,71 +309,71 @@
</Proxy>
</example>
- <p>Pour plus de détails sur les directives de contrôle d'accès,
+ <p>Pour plus de détails sur les directives de contrôle d'accès,
voir la documentation du module
<module>mod_authz_host</module>.</p>
- <p>Restreindre l'accès de manière stricte est essentiel si vous
- mettez en oeuvre un mandataire direct (en définissant la directive
- <directive module="mod_proxy">ProxyRequests</directive> à "on").
- Dans le cas contraire, votre serveur pourrait être utilisé par
- n'importe quel client pour accéder à des serveurs quelconques,
- tout en masquant sa véritable identité. Ceci représente un danger
- non seulement pour votre réseau, mais aussi pour l'Internet au
+ <p>Restreindre l'accès de manière stricte est essentiel si vous
+ mettez en oeuvre un mandataire direct (en définissant la directive
+ <directive module="mod_proxy">ProxyRequests</directive> Ã "on").
+ Dans le cas contraire, votre serveur pourrait être utilisé par
+ n'importe quel client pour accéder à des serveurs quelconques,
+ tout en masquant sa véritable identité. Ceci représente un danger
+ non seulement pour votre réseau, mais aussi pour l'Internet au
sens large. Dans le cas de la mise en oeuvre d'un mandataire
inverse (en utilisant la directive <directive
- module="mod_proxy">ProxyPass</directive> avec <code>ProxyRequests Off</code>), le contrôle
- d'accès est moins critique car les clients ne peuvent contacter
- que les serveurs que vous avez spécifiés.</p>
+ module="mod_proxy">ProxyPass</directive> avec <code>ProxyRequests Off</code>), le contrôle
+ d'accès est moins critique car les clients ne peuvent contacter
+ que les serveurs que vous avez spécifiés.</p>
</section> <!-- /access -->
- <section id="startup"><title>Ralentissement au démarragep</title>
+ <section id="startup"><title>Ralentissement au démarragep</title>
<p>Si vous utilisez la directive <directive module="mod_proxy"
- >ProxyBlock</directive>, les noms d'hôtes sont résolus en adresses
- IP puis ces dernières mises en cache au cours du démarrage
- à des fins de tests de comparaisons ultérieurs. Ce processus peut
+ >ProxyBlock</directive>, les noms d'hôtes sont résolus en adresses
+ IP puis ces dernières mises en cache au cours du démarrage
+ à des fins de tests de comparaisons ultérieurs. Ce processus peut
durer plusieurs secondes (ou d'avantage) en fonction de la vitesse
- à laquelle s'effectue la résolution des noms d'hôtes.</p>
+ à laquelle s'effectue la résolution des noms d'hôtes.</p>
</section> <!-- /startup -->
<section id="intranet"><title>Mandataire d'Intranet</title>
- <p>Un serveur mandataire Apache situé à l'intérieur d'un Intranet
- doit faire suivre les requêtes destinées à un serveur externe à
- travers le pare-feu de l'entreprise (pour ce faire, définissez la
+ <p>Un serveur mandataire Apache situé à l'intérieur d'un Intranet
+ doit faire suivre les requêtes destinées à un serveur externe Ã
+ travers le pare-feu de l'entreprise (pour ce faire, définissez la
directive <directive module="mod_proxy">ProxyRemote</directive> de
- façon à ce qu'elle fasse suivre le <var>protocole</var> concerné
- vers le mandataire du pare-feu). Cependant, lorsqu'il doit accéder
- à des ressources situées dans l'Intranet, il peut se passer du
- pare-feu pour accéder aux serveurs. A cet effet, la directive
+ façon à ce qu'elle fasse suivre le <var>protocole</var> concerné
+ vers le mandataire du pare-feu). Cependant, lorsqu'il doit accéder
+ à des ressources situées dans l'Intranet, il peut se passer du
+ pare-feu pour accéder aux serveurs. A cet effet, la directive
<directive module="mod_proxy">NoProxy</directive> permet de
- spécifier quels hôtes appartiennent à l'Intranet et peuvent donc
- être accédés directement.</p>
+ spécifier quels hôtes appartiennent à l'Intranet et peuvent donc
+ être accédés directement.</p>
- <p>Les utilisateurs d'un Intranet ont tendance à oublier le nom du
- domaine local dans leurs requêtes WWW, et demandent par exemple
+ <p>Les utilisateurs d'un Intranet ont tendance à oublier le nom du
+ domaine local dans leurs requêtes WWW, et demandent par exemple
"http://un-serveur/" au lieu de
<code>http://un-serveur.example.com/</code>. Certains serveurs
- mandataires commerciaux acceptent ce genre de requête et les
+ mandataires commerciaux acceptent ce genre de requête et les
traitent simplement en utilisant un nom de domaine local
implicite. Lorsque la directive <directive
- module="mod_proxy">ProxyDomain</directive> est utilisée et si le
- serveur est <a href="#proxyrequests">configuré comme
- mandataire</a>, Apache peut renvoyer une réponse de redirection et
+ module="mod_proxy">ProxyDomain</directive> est utilisée et si le
+ serveur est <a href="#proxyrequests">configuré comme
+ mandataire</a>, Apache peut renvoyer une réponse de redirection et
ainsi fournir au client l'adresse de serveur correcte,
- entièrement qualifiée. C'est la méthode à privilégier car le
+ entièrement qualifiée. C'est la méthode à privilégier car le
fichier des marque-pages de l'utilisateur contiendra alors des
- noms de serveurs entièrement qualifiés.</p>
+ noms de serveurs entièrement qualifiés.</p>
</section> <!-- /intranet -->
<section id="envsettings"><title>Ajustements relatifs au
protocole</title>
- <p>Pour les cas où <module>mod_proxy</module> envoie des requêtes
- vers un serveur qui n'implémente pas correctement les connexions
+ <p>Pour les cas où <module>mod_proxy</module> envoie des requêtes
+ vers un serveur qui n'implémente pas correctement les connexions
persistantes ou le protocole HTTP/1.1, il existe deux variables
- d'environnement qui permettent de forcer les requêtes à utiliser
+ d'environnement qui permettent de forcer les requêtes à utiliser
le protocole HTTP/1.0 avec connexions non persistantes. Elles
- peuvent être définies via la directive <directive
+ peuvent être définies via la directive <directive
module="mod_env">SetEnv</directive>.</p>
<p>Il s'agit des variables <code>force-proxy-request-1.0</code> et
@@ -391,80 +391,80 @@
</section> <!-- /envsettings -->
- <section id="request-bodies"><title>Corps de requêtes</title>
+ <section id="request-bodies"><title>Corps de requêtes</title>
- <p>Certaines méthodes de requêtes comme POST comportent un corps de
- requête. Le protocole HTTP stipule que les requêtes qui comportent
+ <p>Certaines méthodes de requêtes comme POST comportent un corps de
+ requête. Le protocole HTTP stipule que les requêtes qui comportent
un corps doivent soit utiliser un codage de transmission
- fractionnée, soit envoyer un en-tête de requête
+ fractionnée, soit envoyer un en-tête de requête
<code>Content-Length</code>. Lorsqu'il fait suivre ce genre de
- requête vers le serveur demandé, <module>mod_proxy_http</module>
- s'efforce toujours d'envoyer l'en-tête <code>Content-Length</code>.
- Par contre, si la taille du corps est importante, et si la requête
- originale utilise un codage à fractionnement, ce dernier peut aussi
- être utilisé dans la requête montante. Ce comportement peut être
- contrôlé à l'aide de <a href="../env.html">variables
- d'environnement</a>. Ainsi, si elle est définie, la variable
- <code>proxy-sendcl</code> assure une compatibilité maximale avec les
- serveurs demandés en imposant l'envoi de l'en-tête
+ requête vers le serveur demandé, <module>mod_proxy_http</module>
+ s'efforce toujours d'envoyer l'en-tête <code>Content-Length</code>.
+ Par contre, si la taille du corps est importante, et si la requête
+ originale utilise un codage à fractionnement, ce dernier peut aussi
+ être utilisé dans la requête montante. Ce comportement peut être
+ contrôlé à l'aide de <a href="../env.html">variables
+ d'environnement</a>. Ainsi, si elle est définie, la variable
+ <code>proxy-sendcl</code> assure une compatibilité maximale avec les
+ serveurs demandés en imposant l'envoi de l'en-tête
<code>Content-Length</code>, alors que
<code>proxy-sendchunked</code> diminue la consommation de ressources
- en imposant l'utilisation d'un codage à fractionnement.</p>
+ en imposant l'utilisation d'un codage à fractionnement.</p>
</section> <!-- /request-bodies -->
- <section id="x-headers"><title>En-têtes de requête du mandataire
+ <section id="x-headers"><title>En-têtes de requête du mandataire
inverse</title>
- <p>Lorsqu'il est configuré en mode mandataire inverse (en utilisant
+ <p>Lorsqu'il est configuré en mode mandataire inverse (en utilisant
par exemple la directive <directive
module="mod_proxy">ProxyPass</directive>),
- <module>mod_proxy_http</module> ajoute plusieurs en-têtes de requête
- afin de transmettre des informations au serveur demandé. Ces
- en-têtes sont les suivants :</p>
+ <module>mod_proxy_http</module> ajoute plusieurs en-têtes de requête
+ afin de transmettre des informations au serveur demandé. Ces
+ en-têtes sont les suivants :</p>
<dl>
<dt><code>X-Forwarded-For</code></dt>
<dd>L'adresse IP du client.</dd>
<dt><code>X-Forwarded-Host</code></dt>
- <dd>L'hôte d'origine demandé par le client dans l'en-tête de
- requête HTTP <code>Host</code>.</dd>
+ <dd>L'hôte d'origine demandé par le client dans l'en-tête de
+ requête HTTP <code>Host</code>.</dd>
<dt><code>X-Forwarded-Server</code></dt>
- <dd>Le nom d'hôte du serveur mandataire.</dd>
+ <dd>Le nom d'hôte du serveur mandataire.</dd>
</dl>
- <p>Ces en-têtes doivent être utilisés avec précautions sur le
- serveur demandé, car ils contiendront plus d'une valeur (séparées
- par des virgules) si la requête original contenait déjà un de ces
- en-têtes. Par exemple, vous pouvez utiliser
- <code>%{X-Forwarded-For}i</code> dans la chaîne de format du journal
- du serveur demandé pour enregistrer les adresses IP des clients
+ <p>Ces en-têtes doivent être utilisés avec précautions sur le
+ serveur demandé, car ils contiendront plus d'une valeur (séparées
+ par des virgules) si la requête original contenait déjà un de ces
+ en-têtes. Par exemple, vous pouvez utiliser
+ <code>%{X-Forwarded-For}i</code> dans la chaîne de format du journal
+ du serveur demandé pour enregistrer les adresses IP des clients
originaux, mais il est possible que vous obteniez plusieurs adresses
- si la requête passe à travers plusieurs mandataires.</p>
+ si la requête passe à travers plusieurs mandataires.</p>
<p>Voir aussi les directives <directive
module="mod_proxy">ProxyPreserveHost</directive> et <directive
module="mod_proxy">ProxyVia</directive> directives, qui permettent
- de contrôler d'autres en-têtes de requête.</p>
+ de contrôler d'autres en-têtes de requête.</p>
</section> <!--/x-headers -->
<directivesynopsis type="section">
<name>Proxy</name>
-<description>Conteneur de directives s'appliquant à des ressources
-mandatées</description>
+<description>Conteneur de directives s'appliquant à des ressources
+mandatées</description>
<syntax><Proxy <var>url-avec-jokers</var>> ...</Proxy></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
- <p>Les directives situées dans une section <directive
+ <p>Les directives situées dans une section <directive
type="section">Proxy</directive> ne s'appliquent qu'au contenu
- mandaté concerné. Les jokers de style shell sont autorisés.</p>
+ mandaté concerné. Les jokers de style shell sont autorisés.</p>
- <p>Par exemple, les lignes suivantes n'autoriseront à accéder à un
- contenu via votre serveur mandataire que les hôtes appartenant à
+ <p>Par exemple, les lignes suivantes n'autoriseront à accéder à un
+ contenu via votre serveur mandataire que les hôtes appartenant Ã
<code>votre-reseau.example.com</code> :</p>
<example>
@@ -477,10 +477,10 @@ mandatées</description>
</Proxy>
</example>
- <p>Dans l'exemple suivant, tous les fichiers du répertoire
- <code>foo</code> de <code>example.com</code> seront traités par le
- filtre <code>INCLUDES</code> lorsqu'ils seront envoyés par
- l'intermédiaire du serveur mandataire :</p>
+ <p>Dans l'exemple suivant, tous les fichiers du répertoire
+ <code>foo</code> de <code>example.com</code> seront traités par le
+ filtre <code>INCLUDES</code> lorsqu'ils seront envoyés par
+ l'intermédiaire du serveur mandataire :</p>
<example>
<Proxy http://example.com/foo/*><br />
@@ -490,19 +490,19 @@ mandatées</description>
</Proxy>
</example>
- <note><title>Différences avec la section de configuration Location</title>
- <p>Une URL d'arrière-plan sera concernée par le conteneur Proxy si
- elle commence par la <var>url-avec-jokers</var>, même si le
- dernier segment de chemin de la directive ne correspond qu'à un
- préfixe de segment dee chemin de l'URL d'arrière-plan. Par exemple, <Proxy
+ <note><title>Différences avec la section de configuration Location</title>
+ <p>Une URL d'arrière-plan sera concernée par le conteneur Proxy si
+ elle commence par la <var>url-avec-jokers</var>, même si le
+ dernier segment de chemin de la directive ne correspond qu'Ã un
+ préfixe de segment dee chemin de l'URL d'arrière-plan. Par exemple, <Proxy
http://example.com/foo> correspondra entre autres aux URLs
http://example.com/foo, http://example.com/foo/bar, et
http://example.com/foobar. La correspondance de l'URL finale
- diffère du comportement de la section <directive type="section"
+ diffère du comportement de la section <directive type="section"
module="core">Location</directive> qui, pour le cas de cette note,
traitera le segment de chemin final comme s'il se terminait par un
slash.</p>
- <p>Pour un contrôle plus fin de la correspondance des URL, voir la
+ <p>Pour un contrôle plus fin de la correspondance des URL, voir la
directive <directive type="section">ProxyMatch</directive>.</p>
</note>
@@ -512,8 +512,8 @@ mandatées</description>
<directivesynopsis>
<name>ProxyBadHeader</name>
-<description>Détermine la manière de traiter les lignes d'en-tête
-incorrectes d'une réponse</description>
+<description>Détermine la manière de traiter les lignes d'en-tête
+incorrectes d'une réponse</description>
<syntax>ProxyBadHeader IsError|Ignore|StartBody</syntax>
<default>ProxyBadHeader IsError</default>
<contextlist><context>server config</context><context>virtual host</context>
@@ -522,35 +522,35 @@ incorrectes d'une réponse</descri
<usage>
<p>La directive <directive>ProxyBadHeader</directive> permet de
- déterminer le comportement de <module>mod_proxy</module> lorsqu'il
- reçoit des lignes d'en-tête de réponse dont la syntaxe n'est pas valide (c'est
- à dire ne contenant pas de caractère ':') en provenance du serveur
+ déterminer le comportement de <module>mod_proxy</module> lorsqu'il
+ reçoit des lignes d'en-tête de réponse dont la syntaxe n'est pas valide (c'est
+ à dire ne contenant pas de caractère ':') en provenance du serveur
original. Les arguments disponibles sont :</p>
<dl>
<dt><code>IsError</code></dt>
- <dd>Annule la requête et renvoie une réponse de code 502 (mauvaise
- passerelle). C'est le comportement par défaut.</dd>
+ <dd>Annule la requête et renvoie une réponse de code 502 (mauvaise
+ passerelle). C'est le comportement par défaut.</dd>
<dt><code>Ignore</code></dt>
- <dd>Traite les lignes d'en-tête incorrectes comme si elles n'avaient
- pas été envoyées.</dd>
+ <dd>Traite les lignes d'en-tête incorrectes comme si elles n'avaient
+ pas été envoyées.</dd>
<dt><code>StartBody</code></dt>
- <dd>A la réception de la première ligne d'en-tête incorrecte, les
- autres en-têtes sont lus et ce qui reste est traité en tant que
- corps. Ceci facilite la prise en compte des serveurs d'arrière-plan
- bogués qui oublient d'insérer une ligne vide entre les
- en-têtes et le corps.</dd>
+ <dd>A la réception de la première ligne d'en-tête incorrecte, les
+ autres en-têtes sont lus et ce qui reste est traité en tant que
+ corps. Ceci facilite la prise en compte des serveurs d'arrière-plan
+ bogués qui oublient d'insérer une ligne vide entre les
+ en-têtes et le corps.</dd>
</dl>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ProxyFtpDirCharset</name>
-<description>Définit le jeu de caractères des listings FTP
-mandatés</description>
-<syntax>ProxyFtpDirCharset <var>jeu-caractères</var></syntax>
+<description>Définit le jeu de caractères des listings FTP
+mandatés</description>
+<syntax>ProxyFtpDirCharset <var>jeu-caractères</var></syntax>
<default>ProxyFtpDirCharset ISO-8859-1</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context></contextlist>
@@ -558,23 +558,23 @@ mandatés</description>
<usage>
<p>La directive <directive>ProxyFtpDirCharset</directive> permet de
- définir le jeu de caractères à utiliser pour les listings FTP en
- HTML générés par <module>mod_proxy_ftp</module>.</p>
+ définir le jeu de caractères à utiliser pour les listings FTP en
+ HTML générés par <module>mod_proxy_ftp</module>.</p>
</usage>
</directivesynopsis>
<directivesynopsis type="section">
<name>ProxyMatch</name>
-<description>Conteneur de directives s'appliquant à des ressources
-mandatées correspondant à une expression rationnelle</description>
+<description>Conteneur de directives s'appliquant à des ressources
+mandatées correspondant à une expression rationnelle</description>
<syntax><ProxyMatch <var>regex</var>> ...</ProxyMatch></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>La directive <directive type="section">ProxyMatch</directive> est
- identique à la directive <directive module="mod_proxy"
- type="section">Proxy</directive>, à l'exception qu'elle définit
+ identique à la directive <directive module="mod_proxy"
+ type="section">Proxy</directive>, à l'exception qu'elle définit
les URLs auxquelles elle s'applique en utilisant une <glossary
ref="regex">expression rationnelle</glossary>.</p>
</usage>
@@ -583,7 +583,7 @@ mandatées correspondant à
<directivesynopsis>
<name>ProxyPreserveHost</name>
-<description>Utilise l'en-tête de requête entrante Host pour la requête
+<description>Utilise l'en-tête de requête entrante Host pour la requête
du mandataire</description>
<syntax>ProxyPreserveHost On|Off</syntax>
<default>ProxyPreserveHost Off</default>
@@ -592,22 +592,22 @@ du mandataire</description>
<compatibility>Disponible depuis la version 2.0.31 d'Apache.</compatibility>
<usage>
- <p>Lorsqu'elle est activée, cette directive va transmettre l'en-tête
- Host: de la requête entrante vers le serveur mandaté, au lieu du nom
- d'hôte spécifié par la directive
+ <p>Lorsqu'elle est activée, cette directive va transmettre l'en-tête
+ Host: de la requête entrante vers le serveur mandaté, au lieu du nom
+ d'hôte spécifié par la directive
<directive>ProxyPass module="mod_proxy"</directive>.</p>
- <p>Cette directive est habituellement définie à <code>Off</code>.
- Elle est principalement utile dans les configurations particulières
- comme l'hébergement virtuel mandaté en masse à base de nom, où
- l'en-tête Host d'origine doit être évalué par le serveur
- d'arrière-plan.</p>
+ <p>Cette directive est habituellement définie à <code>Off</code>.
+ Elle est principalement utile dans les configurations particulières
+ comme l'hébergement virtuel mandaté en masse à base de nom, où
+ l'en-tête Host d'origine doit être évalué par le serveur
+ d'arrière-plan.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ProxyRequests</name>
-<description>Active la fonctionnalité (standard) de mandataire
+<description>Active la fonctionnalité (standard) de mandataire
direct</description>
<syntax>ProxyRequests On|Off</syntax>
<default>ProxyRequests Off</default>
@@ -615,29 +615,29 @@ direct</description>
</contextlist>
<usage>
- <p>Cette directive permet d'activer/désactiver la fonctionnalité de
- serveur mandataire direct d'Apache. Définir ProxyRequests à
+ <p>Cette directive permet d'activer/désactiver la fonctionnalité de
+ serveur mandataire direct d'Apache. Définir ProxyRequests Ã
<code>Off</code> n'interdit pas l'utilisation de la directive
<directive module="mod_proxy">ProxyPass</directive>.</p>
<p>Pour une configuration typique de mandataire inverse ou
- passerelle, cette directive doit être définie à
+ passerelle, cette directive doit être définie Ã
<code>Off</code>.</p>
- <p>Afin d'activer la fonctionnalité de mandataire pour des sites
+ <p>Afin d'activer la fonctionnalité de mandataire pour des sites
HTTP et/ou FTP, les modules <module>mod_proxy_http</module> et/ou
- <module>mod_proxy_ftp</module> doivent aussi être chargés dans le
+ <module>mod_proxy_ftp</module> doivent aussi être chargés dans le
serveur.</p>
- <p><module>mod_proxy_connect</module> doit être activé pour pouvoir
+ <p><module>mod_proxy_connect</module> doit être activé pour pouvoir
mandater (en direct) des sites HTTPS.</p>
<note type="warning"><title>Avertissement</title>
- <p>N'activez pas la fonctionnalité de mandataire avec la directive
+ <p>N'activez pas la fonctionnalité de mandataire avec la directive
<directive module="mod_proxy">ProxyRequests</directive> avant
- d'avoir <a href="#access">sécurisé votre serveur</a>. Les serveurs
+ d'avoir <a href="#access">sécurisé votre serveur</a>. Les serveurs
mandataires ouverts sont dangereux non seulement pour votre
- réseau, mais aussi pour l'Internet au sens large.</p>
+ réseau, mais aussi pour l'Internet au sens large.</p>
</note>
</usage>
<seealso><a href="#forwardreverse">Mandataires/Passerelles directs et
@@ -646,19 +646,19 @@ inverses</a></seealso>
<directivesynopsis>
<name>ProxyRemote</name>
-<description>Mandataire distant à utiliser pour traiter certaines
-requêtes</description>
+<description>Mandataire distant à utiliser pour traiter certaines
+requêtes</description>
<syntax>ProxyRemote <var>comparaison</var> <var>serveur-distant</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
- <p>Cette directive permet de définir des mandataires distants pour
+ <p>Cette directive permet de définir des mandataires distants pour
ce mandataire. <var>comparaison</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
+ 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
correspondant au serveur distant. Syntaxe : </p>
<example>
@@ -666,11 +666,11 @@ requêtes</description>
<var>protocole</var>://<var>nom-serveur</var>[:<var>port</var>]
</example>
- <p><var>protocole</var> est effectivement le protocole à utiliser
+ <p><var>protocole</var> est effectivement le protocole à utiliser
pour communiquer avec le serveur distant ; ce module ne supporte que
<code>http</code> et <code>https</code>. Avec <code>https</code>,
- les requêtes sont transmises par le mandataire distant via la
- méthode HTTP CONNECT.</p>
+ les requêtes sont transmises par le mandataire distant via la
+ méthode HTTP CONNECT.</p>
<example><title>Exemple</title>
ProxyRemote http://bons-gars.example.com/ http://gars-mirroirs.example.com:8000<br />
@@ -678,77 +678,77 @@ requêtes</description>
ProxyRemote ftp http://mandataire-ftp.mon-domaine:8080
</example>
- <p>Dans la dernière ligne de l'exemple, le mandataire va faire
- suivre les requêtes FTP, encapsulées dans une autre requête mandatée
+ <p>Dans la dernière ligne de l'exemple, le mandataire va faire
+ suivre les requêtes FTP, encapsulées dans une autre requête mandatée
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
- l'espace d'URL d'un serveur virtuel, même si ce serveur est caché
+ 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>
</directivesynopsis>
<directivesynopsis>
<name>ProxyRemoteMatch</name>
-<description>Le mandataire distant à utiliser pour traiter les requêtes
-correspondant à une expression rationnelle</description>
+<description>Le mandataire distant à utiliser pour traiter les requêtes
+correspondant à une expression rationnelle</description>
<syntax>ProxyRemoteMatch <var>regex</var> <var>serveur-distant</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>La directive <directive>ProxyRemoteMatch</directive> est
- identique à la directive <directive
- module="mod_proxy">ProxyRemote</directive>, à l'exception que le
+ identique à la directive <directive
+ module="mod_proxy">ProxyRemote</directive>, Ã l'exception que le
premier argument est une <glossary ref="regex">expression
- rationnelle</glossary> à mettre en correspondance avec l'URL de la
- requête.</p>
+ rationnelle</glossary> Ã mettre en correspondance avec l'URL de la
+ requête.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>BalancerMember</name>
-<description>Ajoute un membre à un groupe de répartition de
+<description>Ajoute un membre à un groupe de répartition de
charge</description>
<syntax>BalancerMember [<var>balancerurl</var>] <var>url</var> [<var
- >clé=valeur [clé=valeur ...]]</var></syntax>
+ >clé=valeur [clé=valeur ...]]</var></syntax>
<contextlist><context>directory</context>
</contextlist>
<compatibility>Disponible depuis la version 2.2 d'Apache.</compatibility>
<usage>
- <p>Cette directive parmet d'ajouter un membre à un groupe de
- répartition de charge. Elle peut se trouver dans un conteneur
+ <p>Cette directive parmet d'ajouter un membre à un groupe de
+ répartition de charge. Elle peut se trouver dans un conteneur
<code><Proxy <var>balancer://</var>...></code>, et accepte
- tous les paramètres de paires clé/valeur que supporte la directive
+ tous les paramètres de paires clé/valeur que supporte la directive
<directive module="mod_proxy">ProxyPass</directive>.</p>
<p>L'argument balancerurl n'est requis que s'il ne se trouve pas
- dèjà dans la directive de conteneur <code><Proxy
- <var>balancer://</var>...></code>. Il correspond à l'URL d'un
- répartiteur de charge défini par une directive <directive
+ dèjà dans la directive de conteneur <code><Proxy
+ <var>balancer://</var>...></code>. Il correspond à l'URL d'un
+ répartiteur de charge défini par une directive <directive
module="mod_proxy">ProxyPass</directive>.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ProxySet</name>
-<description>Définit différents paramètres relatifs à la répartition de
-charge des mandataires et aux membres des groupes de répartition de
+<description>Définit différents paramètres relatifs à la répartition de
+charge des mandataires et aux membres des groupes de répartition de
charge</description>
-<syntax>ProxySet <var>url</var> <var>clé=valeur [clé=valeur ...]</var></syntax>
+<syntax>ProxySet <var>url</var> <var>clé=valeur [clé=valeur ...]</var></syntax>
<contextlist><context>directory</context>
</contextlist>
<compatibility>ProxySet n'est disponible que depuis la version 2.2
d'Apache.</compatibility>
<usage>
- <p>Cette directive propose une méthode alternative pour définir tout
- paramètre relatif aux répartiteurs de charge et serveurs cibles de
- mandataires normalement défini via la directive <directive
+ <p>Cette directive propose une méthode alternative pour définir tout
+ paramètre relatif aux répartiteurs de charge et serveurs cibles de
+ mandataires normalement défini via la directive <directive
module="mod_proxy">ProxyPass</directive>. Si elle se trouve dans un
- conteneur <code><Proxy <var>url de répartiteur|url de
+ conteneur <code><Proxy <var>url de répartiteur|url de
serveur cible</var>></code>, l'argument <var>url</var> n'est pas
- nécessaire. Comme effet de bord, le répartiteur ou serveur cible respectif
- est créé. Ceci peut s'avérer utile pour la mise en oeuvre d'un
+ nécessaire. Comme effet de bord, le répartiteur ou serveur cible respectif
+ est créé. Ceci peut s'avérer utile pour la mise en oeuvre d'un
mandataire inverse via une directive <directive
module="mod_rewrite">RewriteRule</directive> au lieu de <directive
module="mod_proxy">ProxyPass</directive>.</p>
@@ -780,10 +780,10 @@ d'Apache.</compatibility>
</example>
<note type="warning"><title>Avertissement</title>
- <p>Gardez à l'esprit qu'une même clé de paramètre peut avoir
- différentes significations selon qu'elle s'applique à un
- répartiteur ou à un serveur cible, et ceci est illustré par les deux
- exemples précédents où il est question d'un timeout.</p>
+ <p>Gardez à l'esprit qu'une même clé de paramètre peut avoir
+ différentes significations selon qu'elle s'applique à un
+ répartiteur ou à un serveur cible, et ceci est illustré par les deux
+ exemples précédents où il est question d'un timeout.</p>
</note>
</usage>
@@ -791,26 +791,26 @@ d'Apache.</compatibility>
<directivesynopsis>
<name>ProxyPass</name>
-<description>Référencer des serveurs distants depuis
+<description>Référencer des serveurs distants depuis
l'espace d'URLs du serveur local</description>
-<syntax>ProxyPass [<var>chemin</var>] !|<var>url</var> [<var>clé=valeur</var>
- <var>[clé=valeur</var> ...]] [nocanon] [interpolate]</syntax>
+<syntax>ProxyPass [<var>chemin</var>] !|<var>url</var> [<var>clé=valeur</var>
+ <var>[clé=valeur</var> ...]] [nocanon] [interpolate]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context>
</contextlist>
<usage>
- <p>Cette directive permet référencer des serveurs distants depuis
+ <p>Cette directive permet référencer des serveurs distants depuis
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é <dfn>mandataire inverse</dfn> ou
+ plutôt comme miroir du serveur distant. Le serveur local est
+ souvent nommé <dfn>mandataire inverse</dfn> ou
<dfn>passerelle</dfn>. L'argument <var>chemin</var> est le nom d'un
chemin virtuel local ; <var>url</var> est une URL partielle pour le
- serveur distant et ne doit pas contenir de chaîne d'arguments.</p>
+ serveur distant et ne doit pas contenir de chaîne d'arguments.</p>
- <note type="warning">En général, la directive <directive
- module="mod_proxy">ProxyRequests</directive> doit être définie à
+ <note type="warning">En général, la directive <directive
+ module="mod_proxy">ProxyRequests</directive> doit être définie Ã
<strong>off</strong> lorsqu'on utilise la directive
<directive>ProxyPass</directive>.</note>
@@ -821,42 +821,42 @@ l'espace d'URLs du serveur local</descri
ProxyPass /miroir/foo/ http://backend.example.com/
</example>
- <p>va convertir en interne toute requête pour
- <code>http://example.com/miroir/foo/bar</code> en une requête
- mandatée pour <code>http://backend.example.com/bar</code>.</p>
+ <p>va convertir en interne toute requête pour
+ <code>http://example.com/miroir/foo/bar</code> en une requête
+ mandatée pour <code>http://backend.example.com/bar</code>.</p>
<note type="warning">
<p>Si le premier argument se termine par un slash
- <strong>/</strong>, il doit en être de même pour le second argument
+ <strong>/</strong>, il doit en être de même pour le second argument
et vice versa. Dans le cas contraire, il risque de manquer des
- slashes nécessaires dans la requête résultante vers le serveur
- d'arrière-plan et les résulats ne seront pas ceux attendus.
+ slashes nécessaires dans la requête résultante vers le serveur
+ d'arrière-plan et les résulats ne seront pas ceux attendus.
</p>
</note>
- <p>Lorsque cette directive est utilisée dans une section <directive
+ <p>Lorsque cette directive est utilisé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
+ 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ême à l'intérieur
+ module="core">Location</directive>. Il en est de même à l'intérieur
d'une section <directive type="section"
- module="core">LocationMatch</directive>, 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
+ module="core">LocationMatch</directive>, 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 <directive type="section"
- module="core">Location</directive> séparée.</p>
+ module="core">Location</directive> séparée.</p>
- <p>La directive ProxyPass ne peut pas être placée dans une section
+ <p>La directive ProxyPass ne peut pas être placé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 à la documentaion de la directive <directive
+ souple, reportez-vous à la documentaion de la directive <directive
module="mod_rewrite">RewriteRule</directive> et son drapeau
<code>[P]</code>.</p>
- <p>Le drapeau <code>!</code> permet de soustraire un sous-répertoire
+ <p>Le drapeau <code>!</code> permet de soustraire un sous-répertoire
du mandat inverse, comme dans l'exemple suivant :</p>
<example>
@@ -864,58 +864,64 @@ l'espace d'URLs du serveur local</descri
ProxyPass /miroir/foo http://backend.example.com
</example>
- <p>va mandater toutes les requêtes pour <code>/miroir/foo</code>
- vers <code>backend.example.com</code>, <em>sauf</em> les requêtes
+ <p>va mandater toutes les requêtes pour <code>/miroir/foo</code>
+ vers <code>backend.example.com</code>, <em>sauf</em> les requêtes
pour <code>/miroir/foo/i</code>.</p>
<note type="warning"><title>Ordre de classement des directives
ProxyPass</title>
<p>Les directives <directive
module="mod_proxy">ProxyPass</directive> et <directive
- module="mod_proxy">ProxyPassMatch</directive> sont traitées selon
+ module="mod_proxy">ProxyPassMatch</directive> sont traitées selon
leur ordre d'apparition dans le fichier de configuration. La
- première qui correspond s'applique. Ainsi, vous devez classer les
+ première qui correspond s'applique. Ainsi, vous devez classer les
directives <directive module="mod_proxy">ProxyPass</directive> qui
- peuvent entrer en conflit, de l'URL la plus longue à la plus
+ peuvent entrer en conflit, de l'URL la plus longue à la plus
courte. Dans le cas contraire, les directives dont l'URL
- constitue une partie du début de l'URL de directives
+ constitue une partie du début de l'URL de directives
apparaissant plus loin dans la configuration vont occulter ces
- dernières. Notez que tout ceci est en relation avec le partage de
+ dernières. Notez que tout ceci est en relation avec le partage de
worker.</p>
- <p>Pour les mêmes raisons, les exclusions doivent apparaître
+ <p>Pour les mêmes raisons, les exclusions doivent apparaître
<em>avant</em> les directives <directive>ProxyPass</directive>
- générales.</p>
+ générales.</p>
</note> <!-- /ordering_proxypass -->
- <p><strong>ProxyPass <code>clé=valeur</code> Paramètres</strong></p>
+ <note type="warning"><title>Ordre d'évaluation des directives ProxyPass et RewriteRule</title>
+ <p>Les directives <directive module="mod_rewrite">RewriteRule</directive>
+ sont évaluées avant les directives <directive
+ module="mod_proxy">ProxyPass</directive>.</p>
++ </note>
+
+ <p><strong>ProxyPass <code>clé=valeur</code> Paramètres</strong></p>
<p>Depuis la version 2.1 du serveur HTTP Apache, mod_proxy supporte
- les jeux de connexions vers un serveur d'arrière-plan. Ainsi, les
- connexions créées à la demande peuvent être conservées dans un
- jeu pour une utilisation ultérieure. Les limites de la taille
- du jeu de connexions et d'autres paramètres peuvent être définis au
+ les jeux de connexions vers un serveur d'arrière-plan. Ainsi, les
+ connexions créées à la demande peuvent être conservées dans un
+ jeu pour une utilisation ultérieure. Les limites de la taille
+ du jeu de connexions et d'autres paramètres peuvent être définis au
niveau de la directive <directive>ProxyPass</directive> via des
- arguments <code>clé=valeur</code> décrits dans les
+ arguments <code>clé=valeur</code> décrits dans les
tables ci-dessous.</p>
- <p>Par défaut, mod_proxy permettra de conserver le nombre maximum de
- connexions pouvant être utilisées simultanément par le processus
- enfant concerné du serveur web. Vous pouvez utiliser le paramètre
- <code>max</code> pour réduire ce nombre par rapport à la valeur par
- défaut. Vous pouvez aussi utiliser le paramètre <code>ttl</code>
- pour définir une durée de vie optionnelle ; ainsi, les connections
- qui n'ont pas été utilisées au bout de <code>ttl</code> secondes
- seront fermées. Le paramètre <code>ttl</code> permet aussi
- d'empêcher l'utilisation d'une connexion susceptible d'être fermée
- suite à l'expiration de la durée de vie des connexions persistantes
- sur le serveur d'arrière-plan.</p>
+ <p>Par défaut, mod_proxy permettra de conserver le nombre maximum de
+ connexions pouvant être utilisées simultanément par le processus
+ enfant concerné du serveur web. Vous pouvez utiliser le paramètre
+ <code>max</code> pour réduire ce nombre par rapport à la valeur par
+ défaut. Vous pouvez aussi utiliser le paramètre <code>ttl</code>
+ pour définir une durée de vie optionnelle ; ainsi, les connections
+ qui n'ont pas été utilisées au bout de <code>ttl</code> secondes
+ seront fermées. Le paramètre <code>ttl</code> permet aussi
+ d'empêcher l'utilisation d'une connexion susceptible d'être fermée
+ suite à l'expiration de la durée de vie des connexions persistantes
+ sur le serveur d'arrière-plan.</p>
<p>Le jeu de connexions est maintenu au niveau de chaque processus
- enfant du serveur web, et <code>max</code> et les autres paramètres
- ne font l'objet d'aucune coordination entre les différents processus
- enfants, sauf bien sur dans le cas où un seul processus enfant est
+ enfant du serveur web, et <code>max</code> et les autres paramètres
+ ne font l'objet d'aucune coordination entre les différents processus
+ enfants, sauf bien sur dans le cas où un seul processus enfant est
permis par la configuration du module multiprocessus.</p>
<example>
@@ -923,277 +929,277 @@ l'espace d'URLs du serveur local</descri
</example>
<table>
- <tr><th>Paramètre</th>
- <th>Défaut</th>
+ <tr><th>Paramètre</th>
+ <th>Défaut</th>
<th>Description</th></tr>
<tr><td>min</td>
<td>0</td>
- <td>Nombre minimum d'entrées dans le jeu de connexions, sans
- rapport avec le nombre réel de connexions. Ne doit être modifié
- par rapport à la valeur par défaut que dans des circonstances
- spéciales où la mémoire du tas associée aux connexions
- d'arrière-plan doit être préallouée ou conservée.</td></tr>
+ <td>Nombre minimum d'entrées dans le jeu de connexions, sans
+ rapport avec le nombre réel de connexions. Ne doit être modifié
+ par rapport à la valeur par défaut que dans des circonstances
+ spéciales où la mémoire du tas associée aux connexions
+ d'arrière-plan doit être préallouée ou conservée.</td></tr>
<tr><td>max</td>
<td>1...n</td>
<td>Nombre maximum de connexions permises vers le serveur
- d'arrière-plan. La valeur par défaut pour cette limite est le
+ d'arrière-plan. La valeur par défaut pour cette limite est le
nombre de threads par processus pour le module multiprocessus
actif. Pour le MPM Prefork, la valeur est toujours 1, alors que
- pour les autres, on peut la contrôler via la directive
+ pour les autres, on peut la contrôler via la directive
<directive>ThreadsPerChild</directive>.</td></tr>
<tr><td>smax</td>
<td>max</td>
- <td>Les entrées conservées du jeu de connexions au dessus de
- cette limite sont libérées au cours de certaines opérations si
- elles n'ont pas été utilisées au bout de leur durée de vie
- définie par le paramètre <code>ttl</code>. Si l'entrée du jeu de
- connexions est associée à une connexion, cette dernière sera
- alors fermée. Ce paramètre ne doit être modifié par rapport à la
- valeur par défaut que dans des circonstances spéciales où les
- entrées du jeu de connexions, et toutes connexions associées qui
- ont dépassé leur durée de vie doivent être respectivement
- libérées ou fermées plus impérativement.</td></tr>
+ <td>Les entrées conservées du jeu de connexions au dessus de
+ cette limite sont libérées au cours de certaines opérations si
+ elles n'ont pas été utilisées au bout de leur durée de vie
+ définie par le paramètre <code>ttl</code>. Si l'entrée du jeu de
+ connexions est associée à une connexion, cette dernière sera
+ alors fermée. Ce paramètre ne doit être modifié par rapport à la
+ valeur par défaut que dans des circonstances spéciales où les
+ entrées du jeu de connexions, et toutes connexions associées qui
+ ont dépassé leur durée de vie doivent être respectivement
+ libérées ou fermées plus impérativement.</td></tr>
<tr><td>acquire</td>
<td>-</td>
- <td>Cette clé permet de définir le délai maximum d'attente pour
+ <td>Cette clé permet de définir le délai maximum d'attente pour
une connexion libre dans le jeu de connexions, en millisecondes.
S'il n'y a pas de connexion libre dans le jeu, Apache renverra
- l'état <code>SERVER_BUSY</code> au client.
+ l'état <code>SERVER_BUSY</code> au client.
</td></tr>
<tr><td>connectiontimeout</td>
<td>timeout</td>
- <td>Délai d'attente d'une connexion en secondes.
- La durée en secondes pendant laquelle Apache va attendre pour
- l'établissement d'une connexion vers le serveur d'arrière-plan.
- Le délai peut être spécifié en millisecondes en ajoutant le
+ <td>Délai d'attente d'une connexion en secondes.
+ La durée en secondes pendant laquelle Apache va attendre pour
+ l'établissement d'une connexion vers le serveur d'arrière-plan.
+ Le délai peut être spécifié en millisecondes en ajoutant le
suffixe ms.
</td></tr>
<tr><td>disablereuse</td>
<td>Off</td>
- <td>Vous pouvez utiliser cette clé pour forcer mod_proxy à
- fermer immédiatement une connexion vers le serveur
- d'arrière-plan après utilisation, et ainsi désactiver le jeu de
- connexions permanentes vers ce serveur. Ceci peut s'avérer utile
- dans des situations où un pare-feu situé entre Apache et le
- serveur d'arrière-plan (quelque soit le protocole) interrompt
- des connexions de manière silencieuse, ou lorsque le serveur
- d'arrière-plan lui-même est accessible par rotation de DNS
- (round-robin DNS). Pour désactiver la réutilisation du jeu de
- connexions, définissez cette clé à <code>On</code>.
+ <td>Vous pouvez utiliser cette clé pour forcer mod_proxy Ã
+ fermer immédiatement une connexion vers le serveur
+ d'arrière-plan après utilisation, et ainsi désactiver le jeu de
+ connexions permanentes vers ce serveur. Ceci peut s'avérer utile
+ dans des situations où un pare-feu situé entre Apache et le
+ serveur d'arrière-plan (quelque soit le protocole) interrompt
+ des connexions de manière silencieuse, ou lorsque le serveur
+ d'arrière-plan lui-même est accessible par rotation de DNS
+ (round-robin DNS). Pour désactiver la réutilisation du jeu de
+ connexions, définissez cette clé à <code>On</code>.
</td></tr>
<tr><td>flushpackets</td>
<td>off</td>
- <td>Permet de dé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
- 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.
+ <td>Permet de dé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
+ 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.
</td></tr>
<tr><td>flushwait</td>
<td>10</td>
- <td>Le délai d'attente pour une entrée additionnelle, en
+ <td>Le délai d'attente pour une entrée additionnelle, en
millisecondes, avant le vidage du tampon en sortie dans le cas
- où 'flushpackets' est à 'auto'.
+ où 'flushpackets' est à 'auto'.
</td></tr>
<tr><td>keepalive</td>
<td>Off</td>
- <td><p>Cette clé doit être utilisée lorsque vous avez un pare-feu
- entre Apache httpd et le serveur d'arrière-plan, et si ce dernier tend
- à interrompre les connexions inactives. Cette clé va faire en
- sorte que le système d'exploitation envoie des messages
+ <td><p>Cette clé doit être utilisée lorsque vous avez un pare-feu
+ entre Apache httpd et le serveur d'arrière-plan, et si ce dernier tend
+ à interrompre les connexions inactives. Cette clé va faire en
+ sorte que le système d'exploitation envoie des messages
<code>KEEP_ALIVE</code> sur chacune des connexions inactives et
- ainsi éviter la fermeture de la connexion par le pare-feu.
+ ainsi éviter la fermeture de la connexion par le pare-feu.
Pour conserver les connexions persistantes, definissez cette
- propriété à <code>On</code>.</p>
- <p>La fréquence de vérification des connexions TCP persistantes
- initiale et subséquentes dépend de la configuration globale de l'OS,
- et peut atteindre 2 heures. Pour être utile, la fréquence configurée
- dans l'OS doit être inférieure au seuil utilisé par le pare-feu.</p>
+ propriété à <code>On</code>.</p>
+ <p>La fréquence de vérification des connexions TCP persistantes
+ initiale et subséquentes dépend de la configuration globale de l'OS,
+ et peut atteindre 2 heures. Pour être utile, la fréquence configurée
+ dans l'OS doit être inférieure au seuil utilisé par le pare-feu.</p>
</td></tr>
<tr><td>lbset</td>
<td>0</td>
- <td>Définit le groupe de répartition de charge dont le serveur cible
- est membre. Le répartiteur de charge va essayer tous les membres
- d'un groupe de répartition de charge de numéro inférieur avant
- d'essayer ceux dont le groupe possède un numéro supérieur.
+ <td>Définit le groupe de répartition de charge dont le serveur cible
+ est membre. Le répartiteur de charge va essayer tous les membres
+ d'un groupe de répartition de charge de numéro inférieur avant
+ d'essayer ceux dont le groupe possède un numéro supérieur.
</td></tr>
<tr><td>ping</td>
<td>0</td>
- <td>Avec la clé ping, le serveur web envoie une requête
+ <td>Avec la clé ping, le serveur web envoie une requête
<code>CPING</code> sur la connexion ajp13 avant de rediriger une
- requête. La valeur correspond au délai d'attente de la réponse
- <code>CPONG</code>. Cette fonctionnalité a été ajoutée afin de
- pallier aux problèmes de blocage et de surcharge des serveurs
- Tomcat, et nécessite le support de ping/pong ajp13 qui a été
- implémenté dans Tomcat 3.3.2+, 4.1.28+ et 5.0.13+. Le trafic
- réseau peut s'en trouver augmenté en fonctionnement normal, ce
- qui peut poser problème, mais peut s'en trouver diminué dans les
- cas où les noeuds de cluster sont arrêtés ou surchargés. Cette
- clé n'est actuellement utilisable qu'avec AJP. Le délai peut
- aussi être défini en millisecondes en ajoutant le suffixe
+ requête. La valeur correspond au délai d'attente de la réponse
+ <code>CPONG</code>. Cette fonctionnalité a été ajoutée afin de
+ pallier aux problèmes de blocage et de surcharge des serveurs
+ Tomcat, et nécessite le support de ping/pong ajp13 qui a été
+ implémenté dans Tomcat 3.3.2+, 4.1.28+ et 5.0.13+. Le trafic
+ réseau peut s'en trouver augmenté en fonctionnement normal, ce
+ qui peut poser problème, mais peut s'en trouver diminué dans les
+ cas où les noeuds de cluster sont arrêtés ou surchargés. Cette
+ clé n'est actuellement utilisable qu'avec AJP. Le délai peut
+ aussi être défini en millisecondes en ajoutant le suffixe
ms.
</td></tr>
<tr><td>loadfactor</td>
<td>1</td>
- <td>Facteur de charge du serveur cible à utiliser avec les
- membres d'un groupe de répartition de charge. Il s'agit d'un
- nombre entre 1 et 100 définissant le facteur de charge appliqué
+ <td>Facteur de charge du serveur cible à utiliser avec les
+ membres d'un groupe de répartition de charge. Il s'agit d'un
+ nombre entre 1 et 100 définissant le facteur de charge appliqué
au serveur cible.
</td></tr>
<tr><td>redirect</td>
<td>-</td>
<td>Route pour la redirection du serveur cible. Cette valeur est en
- général définie dynamiquement pour permettre une suppression
- sécurisée du noeud du cluster. Si cette clé est définie, toutes
- les requêtes sans identifiant de session seront redirigées vers
- le membre de groupe de répartition de charge dont la route
- correspond à la valeur de la clé.
+ général définie dynamiquement pour permettre une suppression
+ sécurisée du noeud du cluster. Si cette clé est définie, toutes
+ les requêtes sans identifiant de session seront redirigées vers
+ le membre de groupe de répartition de charge dont la route
+ correspond à la valeur de la clé.
</td></tr>
<tr><td>retry</td>
<td>60</td>
- <td>Délai entre deux essais du serveur cible du jeu de connexions en
+ <td>Délai entre deux essais du serveur cible du jeu de connexions en
secondes. Si le serveur cible du jeu de connexions vers le serveur
- d'arrière-plan est dans un état d'erreur, Apache ne redirigera
- pas de requête vers ce serveur avant l'expiration du délai
- spécifié. Ceci permet d'arrêter le serveur d'arrière-plan pour
+ d'arrière-plan est dans un état d'erreur, Apache ne redirigera
+ pas de requête vers ce serveur avant l'expiration du délai
+ spécifié. Ceci permet d'arrêter le serveur d'arrière-plan pour
maintenance, et de le remettre en ligne plus tard. Une valeur de
- 0 signifie toujours essayer les serveurs cibles dans un état d'erreur
- sans délai.
+ 0 signifie toujours essayer les serveurs cibles dans un état d'erreur
+ sans délai.
</td></tr>
<tr><td>route</td>
<td>-</td>
- <td>La route du serveur cible lorsqu'il est utilisé au sein d'un
- répartiteur de charge. La route est une valeur ajoutée à
+ <td>La route du serveur cible lorsqu'il est utilisé au sein d'un
+ répartiteur de charge. La route est une valeur ajoutée Ã
l'identifiant de session.
</td></tr>
<tr><td>status</td>
<td>-</td>
- <td>Valeur constituée d'une simple lettre et définissant l'état
- initial de ce serveur cible : 'D' correspond à "désactivé", 'S' à
- "arrêté", 'I' à "erreurs ignorées", 'H' à "interruption à chaud"
- et 'E' à "erreur". Une valeur d'état peut être définie (ce qui
- correspond au comportement par défaut) en préfixant la valeur
- par '+', ou annulée en préfixant la valeur par '-'. Ainsi, la
- valeur 'S-E' définit l'état de ce serveur cible à "arrêté" et supprime
+ <td>Valeur constituée d'une simple lettre et définissant l'état
+ initial de ce serveur cible : 'D' correspond à "désactivé", 'S' Ã
+ "arrêté", 'I' à "erreurs ignorées", 'H' à "interruption à chaud"
+ et 'E' à "erreur". Une valeur d'état peut être définie (ce qui
+ correspond au comportement par défaut) en préfixant la valeur
+ par '+', ou annulée en préfixant la valeur par '-'. Ainsi, la
+ valeur 'S-E' définit l'état de ce serveur cible à "arrêté" et supprime
le drapeau "en-erreur".
</td></tr>
<tr><td>timeout</td>
<td><directive module="mod_proxy">ProxyTimeout</directive></td>
- <td>Délai d'attente de la connexion en secondes. Le nombre de
+ <td>Délai d'attente de la connexion en secondes. Le nombre de
secondes pendant lesquelles Apache attend l'envoi de
- données vers le serveur d'arrière-plan.
+ données vers le serveur d'arrière-plan.
</td></tr>
<tr><td>ttl</td>
<td>-</td>
- <td>Durée de vie des connexions inactives et des entrées
- associées du jeu de connexions. Lorsque cette limite est
- atteinte, la connexion concernée ne sera plus utilisée ; elle
- sera ensuite fermée au bout d'un certain temps.
+ <td>Durée de vie des connexions inactives et des entrées
+ associées du jeu de connexions. Lorsque cette limite est
+ atteinte, la connexion concernée ne sera plus utilisée ; elle
+ sera ensuite fermée au bout d'un certain temps.
</td></tr>
</table>
- <p>Si l'URL de la directive <directive>ProxyPass</directive> débute par
+ <p>Si l'URL de la directive <directive>ProxyPass</directive> débute par
<code>balancer://</code> (par exemple:
<code>balancer://cluster/</code>, toute information relative au
- chemin est ignorée), alors un serveur cible virtuel ne communiquant pas
- réellement avec le serveur d'arrière-plan sera créé. Celui-ci sera
- en fait responsable de la gestion de plusieurs serveurs cibles "réels". Dans
- ce cas, un jeu de paramètres particuliers s'applique à ce serveur cible
+ chemin est ignorée), alors un serveur cible virtuel ne communiquant pas
+ réellement avec le serveur d'arrière-plan sera créé. Celui-ci sera
+ en fait responsable de la gestion de plusieurs serveurs cibles "réels". Dans
+ ce cas, un jeu de paramètres particuliers s'applique à ce serveur cible
virtuel. Voir <module>mod_proxy_balancer</module> pour plus
- d'informations à propos du fonctionnement du répartiteur de
+ d'informations à propos du fonctionnement du répartiteur de
charge.
</p>
<table>
- <tr><th>Paramètre</th>
- <th>Défaut</th>
+ <tr><th>Paramètre</th>
+ <th>Défaut</th>
<th>Description</th></tr>
<tr><td>lbmethod</td>
<td>byrequests</td>
- <td>Méthode de répartition de charge utilisée. Permet de
- sélectionner la méthode de planification de la répartition de
- charge à utiliser. La valeur est soit <code>byrequests</code>,
- pour effectuer un décompte de requêtes pondérées, soit
- <code>bytraffic</code>, pour effectuer une répartition en
- fonction du décompte des octets transmis, soit
- <code>bybusyness</code> (à partir de la version 2.2.10 du
- serveur HTTP Apache), pour effectuer une répartition en
- fonction des requêtes en attente. La valeur par défaut est
+ <td>Méthode de répartition de charge utilisée. Permet de
+ sélectionner la méthode de planification de la répartition de
+ charge à utiliser. La valeur est soit <code>byrequests</code>,
+ pour effectuer un décompte de requêtes pondérées, soit
+ <code>bytraffic</code>, pour effectuer une répartition en
+ fonction du décompte des octets transmis, soit
+ <code>bybusyness</code> (Ã partir de la version 2.2.10 du
+ serveur HTTP Apache), pour effectuer une répartition en
+ fonction des requêtes en attente. La valeur par défaut est
<code>byrequests</code>.
</td></tr>
<tr><td>maxattempts</td>
<td>1 de moins que le nombre de workers, ou 1 avec un seul
worker</td>
- <td>Nombre maximum d'échecs avant abandon.
+ <td>Nombre maximum d'échecs avant abandon.
</td></tr>
<tr><td>nofailover</td>
<td>Off</td>
- <td>Si ce paramètre est défini à <code>On</code>, la session va
- s'interrompre si le serveur cible est dans un état d'erreur ou
- désactivé. Définissez ce paramètre à On si le serveur
- d'arrière-plan ne supporte pas la réplication de session.
+ <td>Si ce paramètre est défini à <code>On</code>, la session va
+ s'interrompre si le serveur cible est dans un état d'erreur ou
+ désactivé. Définissez ce paramètre à On si le serveur
+ d'arrière-plan ne supporte pas la réplication de session.
</td></tr>
<tr><td>stickysession</td>
<td>-</td>
- <td>Nom de session persistant du répartiteur. La valeur est
- généralement du style <code>JSESSIONID</code> ou
- <code>PHPSESSIONID</code>, et dépend du serveur d'application
- d'arrière-plan qui supporte les sessions. Si le serveur
- d'application d'arrière-plan utilise des noms différents pour
- les cookies et les identifiants codés d'URL (comme les
- conteneurs de servlet), séparez-les par le caractère '|'. La
- première partie contient le cookie et la seconde le chemin.
+ <td>Nom de session persistant du répartiteur. La valeur est
+ généralement du style <code>JSESSIONID</code> ou
+ <code>PHPSESSIONID</code>, et dépend du serveur d'application
+ d'arrière-plan qui supporte les sessions. Si le serveur
+ d'application d'arrière-plan utilise des noms différents pour
+ les cookies et les identifiants codés d'URL (comme les
+ conteneurs de servlet), séparez-les par le caractère '|'. La
+ première partie contient le cookie et la seconde le chemin.
</td></tr>
<tr><td>scolonpathdelim</td>
<td>Off</td>
- <td>Si ce paramètre est défini à <code>On</code>, le caractère
- ';' sera utilisé comme séparateur de chemin de session
+ <td>Si ce paramètre est défini à <code>On</code>, le caractère
+ ';' sera utilisé comme séparateur de chemin de session
persistante additionnel. Ceci permet principalement de simuler
le comportement de mod_jk lorsqu'on utilise des chemins du style
<code>JSESSIONID=6736bcf34;foo=aabfa</code>.
</td></tr>
<tr><td>timeout</td>
<td>0</td>
[... 984 lines stripped ...]