From: Lucien Gentis <lgentis@apache.org>
Date: Sat, 10 Feb 2018 16:32:55 +0000 (+0000)
Subject: XML updates.
X-Git-Tag: 2.4.30~84
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2761bbcaab6ea08c439fe0bc4739995f769c4d0a;p=thirdparty%2Fapache%2Fhttpd.git

XML updates.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1823784 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mod_authnz_ldap.xml.fr b/docs/manual/mod/mod_authnz_ldap.xml.fr
index fe683e45fcd..d956b23649f 100644
--- a/docs/manual/mod/mod_authnz_ldap.xml.fr
+++ b/docs/manual/mod/mod_authnz_ldap.xml.fr
@@ -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: 1780218:1823464 (outdated) -->
+<!-- English Revision: 1823464 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -548,7 +548,7 @@ Require ldap-dn cn=Barbara Jenson, o=Example
     donc l'attribut status aurait pour valeur "actif" :</p>
 
     <highlight language="config">
-    Require ldap-attribute city="San Jose" status=active
+    Require ldap-attribute city="San Jose" status="active"
     </highlight>
 
 </section>
diff --git a/docs/manual/mod/mod_log_debug.xml.fr b/docs/manual/mod/mod_log_debug.xml.fr
index c5cfdc60b89..bb3491d7fb4 100644
--- a/docs/manual/mod/mod_log_debug.xml.fr
+++ b/docs/manual/mod/mod_log_debug.xml.fr
@@ -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: 1673563:1823289 (outdated) -->
+<!-- English Revision: 1823289 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -50,7 +50,7 @@
 	dans une sous-requête :
         <highlight language="config">
 &lt;Location "/foo/"&gt;
-&nbsp;&nbsp;LogMessage "subrequest to /foo/" hook=type_checker expr=%{IS_SUBREQ}
+&nbsp;&nbsp;LogMessage "subrequest to /foo/" hook=type_checker "expr=-T %{IS_SUBREQ}"
 &lt;/Location&gt;
         </highlight>
 
diff --git a/docs/manual/mod/mod_proxy_fcgi.xml.fr b/docs/manual/mod/mod_proxy_fcgi.xml.fr
index 84f3af3daeb..125db5698c3 100644
--- a/docs/manual/mod/mod_proxy_fcgi.xml.fr
+++ b/docs/manual/mod/mod_proxy_fcgi.xml.fr
@@ -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: 1803258 -->
+<!-- English Revision: 1823753 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -88,6 +88,34 @@
       </highlight>
     </example>
 
+    <note><title>Active la réutilisation des connexions vers un serveur FCGI
+    d'arrière-plan tel que PHP-FPM</title>
+    <p>Il faut garder à l'esprit que PHP-FPM (en février 2018)
+    utilise un modèle du style prefork ; autrement dit, chacun de ses processus
+    de travail ne peut gérer qu'une connexion à la fois.<br /> 
+    Par défaut et lorsqu'il est configuré avec <code>enablereuse=on</code>,
+    mod_proxy autorise un jeu de <directive
+    module="mpm_common">ThreadsPerChild</directive> connexions vers le serveur
+    d'arrière-plan pour chaque processus httpd, et par conséquent, il faut
+    prêter une attention particulière aux situations suivantes :</p>
+    <ul>
+      <li>Avec une charge en HTTP/1, il est fort probable que le nombre de
+      connexions vers le serveur FCGI d'arrière-plan augmente jusqu'à atteindre
+      <directive module="mpm_common">MaxRequestWorkers</directive>.</li>
+      <li>Avec une charge en HTTP/2, et vue la manière dont
+      <module>mod_http2</module> est implémenté, il y a des threads de travail
+      h2 additionnels qui peuvent forcer la création de connexions
+      supplémentaires vers le serveur d'arrière-plan. Le nombre total de
+      connexions que contiennent les jeux de connexions peut alors dépasser
+      <directive module="mpm_common">MaxRequestWorkers</directive>.</li>
+    </ul>
+    <p>Le nombre maximum de processus de travail PHP-FPM doit être défini
+    judicieusement car il est possible qu'ils finissent par rester dans l'état
+    occupé ("busy") pour ne gérer que des connexions persistantes inactives,
+    sans avoir la possibilité d'en établir de nouvelles ; ce qui se traduira
+    pour l'utilisateur final par une pile de "HTTP request timeouts".</p>
+    </note>
+
     <p>Dans l'exemple suivant, l'URI de la requête est transmis en tant
     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.
diff --git a/docs/manual/sections.xml.fr b/docs/manual/sections.xml.fr
index 6de3b3575db..f0472f66c0b 100644
--- a/docs/manual/sections.xml.fr
+++ b/docs/manual/sections.xml.fr
@@ -3,7 +3,7 @@
 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1821093:1823764 (outdated) -->
+<!-- English Revision: 1823764 -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
@@ -54,7 +54,7 @@ configuration</title>
 <directive type="section" module="mod_version">IfVersion</directive>
 <directive type="section" module="core">Location</directive>
 <directive type="section" module="core">LocationMatch</directive>
-<directive type="section" module="md">MDomainSet</directive>
+<directive type="section" idtype="section" module="mod_md">MDomainSet</directive>
 <directive type="section" module="mod_proxy">Proxy</directive>
 <directive type="section" module="mod_proxy">ProxyMatch</directive>
 <directive type="section" module="core">VirtualHost</directive>