]> granicus.if.org Git - apache/commitdiff
XML updates.
authorLucien Gentis <lgentis@apache.org>
Tue, 1 Aug 2017 15:40:48 +0000 (15:40 +0000)
committerLucien Gentis <lgentis@apache.org>
Tue, 1 Aug 2017 15:40:48 +0000 (15:40 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1803659 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/mod/mod_proxy.xml.fr
docs/manual/mod/mod_proxy_balancer.xml.fr
docs/manual/mod/mod_proxy_express.xml.fr
docs/manual/mod/mod_proxy_fcgi.xml.fr
docs/manual/rewrite/flags.xml.fr

index d1285db66f3a1fd3893aa88e14ce777607fc950e..3b399ff91934c80aa535f7b23d893537b42f805b 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1797650:1803258 (outdated) -->
+<!-- English Revision: 1803258 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -219,8 +219,7 @@ ProxyVia On
 
       <p>Les deux workers par défaut possèdent une configuration figée
       et seront utilisés si aucun autre worker ne correspond à la
-      requête. Ils n'utilisent ni les jeux de connexions (connection
-      pooling), ni les
+      requête. Ils ne réutilisent pas les connexions et n'utilisent pas les
       connexions HTTP persistantes (Keep-Alive). En effet, les
       connexions TCP vers le serveur original sont fermées et ouvertes
       pour chaque requête.</p>
@@ -346,16 +345,15 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10
 
       <note><title>Résolution DNS pour les domaines originaux</title>
       <p>La résolution DNS s'effectue lorsque le socket vers le
-      domaine original est créé pour la première fois. Lorsque le pooling de
-      connexions est utilisé, chaque domaine d'arrière-plan n'est résolu qu'une
-      seule fois pour chaque processus enfant, et cette résolution est réutilisée
-      pour toutes les connexions ultérieures jusqu'à ce que le processus enfant
+      domaine original est créé pour la première fois. Lorsque la réutilisation
+      des connexions est activée, chaque domaine d'arrière-plan n'est résolu qu'une
+      seule fois pour chaque processus enfant, et cette résolution est mise en
+      cache pour toutes les connexions ultérieures jusqu'à ce que le processus enfant
       soit recyclé. Ce comportement doit être pris en considération lorsqu'on
       planifie des tâches de maintenance du DNS impactant les domaines
       d'arrière-plan. Veuillez aussi vous reporter aux paramètres de la
       directive <directive module="mod_proxy">ProxyPass</directive> pour plus de
-      détails à propos de la réutilisation des connexions.
-        </p>
+      détails à propos de la réutilisation des connexions.</p>
       </note>
 
     </section> <!-- /workers -->
@@ -988,7 +986,10 @@ sont supportés à partir de la version 2.4.7 du serveur HTTP Apache</compatibil
     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>
 
-    <note><strong>Note : </strong>Cette directive n'est pas supportée au sein
+    <note>Il est fortement recommandé de revoir le concept de <a
+    href="#workers">Worker</a> avant d'aller plus loin.</note>
+
+    <note>Cette directive n'est pas supportée au sein
     des sections <directive type="section" module="core">Directory</directive>
     et <directive type="section" module="core">Files</directive>.</note>
 
@@ -1120,10 +1121,18 @@ ProxyPass "/mirror/foo" "http://backend.example.com"
     <code>clé=valeur</code> dont la description fait l'objet des
     tableaux ci-dessous.</p>
 
-    <p>Par défaut, mod_proxy permet et met en réserve le nombre maximum
-    de connexions pouvant être utilisées simultanément par le processus
-    enfant concerné du serveur web. Le paramètre <code>max</code> permet
-    de réduire cette valeur par défaut. Le paramètre <code>ttl</code>,
+    <note type="warning"><title>Nombre maximum de connexions vers
+    l'arrière-plan</title>
+     <p>Par défaut, mod_proxy permet et met en réserve le
+    nombre maximum de connexions pouvant être utilisées simultanément par le
+    processus enfant concerné du serveur web. Le paramètre <code>max</code>
+    permet de réduire cette valeur par défaut. Le jeu de connexions est maintenu
+    au niveau de chaque processus enfant du serveur web, <code>max</code> et les
+    autres réglages n'étant pas coordonnés entre ces différents processus, sauf
+    bien entendu lorsqu'un seul processus enfant n'est autorisé par la
+    configuration ou le MPM utilisé.</p> </note>
+    
+    <p>Le paramètre <code>ttl</code>,
     quant à lui, permet de définir une durée de vie optionnelle ; les
     connexions qui n'ont pas été utilisées pendant au moins
     <code>ttl</code> secondes seront fermées. <code>ttl</code> permet
@@ -1131,20 +1140,13 @@ ProxyPass "/mirror/foo" "http://backend.example.com"
     fermée suite à une fin de vie de connexion persistante sur le
     serveur d'arrière-plan.</p>
 
-    <p>Le groupement de connexions est maintenu au niveau de chaque
-    processus enfant du serveur web, et <code>max</code>, ainsi que les
-    autres paramètres, ne font
-    l'objet d'aucune coordination entre les différents processus
-    enfants, sauf si un seul processus enfant est autorisé par la
-    configuration ou la conception du module multi-processus (MPM).</p>
-
     <example><title>Exemple</title>
     <highlight language="config">
         ProxyPass "/example" "http://backend.example.com" max=20 ttl=120 retry=300
        </highlight>
     </example>
 
-    <table border="2"><tr><th>Paramètres de BalancerMember</th></tr></table>
+    <table border="2"><tr><th>Paramètres de worker (directive BalancerMember)</th></tr></table>
     <table>
     <tr><th>Paramètre</th>
         <th>Défaut</th>
@@ -1200,7 +1202,11 @@ ProxyPass "/mirror/foo" "http://backend.example.com"
        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
+       (round-robin DNS). Lorsque la réutilisation des connexions est activée,
+       chaque domaine d'arrière-plan n'est résolu (via une requête DNS) qu'une
+       seule fois par chaque processus enfant et mis en cache pour toutes les
+       connexions ultérieures jusqu'au recyclage du processus concerné.      
+       Pour désactiver la réutilisation du jeu de
        connexions, définissez cette clé à <code>On</code>.
     </td></tr>
     <tr><td>enablereuse</td>
index 26ffc0b50e7c051695e7858bf7e5fa7c2358281d..69351b5f25c39c538bea6064ef66e617670afb66 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1731594:1803315 (outdated) -->
+<!-- English Revision: 1803315 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -67,6 +67,10 @@ la répartition de charge</description>
     </note>
 </summary>
 <seealso><module>mod_proxy</module></seealso>
+<seealso><directive module="mod_proxy">BalancerMember</directive></seealso>
+<seealso><directive module="mod_proxy">BalancerGrowth</directive></seealso>
+<seealso><directive module="mod_proxy">BalancerPersist</directive></seealso>
+<seealso><directive module="mod_proxy">BalancerInherit</directive></seealso>
 
 <section id="scheduler">
     <title>L'algorithme de planification de la répartition de
index a22cb5ec6b64d4353918ecb81eec935506d8fcef..0002024f9e55ab24b466a915b204dd3b8dde42a7 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1774024:1803315 (outdated) -->
+<!-- English Revision: 1803315 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -82,6 +82,10 @@ dynamique inverse de masse</description>
 
 </summary>
 <seealso><module>mod_proxy</module></seealso>
+<seealso><directive module="mod_proxy">BalancerMember</directive></seealso>
+<seealso><directive module="mod_proxy">BalancerGrowth</directive></seealso>
+<seealso><directive module="mod_proxy">BalancerPersist</directive></seealso>
+<seealso><directive module="mod_proxy">BalancerInherit</directive></seealso>
 
 <directivesynopsis>
 <name>ProxyExpressEnable</name>
index 92ce8e3eec83812cb38763bcc0fc546c8aa7c632..bb814f2bbf64a27638ea08239103d86ac7ca0c21 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1802337:1803258 (outdated) -->
+<!-- English Revision: 1803258 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -92,7 +92,7 @@
     que chemin du système de fichiers pour l'exécution du démon PHP-FPM.
     L'URL de la requête est implicitement ajoutée au second paramètre.
     PHP-FPM est à l'écoute de l'hôte et du port qui
-    suivent fcgi://. La conservation des connexions est activée.</p>
+    suivent fcgi://. La conservation/réutilisation des connexions est activée.</p>
     <example><title>PHP-FPM</title>
     <highlight language="config">
       ProxyPassMatch "^/myapp/.*\.php(/.*)?$" "fcgi://localhost:9000/var/www/" enablereuse=on
index 93b862966ea5eb1d4fe5bfde4c0dfa9c49b920ba..a870238ae8c92cab9b12e4bfbe079322314b7123 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1796850:1803258 (outdated) -->
+<!-- English Revision: 1803258 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -580,7 +580,7 @@ local.</p>
       persistantes, ce qui signifie que vous obtiendrez des performances meilleurs si vous utilisez
       <directive module="mod_proxy">ProxyPass</directive> ou <directive module="mod_proxy">ProxyPassMatch</directive>.</p>
       <p>Ceci est du au fait que ce drapeau induit l'utilisation du worker par défaut, qui
-      ne gère pas la mise en commun des connexions.</p>
+      ne gère pas la mise en commun et la réutilisation des connexions.</p>
       <p>Partout où cela est possible, préférez l'utilisation de ces directives.</p>
 </note>