You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by wr...@apache.org on 2018/09/12 13:01:00 UTC
svn commit: r1840675 [29/45] - in
/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual: ./ developer/ faq/
howto/ misc/ mod/ platform/ programs/ rewrite/ ssl/ style/ style/lang/
style/xsl/util/ vhosts/
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_hcheck.xml
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_hcheck.xml?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_hcheck.xml (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_hcheck.xml Wed Sep 12 13:00:53 2018
@@ -79,7 +79,8 @@
<td>Number of failed health check tests before worker is disabled</td></tr>
<tr><td>hcinterval</td>
<td>30</td>
- <td>Period of health checks in seconds (e.g. performed every 30 seconds)</td></tr>
+ <td>Period of health checks in seconds (e.g. performed every 30 seconds).
+ Uses the <a href="directive-dict.html#Syntax">time-interval</a> directive syntax.</td></tr>
<tr><td>hcuri</td>
<td> </td>
<td>Additional URI to be appended to the worker URL for the health check.</td></tr>
@@ -142,6 +143,7 @@ not dynamically checked at all.</p>
<syntax>ProxyHCExpr <em>name</em> {<em>ap_expr expression</em>}</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
+<override>FileInfo</override>
<usage>
<p>The <directive>ProxyHCExpr</directive> directive allows
@@ -196,6 +198,7 @@ ProxyPass "/apps" "balancer://foo"
<syntax>ProxyHCTemplate <em>name</em> <em>parameter</em>=<em>setting</em> [...]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
+<override>FileInfo</override>
<usage>
<p>The <directive>ProxyHCTemplate</directive> directive allows
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_hcheck.xml.fr
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_hcheck.xml.fr?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_hcheck.xml.fr [utf-8] (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_hcheck.xml.fr [utf-8] Wed Sep 12 13:00:53 2018
@@ -1,9 +1,9 @@
<?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: 1838953 -->
+<!-- English Revision: 1838951 -->
<!-- French translation : Lucien GENTIS -->
-<!-- Reviewed by : Vincent Deffontaines -->
+
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -93,7 +93,8 @@
<tr><td>hcinterval</td>
<td>30</td>
<td>Intervalle entre deux check up en secondes (par défaut effectué
- toutes les 30 secondes)</td></tr>
+ toutes les 30 secondes). Utilise la syntaxe <a
+ href="directive-dict.html#Syntax">time-interval</a>.</td></tr>
<tr><td>hcuri</td>
<td> </td>
<td>URI supplémentaire à ajouter à l'URL de l'équipier pour le check up.</td></tr>
@@ -163,6 +164,7 @@ déterminer la santé d'un serveur d'arr
<syntax>ProxyHCExpr <em>name</em> {<em>ap_expr expression</em>}</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
+<override>FileInfo</override>
<usage>
<p>La directive <directive>ProxyHCExpr</directive> permet de créer et nommer
@@ -221,6 +223,7 @@ paramètres de check up</description>
<syntax>ProxyHCTemplate <em>name</em> <em>parameter</em>=<em>setting</em> [...]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
+<override>FileInfo</override>
<usage>
<p>La directive <directive>ProxyHCTemplate</directive> permet de créer et
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_html.xml
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_html.xml?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_html.xml (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_html.xml Wed Sep 12 13:00:53 2018
@@ -48,12 +48,70 @@ rewritten to work through the gateway. <
<code><a href="http://appserver.example.com/foo/bar.html">foobar</a></code> to
<code><a href="http://www.example.com/appserver/foo/bar.html">foobar</a></code>
making it accessible from outside.</p>
-
-<p>mod_proxy_html was originally developed at WebÞing, whose
-extensive <a href="http://apache.webthing.com/mod_proxy_html/"
->documentation</a> may be useful to users.</p>
</summary>
+<section id="intro"><title>Introduction</title>
+<p>mod_proxy_html was originally a third-party module for Apache HTTPD
+2.0.x and later versions. It was donated to the ASF in 2011 along with
+<module>mod_xml2enc</module> (see <a href="#i18n">Internationalisation</a>)
+and is a standard module in HTTPD 2.4 and development versions.</p>
+</section>
+<section id="custom"><title>Customised HTML Parsing</title>
+<p>Internally, mod_proxy_html uses the HTMLParser module from the
+third-party <a href="http://xmlsoft.org/">libxml2</a> library.
+Unlike other libxml2 parsers, HTMLParser deals with HTML without
+requiring it to be well-formed XML. In particular, it understands
+about implied tags - like a closing </p> - and inserts them
+into the stream of SAX events used by mod_proxy_html. It also has
+explicit knowledge of W3C standards HTML 4 and XHTML 1, and can
+correct certain errors in them.</p>
+<p>mod_proxy_html offers a range of options to control HTML parsing.
+Error correction can be enabled (to your choice of HTML standard)
+or disabled using <directive>ProxyHTMLDocType</directive>.
+And in response to popular demand, it can be configured
+to treat non-standard elements and attributes as links that may
+need rewriting, and to rewrite links in embedded non-HTML contents
+(stylesheets and scripts). Note that it is not suitable for external
+stylesheets or scripts: for those you should use another parser such as
+<module>mod_substitute</module> or <module>mod_sed</module>.
+The main customisation directives are <directive>ProxyHTMLLinks</directive>
+and <directive>ProxyHTMLEvents</directive>. By default these are set in
+configuration file <var>proxy-html.conf</var>, which also contains
+comments to help you customise your parser if required.</p>
+<note>For historical reasons, configuring mod_proxy_html to rewrite
+URLs in scripting events does not by default rewrite URLs in stylesheets.
+This can be changed by uncommenting the relevant line in
+<var>proxy-html.conf</var> as documented there.</note>
+
+</section>
+<section id="i18n"><title>Internationalisation</title>
+<p>Internally, mod_proxy_html uses a smart HTML parser from the
+third-party <a href="http://xmlsoft.org/">libxml2</a> library.
+The parser uses Unicode (utf-8) internally. This makes it a
+somewhat-complex task to handle other encodings required to process
+many non-English-language websites. If this is not handled correctly,
+websites that display non-ASCII characters in encodings other than
+utf-8 (Unicode) will display incorrectly.</p>
+<p>From the first release in 2003 to the donation to Apache in 2011,
+internationalisation (i18n) support developed from near nothing to a
+sophisticated framework capable of applying rules from HTTP, HTML and XML
+to detect a document's encoding and handle it correctly. However,
+this processing was common to mod_proxy_html and other modules using
+libxml2, so it made sense to move it to a separate module rather than
+maintain it in multiple places. That module is <module>mod_xml2enc</module>,
+and must be loaded for i18n to work.</p>
+<p>The interaction of mod_proxy_html with mod_xml2enc is too complex to
+be configured using regular filter configuration, including
+<module>mod_filter</module> directives. Thus while mod_proxy_html can
+still be configured using regular filter directives, this will not support
+i18n at all. Instead, a new directive <directive>ProxyHTMLEnable</directive>
+has been introduced to configure both mod_proxy_html's filter and mod_xml2enc.
+It is recommended that you always use ProxyHTMLEnable even where i18n
+support is not required. <strong>Note that this is a change from earlier
+versions where filter directives were used to activate mod_proxy_html.</strong></p>
+
+</section>
+
<directivesynopsis>
<name>ProxyHTMLMeta</name>
<description>Turns on or off extra pre-parsing of metadata in HTML
@@ -224,7 +282,7 @@ in mod_proxy_html 3.x for HTTPD 2.0 and
<context>virtual host</context><context>directory</context>
</contextlist>
<compatibility>Version 2.4 and later; available as a third-party
-module for earlier 2.x versions</compatibility>
+for earlier 2.x versions</compatibility>
<usage>
<p>This enables per-request interpolation in
@@ -240,7 +298,10 @@ module for earlier 2.x versions</compati
<name>ProxyHTMLDocType</name>
<description>Sets an HTML or XHTML document type declaration.</description>
<syntax>ProxyHTMLDocType HTML|XHTML [Legacy]<br/><strong>OR</strong>
-<br/>ProxyHTMLDocType <var>fpi</var> [SGML|XML]</syntax>
+<br/>ProxyHTMLDocType <var>fpi</var> [SGML|XML]<br/><strong>OR</strong>
+<br/>ProxyHTMLDocType html5<br/><strong>OR</strong>
+<br/>ProxyHTMLDocType auto</syntax>
+<default>ProxyHTMLDocType auto (2.5/trunk versions); no FPI (2.4.x)</default>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
</contextlist>
@@ -258,9 +319,9 @@ be necessary if you are proxying pre-199
authoring/publishing tools.</p>
<p>In the second form, it will insert your own FPI. The optional second
argument determines whether SGML/HTML or XML/XHTML syntax will be used.</p>
-<p>The default is changed to omitting any FPI,
-on the grounds that no FPI is better than a bogus one. If your backend
-generates decent HTML or XHTML, set it accordingly.</p>
+<p>The third form declares documents as HTML 5.</p>
+<p>The fourth form is new in HTTPD trunk and not yet available in released
+versions, and uses libxml2's HTML parser to detect the doctype.</p>
<p>If the first form is used, mod_proxy_html
will also clean up the HTML to the specified standard. It cannot
fix every error, but it will strip out bogus elements and attributes.
@@ -375,7 +436,7 @@ size and avoid the need to resize the bu
<context>virtual host</context><context>directory</context>
</contextlist>
<compatibility>Version 2.4 and later; available as a third-party
-for earlier 2.x versions</compatibility>
+module for earlier 2.x versions</compatibility>
<usage>
<p>Specifies one or more attributes to treat as scripting events and
apply <directive module="mod_proxy_html">ProxyHTMLURLMap</directive>s to where enabled.
@@ -385,7 +446,10 @@ You can specify any number of attributes
one scope so that one overrides the other, you'll need to specify a complete
set in each of those scopes.</p>
<p>A default configuration is supplied in <var>proxy-html.conf</var>
-and defines the events in standard HTML 4 and XHTML 1.</p>
+and defines the events in standard HTML 4 and XHTML 1. This can be
+extended to apply to URLs embedded in CSS stylesheet attributes
+by adding the <var>style</var> attribute to ProxyHTMLEvents, although
+this is not enabled in the shipped default.</p>
</usage>
</directivesynopsis>
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_html.xml.fr
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_html.xml.fr?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_html.xml.fr [utf-8] (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_html.xml.fr [utf-8] Wed Sep 12 13:00:53 2018
@@ -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: 1834050 -->
+<!-- English Revision: 1834041 -->
<!-- French translation : Lucien GENTIS -->
<!--
@@ -55,12 +55,78 @@ en <code><a
href="http://www.example.com/appserver/foo/bar.html">foobar</a></code>,
ce qui permet de rendre le serveur d'applications accessible depuis
l'extérieur.</p>
-
-<p>mod_proxy_html a été développé à l'origine à WebÞing, dont la <a
-href="http://apache.webthing.com/mod_proxy_html/">documentation</a>
-détaillée pourra s'avérer utile aux utilisateurs.</p>
</summary>
+<section id="intro"><title>Introduction</title>
+<p>mod_proxy_html est apparu en tant que module tiers avec les versions 2.0.x du
+serveur HTTP Apache. Il a ensuite été donné à l'ASF en 2011 avec le module
+<module>mod_xml2enc</module> (voir <a href="#i18n">Internationalisation</a>), et
+fait maintenant partie des modules standards de HTTPD 2.4 et de ses versions de
+développement.</p>
+</section>
+<section id="custom"><title>Interprétation HTML personnalisée</title>
+<p>mod_proxy_html utilise en interne le module HTMLParser fourni par la
+bibliothèque tierce <a href="http://xmlsoft.org/">libxml2</a>. A la différence
+des autres interpréteurs libxml2, HTMLParser traite les documents HTML sans
+imposer à ces derniers d'être bien formés du point de vue XML. En particulier,
+il sait gérer les tags implicites - comme le </p> fermant - et les insère
+dans le flux des évènements SAX utilisé par mod_proxy_html. Il possède aussi une
+connaissance explicite des standards HTML 4 et XHTML 1 du W3C, et peut en
+corriger certaines erreurs.</p>
+<p>mod_proxy_html offre toute une panoplie d'options permettant de contrôler
+l'interprétation du code HTML. La correction d'erreur peut être activée (selon
+votre choix de standard HTML) ou désactivée via la directive
+<directive>ProxyHTMLDocType</directive>. Et à la demande générale, il peut être
+configuré pour traiter les éléments et attributs non standards en tant que liens
+qui devront peut-être être réécrits, et pour réécrire les liens dans les contenus
+embarqués non-HTML (feuilles de style et scripts). Notez que ce module ne
+convient pas pour traiter les feuilles de style ou scripts externes ; pour ces
+derniers, vous devez utiliser un autre interpréteur comme
+<module>mod_substitute</module> ou <module>mod_sed</module>. Les principales
+directives permettant de personnaliser l'interprétation du code HTML sont
+<directive>ProxyHTMLLinks</directive> et <directive>ProxyHTMLEvents</directive>.
+Par défaut, elles sont définies dans le fichier de configuration
+<var>proxy-html.conf</var> qui contient aussi des commentaires pour vous aider à
+personnaliser votre interpréteur si nécessaire. </p>
+<note>Pour des raisons historiques, configurer mod_proxy_html pour réécrire les
+URLs dans les évènements de scripting n'entraîne pas par défaut la réécriture des
+URLs dans les feuilles de style. Ce comportement peut être modifié en
+décommentant la ligne correspondante du fichier <var>proxy-html.conf</var> comme
+indiqué dans la documentation que contient ce dernier.</note>
+
+</section>
+<section id="i18n"><title>Internationalisation</title>
+<p>mod_proxy_html utilise en interne un interpréteur HTML intelligent fourni par
+la bibliothèque tierce <a href="http://xmlsoft.org/">libxml2</a>. L'interpréteur
+utilise Unicode (UTF-8) en interne. Ceci complexifie la gestion
+des autres encodages nécessaires pour traiter de nombreux sites web dont le
+langage est autre que l'anglais. Si ce traitement n'est pas effectué
+de manière appropriée, les sites web qui utilisent des caractères non-ASCII dans un
+codage autre que UTF-8 (Unicode) ne s'afficheront pas correctement.</p>
+<p>Entre sa première version en 2003 et sa donnation à Apache en 2011, le
+support de l'internationalisation (i18n) est parti de rien pour arriver à une
+structure sophistiquée capable d'appliquer des règles issues de HTTP, HTML et
+XML pour détecter le codage d'un document et ainsi le traiter correctement. Ce
+traitement était cependant commun à mod_proxy_html et à d'autres modules
+utilisant libxml2, et plutôt que de le maintenir au niveau de chacun de ces
+modules, il parut sensé de l'extraire de ces derniers pour en faire
+un module à part entière. Ce module est <module>mod_xml2enc</module> et il doit
+être chargé pour que l'internationalisation fonctionne.</p>
+<p>L'interaction entre mod_proxy_html et mod_xml2enc est trop complexe pour être
+configurée en utilisant les règles de filtrage classiques, y compris les
+directives de <module>mod_filter</module>. Ainsi, même si mod_proxy_html peut
+quand-même être configuré via les directives de filtrage classiques, ce ne sera
+pas suffisant pour le support de l'internationalisation. A cet effet, on a
+introduit la nouvelle directive <directive>ProxyHTMLEnable</directive> qui
+permet de configurer à la fois le filtre de mod_proxy_html et mod_xml2enc. Il
+est d'ailleurs recommandé de toujours utiliser ProxyHTMLEnable, même
+si le support de l'internationalisation n'est pas nécessaire. <strong>Notez que
+ceci constitue un changement par rapport aux précédentes versions où
+mod_proxy_html était activé via les directives de filtrage.</strong></p>
+
+</section>
+
+
<directivesynopsis>
<name>ProxyHTMLMeta</name>
<description>Active ou désactive une préinterprétation supplémentaire
@@ -279,7 +345,10 @@ Disponible en tant que module tiers dans
<name>ProxyHTMLDocType</name>
<description>Définit une déclaration de type de document HTML ou XHTML.</description>
<syntax>ProxyHTMLDocType HTML|XHTML [Legacy]<br/><strong>OR</strong>
-<br/>ProxyHTMLDocType <var>fpi</var> [SGML|XML]</syntax>
+<br/>ProxyHTMLDocType <var>fpi</var> [SGML|XML]<br/><strong>OR</strong>
+<br/>ProxyHTMLDocType html5<br/><strong>OR</strong>
+<br/>ProxyHTMLDocType auto</syntax>
+<default>ProxyHTMLDocType auto (2.5/trunk versions); no FPI (2.4.x)</default>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
</contextlist>
@@ -292,17 +361,17 @@ Disponible en tant que module tiers dans
si la syntaxe utilisée en sortie est HTML ou XHTML. Notez que le format
des documents en provenance du serveur d'arrière-plan n'est pas
important, car l'interpréteur le détectera automatiquement. Si le
-second argument optionnel est défini à <code>Legacy</code>, les documents seront
+second argument optionnel est défini à "<code>Legacy</code>", les documents seront
déclarés de type "Transitional" ; cette option peut être nécessaire si
vous mandatez du contenu datant d'avant 1998, ou si vous travaillez avec
des outils de création/publication déficients.</p>
<p>Avec la deuxième syntaxe, cette directive vous permet d'insérer votre
propre FPI (Formal Public Identifier). Le second argument optionnel
détermine si la syntaxe utilisée sera SGML/HTML ou XML/XHTML.</p>
-<p>Par défaut, aucun FPI n'est inséré, étant donné qu'il vaut mieux pas
-de FPI du tout qu'un FPI bogué. Si par contre votre serveur d'arrière-plan
-génère du contenu HTML ou XHTML correct, vous pouvez définir cette
-directive en conséquence.</p>
+<p>La troisième syntaxe attribue le type HTML 5 aux documents.</p>
+<p>La quatrième syntaxe est nouvelle dans la branche trunk de HTTPD et
+n'est pas encore disponible dans les versions stables ; elle utilise
+l'interpréteur HTML de libxml2 pour déterminer le type de document.</p>
<p>Avec la première syntaxe, mod_proxy_html va aussi mettre le code HTML
en conformité avec le standard spécifié. Il ne pourra pas corriger
toutes les erreurs, mais il va supprimer les éléments et attributs non
@@ -445,7 +514,10 @@ l'emportant sur d'autres, vous devrez sp
d'évènements pour chaque niveau.</p>
<p>Le fichier <var>proxy-html.conf</var> fournit une configuration par
défaut et définit les évènements selon les standards
-HTML 4 et XHTML 1.</p>
+HTML 4 et XHTML 1. Cette configuration peut être adaptée pour s'appliquer aux
+URLs embarquées dans les attributs des feuilles de style CSS en ajoutant
+l'attribut <var>style</var> à ProxyHTMLEvents, même s'il n'existe pas dans la
+configuration par défaut.</p>
</usage>
</directivesynopsis>
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_http.xml.fr
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_http.xml.fr?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_http.xml.fr [utf-8] (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_http.xml.fr [utf-8] Wed Sep 12 13:00:53 2018
@@ -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 : 1652402 -->
+<!-- English Revision : 1652400 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_http2.xml
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_http2.xml?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_http2.xml (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_http2.xml Wed Sep 12 13:00:53 2018
@@ -25,7 +25,7 @@
<name>mod_proxy_http2</name>
<description>HTTP/2 support module for
<module>mod_proxy</module></description>
-<status>Extension</status>
+<status>Experimental</status>
<sourcefile>mod_proxy_http2.c</sourcefile>
<identifier>proxy_http2_module</identifier>
@@ -46,7 +46,7 @@
to the same backend are sent over a single TCP connection
whenever possible (namely when the connection can be re-used).</p>
- <p>Caveat: there will be no attemp to consolidate multiple HTTP/1.1
+ <p>Caveat: there will be no attempt to consolidate multiple HTTP/1.1
frontend requests (configured to be proxied to the same backend)
into HTTP/2 streams belonging to the same HTTP/2 request.
Each HTTP/1.1 frontend request will be proxied to the backend using
@@ -116,4 +116,17 @@ ProxyPassReverse "/app" "http://app.exam
</dl>
</section>
+<section id="h2push"><title>HTTP/2 PUSH</title>
+ <p>The module does not support the HTTP/2 feature PUSH. Backend servers
+ that would like to advertise preload resources should send the appropriate
+ <code>Link</code> headers.</p>
+ <p>If available, they may do so using the <code>"103 Early Hints"</code>
+ intermediate responses as specified in
+ <a href="https://tools.ietf.org/html/rfc8297">RFC 8297</a>. This will give
+ the best performance. If the client is talking HTTP/2 as well, this may
+ then result in a PUSH from Apache to the client or just in forwarding
+ the 103 response.</p>
+
+</section>
+
</modulesynopsis>
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_http2.xml.fr
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_http2.xml.fr?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_http2.xml.fr [utf-8] (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_http2.xml.fr [utf-8] Wed Sep 12 13:00:53 2018
@@ -1,9 +1,8 @@
<?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 : 1798491 -->
+<!-- English Revision: 1836468 -->
<!-- French translation : Lucien GENTIS -->
-<!-- Reviewed by : Vincent Deffontaines -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -26,49 +25,48 @@
<name>mod_proxy_http2</name>
<description>Support de HTTP/2 pour <module>mod_proxy</module></description>
-<status>Extension</status>
+<status>Experimental</status>
<sourcefile>mod_proxy_http2.c</sourcefile>
<identifier>proxy_http2_module</identifier>
<summary>
<p><module>mod_proxy_http2</module> ne
- supporte que HTTP/2 et ne permet pas de rétrogradation vers HTTP/1.1. Cela
- signifie que le serveur d'arrière-plan doit supporter HTTP/2 car HTTP/1.1 ne
- pourra alors pas être utilisé.</p>
+ supporte que HTTP/2 et ne permet pas de rétrogradation vers HTTP/1.1. Cela
+ signifie que le serveur d'arrière-plan doit supporter HTTP/2 car HTTP/1.1 ne
+ pourra alors pas être utilisé.</p>
- <p>Ce module <em>nécessite</em> la présence de <module>mod_proxy</module> ;
- pour pouvoir traiter les requêtes mandatées HTTP/2,
+ <p>Ce module <em>nécessite</em> la présence de <module>mod_proxy</module> ;
+ pour pouvoir traiter les requêtes mandatées HTTP/2,
<module>mod_proxy</module> et <module>mod_proxy_http2</module> doivent donc
- être chargés par le serveur.</p>
+ être chargés par le serveur.</p>
- <p><module>mod_proxy_http2</module> travaille avec des requêtes entrantes en
- HTTP/1.1 ou HTTP/2. Dans les deux cas, les requêtes vers le même serveur
- d'arrière-plan sont envoyées
+ <p><module>mod_proxy_http2</module> travaille avec des requêtes entrantes en
+ HTTP/1.1 ou HTTP/2. Dans les deux cas, les requêtes vers le même serveur
+ d'arrière-plan sont envoyées
via une seule connexion TCP, dans la mesure du possible (autrement dit
- lorsque la connexion peut être réutilisée).</p>
+ lorsque la connexion peut être réutilisée).</p>
- <p>Avertissement : il ne sera effectué aucune tentative de fusion de
- plusieurs requêtes entrantes HTTP/1 (devant être mandatées vers le même
- serveur d'arrière-plan) vers des flux HTTP/2 appartenant à la même requête
- HTTP/2. Chaque requête HTTP/1 entrante sera mandatée vers le serveur
- d'arrière-plan en utilisant une requête HTTP/2 séparée (tout en réutilisant
- si possible la même connexion TCP).</p>
+ <p>Avertissement : il ne sera effectué aucune tentative de fusion de
+ plusieurs requêtes entrantes HTTP/1 (devant être mandatées vers le même
+ serveur d'arrière-plan) vers des flux HTTP/2 appartenant à la même requête
+ HTTP/2. Chaque requête HTTP/1 entrante sera mandatée vers le serveur
+ d'arrière-plan en utilisant une requête HTTP/2 séparée (tout en réutilisant
+ si possible la même connexion TCP).</p>
<p>Ce module s'appuie sur <a href="http://nghttp2.org/">libnghttp2</a> pour
fournir le moteur central http/2.</p>
- <note type="warning"><title>Avertissement</title>
- <p>Ce module en est au
- stade expérimental. Ses comportement, directives et valeurs par défauts sont
- donc susceptibles de modifications d'une version à l'autre plus fréquentes
- que pour les autres modules. A ce titre, il est fortement conseillé aux
+ <note type="warning"><title>Avertissement</title> <p>Ce module en est au
+ stade expérimental. Ses comportement, directives et valeurs par défauts sont
+ donc susceptibles de modifications d'une version à l'autre plus fréquentes
+ que pour les autres modules. A ce titre, il est fortement conseillé aux
utilisateurs de consulter le fichier "CHANGES" pour prendre connaissance de
ces modifications.</p> </note>
<note type="warning"><title>Avertissement</title>
<p>N'activez pas le mandatement avant d'avoir <a
- href="mod_proxy.html#access">sécurisé votre serveur</a>. Les serveurs
- mandataires ouverts sont dangereux non seulement pour votre propre réseau,
+ href="mod_proxy.html#access">sécurisé votre serveur</a>. Les serveurs
+ mandataires ouverts sont dangereux non seulement pour votre propre réseau,
mais aussi pour l'Internet au sens large.</p>
</note>
</summary>
@@ -79,7 +77,7 @@
<section id="examples"><title>Exemples de base</title>
<p>Les exemples ci-dessous montrent comment configurer HTTP/2 pour des
- connexions d'arrière-plan vers un mandataire inverse.</p>
+ connexions d'arrière-plan vers un mandataire inverse.</p>
<example><title>HTTP/2 (TLS)</title>
<highlight language="config">
@@ -88,7 +86,7 @@ ProxyPassReverse "/app" "https://app.exa
</highlight>
</example>
- <example><title>HTTP/2 (non sécurisé)</title>
+ <example><title>HTTP/2 (non sécurisé)</title>
<highlight language="config">
ProxyPass "/app" "h2c://app.example.com"
ProxyPassReverse "/app" "http://app.example.com"
@@ -98,14 +96,14 @@ ProxyPassReverse "/app" "http://app.exam
<note>
<p>Pour mandater en inverse les protocoles <code>h2</code> ou
<code>h2c</code>, on utilise la directive
- <directive>ProxyPassReverse</directive> avec les schèmes habituels
+ <directive>ProxyPassReverse</directive> avec les schèmes habituels
<code>https</code> et respectivement
- <code>http</code> qui sont connus et utilisés par l'agent utilisateur.</p>
+ <code>http</code> qui sont connus et utilisés par l'agent utilisateur.</p>
</note>
</section> <!-- /examples -->
-<section id="notes"><title>Informations sur les requêtes</title>
- <p><module>mod_proxy_http</module> fournit les informations sur les requêtes
+<section id="notes"><title>Informations sur les requêtes</title>
+ <p><module>mod_proxy_http</module> fournit les informations sur les requêtes
suivantes pour enregistrement dans les journaux en utilisant le format
<code>%{VARNAME}n</code> avec les directives <directive
module="mod_log_config">LogFormat</directive> ou <directive
@@ -113,11 +111,24 @@ ProxyPassReverse "/app" "http://app.exam
</p>
<dl>
<dt>proxy-source-port</dt>
- <dd>Le numéro de port local utilisé pour la connexion vers le serveur
- d'arrière-plan.</dd>
+ <dd>Le numéro de port local utilisé pour la connexion vers le serveur
+ d'arrière-plan.</dd>
<dt>proxy-status</dt>
- <dd>Le statut HTTP/2 en provenance du serveur d'arrière-plan.</dd>
+ <dd>Le statut HTTP/2 en provenance du serveur d'arrière-plan.</dd>
</dl>
</section>
+<section id="h2push"><title>HTTP/2 PUSH</title>
+ <p>Ce module ne supporte pas la fonctionnalité HTTP/2 PUSH. Les serveurs
+ d'arrière-plan qui veulent indiquer des ressources à précharger doivent
+ envoyer les en-têtes <code>Link</code> appropriés.</p>
+ <p>En cas de besoin, il peuvent le faire en utilisant les réponses
+ intermédiaires <code>"103 Early Hints"</code> comme indiqué dans la <a
+ href="https://tools.ietf.org/html/rfc8297">RFC 8297</a>, ce qui fournira
+ les meilleures performances. Si le client comprend aussi le langage HTTP/2,
+ il en résultera un PUSH de la part de httpd vers le celui-ci ou un simple
+ transfert de la réponse 103.</p>
+
+</section>
+
</modulesynopsis>
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_scgi.xml
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_scgi.xml?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_scgi.xml (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_scgi.xml Wed Sep 12 13:00:53 2018
@@ -27,7 +27,6 @@
<status>Extension</status>
<sourcefile>mod_proxy_scgi.c</sourcefile>
<identifier>proxy_scgi_module</identifier>
-<compatibility>Available in version 2.2.14 and later</compatibility>
<summary>
<p>This module <em>requires</em> the service of <module
@@ -56,7 +55,7 @@
<example><title>Simple gateway</title>
<highlight language="config">
- ProxyPass /scgi-bin/ scgi://localhost:4000/
+ProxyPass "/scgi-bin/" "scgi://localhost:4000/"
</highlight>
</example>
@@ -69,9 +68,9 @@
<example><title>Balanced gateway</title>
<highlight language="config">
ProxyPass "/scgi-bin/" "balancer://somecluster/"
-<Proxy "balancer://somecluster">
- BalancerMember "scgi://localhost:4000"
- BalancerMember "scgi://localhost:4001"
+<Proxy balancer://somecluster>
+ BalancerMember scgi://localhost:4000
+ BalancerMember scgi://localhost:4001
</Proxy>
</highlight>
</example>
@@ -90,8 +89,8 @@ ProxyPass "/scgi-bin/" "balancer://somec
and <var>Script-URI</var> and be compliant with RFC 3875 section 3.3.
If instead you need <module>mod_proxy_scgi</module> to generate
a "best guess" for <var>PATH_INFO</var>, set this env-var. The
- variable must be set before <directive module="env">SetEnv</directive>
- is effective. <directive module="setenv">SetEnvIf</directive> can be
+ variable must be set before <directive module="mod_env">SetEnv</directive>
+ is effective. <directive module="mod_setenvif">SetEnvIf</directive> can be
used instead: <code>SetEnvIf Request_URI . proxy-scgi-pathinfo</code>
</dd>
</dl>
@@ -149,8 +148,8 @@ backend</description>
<default>ProxySCGIInternalRedirect On</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context></contextlist>
-<compatibility>The <var>Headername</var> feature is available in version
-2.4.13 and later</compatibility>
+<compatibility>The <var>Headername</var> feature is available in Apache
+httpd 2.4.13 and later.</compatibility>
<usage>
<p>The <directive>ProxySCGIInternalRedirect</directive> enables the backend
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_scgi.xml.fr
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_scgi.xml.fr?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_scgi.xml.fr [utf-8] (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_scgi.xml.fr [utf-8] Wed Sep 12 13:00:53 2018
@@ -1,9 +1,9 @@
-<?xml version="1.0" encoding="UTF-8" ?>
+<?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: 1678234 -->
+<!-- English Revision : 1755335 -->
<!-- French translation : Lucien GENTIS -->
-<!-- Reviewed by : Vincent Deffontaines -->
+<!-- $LastChangedRevision: 2016071301 $ -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -30,7 +30,6 @@
<status>Extension</status>
<sourcefile>mod_proxy_scgi.c</sourcefile>
<identifier>proxy_scgi_module</identifier>
-<compatibility>Disponible depuis la version 2.2.14 d'Apache</compatibility>
<summary>
<p>Pour pouvoir fonctionner, ce module <em>requiert</em> le
@@ -60,7 +59,7 @@
<example><title>Passerelle simple</title>
<highlight language="config">
- ProxyPass /scgi-bin/ scgi://localhost:4000/
+ ProxyPass "/scgi-bin/" "scgi://localhost:4000/"
</highlight>
</example>
@@ -74,9 +73,9 @@
<example><title>Passerelle à répartition de charge</title>
<highlight language="config">
ProxyPass "/scgi-bin/" "balancer://somecluster/"
-<Proxy "balancer://somecluster">
- BalancerMember "scgi://localhost:4000"
- BalancerMember "scgi://localhost:4001"
+<Proxy balancer://somecluster>
+ BalancerMember scgi://localhost:4000
+ BalancerMember scgi://localhost:4001
</Proxy>
</highlight>
</example>
@@ -93,15 +92,15 @@ ProxyPass "/scgi-bin/" "balancer://somec
exportera jamais la variable d'environnement
<var>PATH_INFO</var>. Ceci permet au serveur SCGI d'arrière-plan
de déterminer correctement <var>SCRIPT_NAME</var> et
- <var>Script-URI</var>, et de rester en conformité avec la section
+ <var>Script-URI</var>, et d'être en conformité avec la section
3.3 de la RFC 3875. Si au contraire vous souhaitez que
<module>mod_proxy_scgi</module> génère une estimation la plus
précise possible de <var>PATH_INFO</var>, définissez cette
variable d'environnement. La variable doit être définie avant
- que la directive <directive
- module="env">SetEnv</directive> ne soit effective. Il est possible
- d'utiliser à la place la directive <directive
- module="setenv">SetEnvIf</directive> : <code>SetEnvIf Request_URI . proxy-scgi-pathinfo</code>
+ que la directive <directive module="mod_env">SetEnv</directive> ne soit
+ effective. Il est possible d'utiliser à la place la directive
+ <directive module="mod_setenvif">SetEnvIf</directive> : <code>SetEnvIf
+ Request_URI . proxy-scgi-pathinfo</code>
</dd>
</dl>
</section>
@@ -117,12 +116,11 @@ ProxyPass "/scgi-bin/" "balancer://somec
<usage>
<p>La directive <directive>ProxySCGISendfile</directive> permet au
- serveur cible SCGI de faire servir les fichiers directement par la
- passerelle. Ceci s'avère bénéfique en
- matière de performances —
+ serveur SCGI d'arrière-plan de faire servir les fichiers directement par la
+ passerelle. Ceci s'avère bénéfique en matière de performances —
httpd peut alors utiliser <code>sendfile</code> ou d'autres
optimisations, ce qui n'est pas possible si les fichiers passent par
- la socket du serveur cible. En outre, les fichiers ne sont transmis
+ le socket du serveur cible. En outre, les fichiers ne sont transmis
qu'une seule fois.</p>
<p>L'argument de la directive
<directive>ProxySCGISendfile</directive> détermine le comportement
@@ -140,9 +138,8 @@ ProxyPass "/scgi-bin/" "balancer://somec
<dt>toute autre valeur</dt>
<dd>Identique à <code>On</code>, mais au lieu de rechercher le nom
- d'en-tête codé en dur <code>X-Sendfile</code>, c'est la
- valeur de l'argument qui constitue le nom de l'en-tête
- à rechercher.</dd>
+ d'en-tête codé en dur <code>X-Sendfile</code>, c'est la valeur de
+ l'argument qui constitue le nom de l'en-tête à rechercher.</dd>
</dl>
<example><title>Exemple</title>
@@ -174,16 +171,16 @@ la version 2.4.13 du serveur HTTP Apache
une URL différente. Cette fonctionnalité trouve son origine dans
<module>mod_cgi</module> qui redirige la réponse en interne si
l'état de la réponse est <code>OK</code> (<code>200</code>), et si
- la réponse contient un en-tête <code>Location</code>
- (ou un autre en-tête défini) dont la valeur
+ la réponse contient un en-tête <code>Location</code> (ou un autre
+ en-tête défini) dont la valeur
débute par un slash (<code>/</code>). Cette valeur est interprétée
comme une nouvelle URL locale vers laquelle Apache httpd effectue sa
redirection.</p>
<p>De ce point de vue, <module>mod_proxy_scgi</module> fait la même
chose que <module>mod_cgi</module>, mais vous pouvez en plus
- désactiver la fonctionnalité ou spécifier
- l'utilisation d'un en-tête autre que <code>Location</code>.</p>
+ désactiver la fonctionnalité ou spécifier l'utilisation d'un en-tête
+ autre que <code>Location</code>.</p>
<example><title>Exemple</title>
<highlight language="config">
@@ -194,7 +191,6 @@ la version 2.4.13 du serveur HTTP Apache
<Location /django-app/>
ProxySCGIInternalRedirect X-Location
</Location>
-
</highlight>
</example>
</usage>
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_wstunnel.xml
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_wstunnel.xml?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_wstunnel.xml (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_wstunnel.xml Wed Sep 12 13:00:53 2018
@@ -61,4 +61,59 @@ in the response <code>Upgrade</code></p>
</summary>
<seealso><module>mod_proxy</module></seealso>
+
+<directivesynopsis>
+<name>ProxyWebsocketAsync</name>
+<description>Instructs this module to try to create an asynchronous tunnel</description>
+<syntax>ProxyWebsocketAsync ON|OFF</syntax>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+</contextlist>
+
+<usage>
+ <p>This directive instructs the server to try to create an asynchronous tunnel.
+ If the current MPM does not support the necessary features, a synchronous
+ tunnel is used.</p>
+ <note><title>Note</title><p>Async support is experimental and subject
+ to change.</p></note>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>ProxyWebsocketIdleTimeout</name>
+<description>Sets the maximum amount of time to wait for data on the websockets tunnel</description>
+<syntax>ProxyWebsocketIdleTimeout <var>num</var>[ms]</syntax>
+<default>ProxyWebsocketIdleTimeout 0</default>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+</contextlist>
+
+<usage>
+ <p>This directive imposes a maximum amount of time for the tunnel to be
+ left open while idle. The timeout is considered in seconds by default, but
+ it is possible to increase the time resolution to milliseconds
+ adding the <em>ms</em> suffix.</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>ProxyWebsocketAsyncDelay</name>
+<description>Sets the amount of time the tunnel waits synchronously for data</description>
+<syntax>ProxyWebsocketAsyncDelay <var>num</var>[ms]</syntax>
+<default>ProxyWebsocketAsyncDelay 0</default>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+</contextlist>
+
+<usage>
+ <p>If <directive>ProxyWebsocketAsync</directive> is enabled, this directive
+ controls how long the server synchronously waits for more data. The timeout
+ is considered in seconds by default, but it is possible to increase
+ the time resolution to milliseconds adding the <em>ms</em> suffix.</p>
+
+ <note><title>Note</title><p>Async support is experimental and subject
+ to change. </p></note>
+
+</usage>
+</directivesynopsis>
</modulesynopsis>
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_wstunnel.xml.fr
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_wstunnel.xml.fr?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_wstunnel.xml.fr [utf-8] (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_proxy_wstunnel.xml.fr [utf-8] Wed Sep 12 13:00:53 2018
@@ -1,9 +1,9 @@
<?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 : 1808698 -->
+<!-- English Revision : 1801594 -->
<!-- French translation : Lucien GENTIS -->
-<!-- Reviewed by : Vincent Deffontaines -->
+<!-- $LastChangedRevision: 2017071501 $ -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -30,41 +30,97 @@ websockets</description>
<status>Extension</status>
<sourcefile>mod_proxy_wstunnel.c</sourcefile>
<identifier>proxy_wstunnel_module</identifier>
-<compatibility>Disponible à partir de la version 2.4.5 du serveur HTTP
+<compatibility>Disponible à partir de la version 2.4.5 du serveur HTTP
Apache</compatibility>
<summary>
- <p>Pour utiliser ce module, <module>mod_proxy</module> doit être
- chargé. Il fournit le support du tunnelling pour les connexions
- websocket vers un serveur websockets d'arrière-plan. La connexion
+ <p>Pour utiliser ce module, <module>mod_proxy</module> doit être
+ chargé. Il fournit le support du tunnelling pour les connexions
+ websocket vers un serveur websockets d'arrière-plan. La connexion
est automatiquement promue en connexion websocket :</p>
- <example><title>Réponse HTTP</title>
+ <example><title>Réponse HTTP</title>
<highlight language="config">
Upgrade: WebSocket
Connection: Upgrade
</highlight>
</example>
-<p>Le mandatement des requêtes vers un serveur websockets comme
-<code>echo.websocket.org</code> peut être configuré via la directive <directive
+<p>Le mandatement des requêtes vers un serveur websockets comme
+<code>echo.websocket.org</code> peut être configuré via la directive <directive
type="ProxyPass" module="mod_proxy">ProxyPass</directive> :</p>
<highlight language="config">
ProxyPass "/ws2/" "ws://echo.websocket.org/"
ProxyPass "/wss2/" "wss://echo.websocket.org/"
</highlight>
-<p>La répartition de charge entre plusieurs serveurs d'arrière-plan peut être
-configurée via le module <module>mod_proxy_balancer</module>.</p>
+<p>La répartition de charge entre plusieurs serveurs d'arrière-plan peut être
+configurée via le module <module>mod_proxy_balancer</module>.</p>
-<p>En fait, ce module permet d'accepter d'autres protocoles ; vous pouvez à cet
-effet utiliser le paramètre <code>upgrade</code> de la directive <directive
+<p>En fait, ce module permet d'accepter d'autres protocoles ; vous pouvez à cet
+effet utiliser le paramètre <code>upgrade</code> de la directive <directive
type="ProxyPass" module="mod_proxy">ProxyPass</directive>. La valeur NONE
-signifie que vous court-circuitez la consultation de l'en-tête, mais que vous
-autorisez quand-même WebSocket. La valeur ANY signifie que <code>Upgrade</code>
-va lire les en-têtes de la requête et les utilisera dans l'en-tête
-<code>Upgrade</code> de la réponse.</p>
+signifie que vous court-circuitez la consultation de l'en-tête, mais que vous
+autorisez quand-même WebSocket. La valeur ANY signifie que <code>Upgrade</code>
+va lire les en-têtes de la requête et les utilisera dans l'en-tête
+<code>Upgrade</code> de la réponse.</p>
</summary>
<seealso><module>mod_proxy</module></seealso>
+
+<directivesynopsis>
+<name>ProxyWebsocketAsync</name>
+<description>Création d'un tunnel asynchrone</description>
+<syntax>ProxyWebsocketAsync ON|OFF</syntax>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+</contextlist>
+
+<usage>
+ <p>Cette directive permet d'imposer la création d'un tunnel
+ asynchrone. Si le module MPM utilisé ne supporte pas les
+ fonctionnalités nécessaires, le tunnel est créé en mode synchrone.</p>
+ <note><title>Note</title><p>Le support du mode asynchrone est
+ au stade expérimental et est susceptible d'évoluer.</p></note>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>ProxyWebsocketIdleTimeout</name>
+<description>Temps d'attente maximum pour des données sur le tunnel websockets</description>
+<syntax>ProxyWebsocketIdleTimeout <var>num</var>[ms]</syntax>
+<default>ProxyWebsocketIdleTimeout 0</default>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+</contextlist>
+
+<usage>
+ <p>Cette directive permet de définir un temps maximum pendant lequel
+ le tunnel pourra rester ouvert et inactif. Par défaut, ce temps est exprimé
+ en secondes, mais vous pouvez le spécifier en millisecondes en utilisant le
+ suffixe <em>ms</em>.</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>ProxyWebsocketAsyncDelay</name>
+<description>Temps d'attente synchrone maximum pour des données</description>
+<syntax>ProxyWebsocketAsyncDelay <var>num</var>[ms]</syntax>
+<default>ProxyWebsocketAsyncDelay 0</default>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+</contextlist>
+
+<usage>
+ <p>Si la directive <directive>ProxyWebsocketAsync</directive> est
+ activée, cette directive permet de définir le temps maximum pendant lequel
+ le serveur attendra des données en mode synchrone. Par défaut, ce temps est exprimé
+ en secondes, mais vous pouvez le spécifier en millisecondes en utilisant le
+ suffixe <em>ms</em>.</p>
+
+ <note><title>Note</title><p>Le support du mode asynchrone est
+ au stade expérimental et est susceptible d'évoluer.</p></note>
+</usage>
+</directivesynopsis>
+
</modulesynopsis>
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_ratelimit.xml
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_ratelimit.xml?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_ratelimit.xml (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_ratelimit.xml Wed Sep 12 13:00:53 2018
@@ -67,4 +67,3 @@ If the value specified for <code>rate-li
</summary>
</modulesynopsis>
-
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_ratelimit.xml.fr
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_ratelimit.xml.fr?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_ratelimit.xml.fr [utf-8] (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_ratelimit.xml.fr [utf-8] Wed Sep 12 13:00:53 2018
@@ -1,9 +1,8 @@
<?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: 1835168 -->
+<!-- English Revision: 1833875 -->
<!-- French translation : Lucien GENTIS -->
-<!-- Reviewed by : Vincent Deffontaines -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_reflector.xml.fr
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_reflector.xml.fr?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_reflector.xml.fr [utf-8] (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_reflector.xml.fr [utf-8] Wed Sep 12 13:00:53 2018
@@ -1,9 +1,9 @@
-<?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.en.xsl"?>
-<!-- English Revision : 1673563 -->
+<!-- English Revision : 1673892 -->
<!-- French translation : Lucien GENTIS -->
-<!-- Reviewed by : Vincent Deffontaines -->
+<!-- $LastChangedRevision: 2015041901 $ -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_remoteip.xml
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_remoteip.xml?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_remoteip.xml (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_remoteip.xml Wed Sep 12 13:00:53 2018
@@ -50,7 +50,7 @@ via the request headers.
<p>Once replaced as instructed, this overridden useragent IP address is
then used for the <module>mod_authz_host</module>
- <directive module="mod_authz_core" name="require">Require ip</directive>
+ <directive module="mod_authz_core" name="Require">Require ip</directive>
feature, is reported by <module>mod_status</module>, and is recorded by
<module>mod_log_config</module> <code>%a</code> and <module>core</module>
<code>%a</code> format strings. The underlying client IP of the connection
@@ -120,9 +120,12 @@ via the request headers.
<var>header-field</var> header as the useragent IP address, or list
of intermediate useragent IP addresses, subject to further configuration
of the <directive module="mod_remoteip">RemoteIPInternalProxy</directive> and
- <directive module="mod_remoteip">RemoteIPTrustedProxy</directive> directives. Unless these
- other directives are used, <module>mod_remoteip</module> will trust all
- hosts presenting a <directive module="mod_remoteip">RemoteIPHeader</directive> IP value.</p>
+ <directive module="mod_remoteip">RemoteIPTrustedProxy</directive> directives.</p>
+
+ <note type="warning"> Unless these other directives are used, <module>mod_remoteip</module>
+ will trust all hosts presenting a non internal address in the
+ <directive module="mod_remoteip">RemoteIPHeader</directive> header value.
+ </note>
<example><title>Internal (Load Balancer) Example</title>
<highlight language="config">
@@ -285,27 +288,32 @@ Listen 8080
Sometimes it is desirable to require clients to provide the PROXY header, but
permit other clients to connect without it. This directive allows a server
administrator to configure a single host or CIDR range of hosts that may do
- so. This is generally useful for monitoring and administrative traffic to a
- virtual host direct to the server behind the upstream load balancer.</p>
+ so.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>RemoteIPTrustedProxy</name>
-<description>Declare client intranet IP addresses trusted to present the RemoteIPHeader value</description>
+<description>Restrict client IP addresses trusted to present the RemoteIPHeader value</description>
<syntax>RemoteIPTrustedProxy <var>proxy-ip</var>|<var>proxy-ip/subnet</var>|<var>hostname</var> ...</syntax>
<contextlist><context>server config</context><context>virtual host</context></contextlist>
<usage>
- <p>The <directive module="mod_remoteip">RemoteIPTrustedProxy</directive> directive adds one
- or more addresses (or address blocks) to trust as presenting a valid
- RemoteIPHeader value of the useragent IP. Unlike the
- <directive module="mod_remoteip">RemoteIPInternalProxy</directive> directive, any intranet
+ <p>The <directive module="mod_remoteip">RemoteIPTrustedProxy</directive>
+ directive restricts which peer IP addresses (or address blocks) will be
+ trusted to present a valid RemoteIPHeader value of the useragent IP.</p>
+
+ <p> Unlike the <directive module="mod_remoteip">RemoteIPInternalProxy</directive> directive, any intranet
or private IP address reported by such proxies, including the 10/8, 172.16/12,
192.168/16, 169.254/16 and 127/8 blocks (or outside of the IPv6 public
2000::/3 block) are not trusted as the useragent IP, and are left in the
<directive module="mod_remoteip">RemoteIPHeader</directive> header's value.</p>
+ <note type="warning">By default, <module>mod_remoteip</module> will trust
+ all hosts presenting a non internal address in the
+ <directive module="mod_remoteip">RemoteIPHeader</directive> header value.
+ </note>
+
<example><title>Trusted (Load Balancer) Example</title>
<highlight language="config">
RemoteIPHeader X-Forwarded-For
@@ -318,7 +326,7 @@ RemoteIPTrustedProxy proxy.example.com
<directivesynopsis>
<name>RemoteIPTrustedProxyList</name>
-<description>Declare client intranet IP addresses trusted to present the RemoteIPHeader value</description>
+<description>Restrict client IP addresses trusted to present the RemoteIPHeader value</description>
<syntax>RemoteIPTrustedProxyList <var>filename</var></syntax>
<contextlist><context>server config</context><context>virtual host</context></contextlist>
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_remoteip.xml.fr
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_remoteip.xml.fr?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_remoteip.xml.fr [utf-8] (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_remoteip.xml.fr [utf-8] Wed Sep 12 13:00:53 2018
@@ -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: 1825468 -->
+<!-- English Revision: 1825467 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -46,19 +46,20 @@ répartiteur de charge via les en-têtes
l'en-tête de requête configuré via la directive
<directive module="mod_remoteip">RemoteIPHeader</directive>.</p>
- <p>Ce module implémente aussi la partie serveur du <a
+ <p>En outre, ce module implémente la partie serveur du <a
href="http://blog.haproxy.com/haproxy/proxy-protocol/">protocole PROXY</a>
- de HAProxy via la directive <directive
+ de HAProxy lorsqu'on utilise la directive <directive
module="mod_remoteip">RemoteIPProxyProtocol</directive>.</p>
<p>Une fois sa valeur modifiée comme indiqué, cette adresse IP client est
- utilisée pour la fonctionnalité <directive module="mod_authz_core"
- name="require">Require ip</directive> de <module>mod_authz_host</module> ;
- elle est aussi affichée par <module>mod_status</module>, et enregistrée via
- les chaînes de formatage <code>%a</code> des modules
- <module>mod_log_config</module> et <module>core</module>. L'adresse IP
- client sous-jacente de la connexion est enregistrée via la chaîne de
- formatage <code>%{c}a</code>. </p>
+ utilisée pour la fonctionnalité <directive
+ module="mod_authz_host" name="Require">Require ip</directive> de
+ <module>mod_authz_host</module> ; elle est aussi affichée par
+ <module>mod_status</module>, et enregistrée via les chaînes de formatage
+ <code>%a</code> des modules <module>mod_log_config</module> et <module>core</module>.
+ L'adresse IP client sous-jacente de la connexion est enregistrée via la chaîne de
+ formatage <code>%{c}a</code>.
+ </p>
<note type="warning">Il est essentiel de n'activer cette
fonctionnalité que pour les requêtes en provenance des serveurs
@@ -70,9 +71,7 @@ répartiteur de charge via les en-têtes
<seealso><module>mod_authz_host</module></seealso>
<seealso><module>mod_status</module></seealso>
<seealso><module>mod_log_config</module></seealso>
-<seealso><a
-href="http://www.haproxy.org/download/1.8/doc/proxy-protocol.txt">Proxy Protocol
-Spec</a></seealso>
+<seealso><a href="http://www.haproxy.org/download/1.8/doc/proxy-protocol.txt">Proxy Protocol Spec</a></seealso>
<section id="processing"><title>Traitement des adresses distantes</title>
@@ -135,11 +134,7 @@ du client</description>
une liste d'adresses IP clients intermédiaires, en fonction de la
configuration des directives
<directive module="mod_remoteip">RemoteIPInternalProxy</directive> et
- <directive module="mod_remoteip">RemoteIPTrustedProxy</directive>. Si ces
- deux dernières directives ne sont pas utilisées,
- <module>mod_remoteip</module> traitera tout hôte présentant une adresse non
- interne dans l'en-tête <directive
- module="mod_remoteip">RemoteIPHeader</directive> comme hôte de confiance.</p>
+ <directive module="mod_remoteip">RemoteIPTrustedProxy</directive>.</p>
<note type="warning">Si ces deux dernières
directives ne sont pas utilisées, <module>mod_remoteip</module>
@@ -335,7 +330,7 @@ version 2.4.31 du serveur HTTP Apache</c
<directivesynopsis>
<name>RemoteIPTrustedProxy</name>
-<description>Déclare les adresses IP clientes de l'intranet dignes de
+<description>Restreint les adresses IP clients dignes de
confiance pour présenter la valeur RemoteIPHeader</description>
<syntax>RemoteIPTrustedProxy
<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</syntax>
@@ -343,17 +338,25 @@ confiance pour présenter la valeur Remo
<usage>
<p>La directive <directive module="mod_remoteip">RemoteIPTrustedProxy</directive> permet
- d'ajouter une ou plusieurs adresses, ou blocs d'adresses, auxquelles
- on peut faire confiance pour présenter une valeur RemoteIPHeader
- valide de l'adresse IP du client. A la différence de la directive
+ de définir quelles adresses IP (ou blocs d'adresses) seront
+ considérées comme de confiance pour présenter une valeur RemoteIPHeader
+ valide de l'adresse IP du client.</p>
+
+ <p>A la différence de la directive
<directive module="mod_remoteip">RemoteIPInternalProxy</directive>, toutes les adresses IP
intranet ou privées indiquées par de tels mandataires, y compris les
blocs d'adresses 10/8, 172.16/12, 192.168/16, 169.254/16 et 127/8
(ou située en dehors du bloc IPv6 public 2000::/3), ne sont pas
- dignes de confiance en tant qu'adresses IP distantes, et se situent
+ dignes de confiance en tant qu'adresses IP clientes, et se situent
à gauche dans le contenu de l'en-tête
<directive module="mod_remoteip">RemoteIPHeader</directive>.</p>
+ <note type="warning">Par défaut, <module>mod_remoteip</module>
+ considérera comme de confiance tout hôte présentant une adresse non
+ interne dans l'en-tête <directive
+ module="mod_remoteip">RemoteIPHeader</directive>.
+ </note>
+
<example><title>Exemple d'adresse de confiance (répartiteur de
charge</title>
<highlight language="config">
@@ -367,7 +370,7 @@ RemoteIPTrustedProxy proxy.example.com
<directivesynopsis>
<name>RemoteIPTrustedProxyList</name>
-<description>Déclare les adresses IP intranet clients comme dignes de
+<description>Restreint les adresses IP clients dignes de
confiance pour présenter la valeur RemoteIPHeader</description>
<syntax>RemoteIPTrustedProxyList <var>nom-fichier</var></syntax>
<contextlist><context>server config</context><context>virtual host</context></contextlist>
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_reqtimeout.xml
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_reqtimeout.xml?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_reqtimeout.xml (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_reqtimeout.xml Wed Sep 12 13:00:53 2018
@@ -28,7 +28,21 @@
<status>Extension</status>
<sourcefile>mod_reqtimeout.c</sourcefile>
<identifier>reqtimeout_module</identifier>
-<compatibility>Available in Apache HTTPD 2.2.15 and later</compatibility>
+
+<summary>
+ <p>This module provides a convenient way to set timeouts and minimum data
+ rates for receiving requests. Should a timeout occur or a data rate be
+ to low, the corresponding connection will be closed by the server.</p>
+
+ <p>This is logged at <directive module="core">LogLevel</directive>
+ <code>info</code>.</p>
+
+ <p>If needed, the <directive module="core">LogLevel</directive> directive
+ can be tweaked to explicitly log it:</p>
+ <highlight language="config">
+ LogLevel reqtimeout:info
+ </highlight>
+</summary>
<section id="examples"><title>Examples</title>
@@ -89,7 +103,7 @@
<default>header=20-40,MinRate=500 body=20,MinRate=500</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
-<compatibility>Available in version 2.2.15 and later; defaulted to disabled in
+<compatibility>Defaulted to disabled in
version 2.3.14 and earlier.</compatibility>
<usage>
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_reqtimeout.xml.fr
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_reqtimeout.xml.fr?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_reqtimeout.xml.fr [utf-8] (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_reqtimeout.xml.fr [utf-8] Wed Sep 12 13:00:53 2018
@@ -1,9 +1,8 @@
-<?xml version="1.0" encoding="UTF-8"?>
+<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1827779 -->
+<!-- English Revision: 1827780 -->
<!-- French translation : Lucien GENTIS -->
-<!-- Reviewed by : Vincent Deffontaines -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -25,13 +24,28 @@
<modulesynopsis metafile="mod_reqtimeout.xml.meta">
<name>mod_reqtimeout</name>
-<description>Définit le délai maximum et le taux minimum de transfert des
-données pour la réception des requêtes
+<description>Définit le délai maximum et le taux de transfert des
+données minimum pour la réception des requêtes
</description>
<status>Extension</status>
<sourcefile>mod_reqtimeout.c</sourcefile>
<identifier>reqtimeout_module</identifier>
-<compatibility>Disponible depuis la version 2.2.15 du serveur HTTP Apache</compatibility>
+
+<summary>
+ <p>Ce module permet de définir aisément le délai maximum et le taux de
+ transfert des données minimum pour la réception des requêtes. Si ce délai
+ est dépassé ou ce taux trop faible, la connexion concernée sera fermée par
+ le serveur.</p>
+
+ <p>Cet évènement sera alors enregistré dans le journal au niveau de <directive
+ module="core">LogLevel</directive> <code>info</code>.</p>
+
+ <p>Au besoin, la directive <directive module="core">LogLevel</directive>
+ peur être modifiée pour un enregistrement dans le journal plus explicite :</p>
+ <highlight language="config">
+ LogLevel reqtimeout:info
+ </highlight>
+</summary>
<section id="examples"><title>Exemples</title>
@@ -95,8 +109,7 @@ et corps des requêtes en provenance du
<default>header=20-40,MinRate=500 body=20,MinRate=500</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
-<compatibility>Disponible depuis la version 2.2.15 du serveur HTTP
-Apache ; désactivée par défaut depuis la version 2.3.14.</compatibility>
+<compatibility>Désactivée par défaut jusqu'à la version 2.3.14.</compatibility>
<usage>
<p>Cette directive permet de définir différents délais pour la
@@ -117,12 +130,12 @@ Apache ; désactivée par défaut depuis
<p>Lorsqu'une directive <directive
module="core">AcceptFilter</directive> est active (ce qui est en
- général le cas sous Linux et FreeBSD), la socket n'est envoyée au
+ général le cas sous Linux et FreeBSD), le socket n'est envoyé au
processus du serveur qu'après la réception du premier octet (ou de
l'ensemble de la requête si <code>httpready</code> est défini). Le
délai configuré pour les en-têtes via la directive
- <directive>RequestReadTimeout</directive> n'entre en ligne de compte qu'une fois
- la socket reçue par le processus du serveur.</p>
+ <directive>RequestReadTimeout</directive> n'entre en ligne de compte qu'une
+ fois le socket reçu par le processus du serveur.</p>
<p>Il existe deux méthodes pour spécifier le délai (pour l'en-tête
ou le corps) :
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_request.xml.fr
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_request.xml.fr?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_request.xml.fr [utf-8] (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_request.xml.fr [utf-8] Wed Sep 12 13:00:53 2018
@@ -3,7 +3,7 @@
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision : 772682 -->
<!-- French translation : Lucien GENTIS -->
-<!-- Reviewed by : Vincent Deffontaines -->
+<!-- $LastChangedRevision: 2009050301 $ -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -25,8 +25,8 @@
<modulesynopsis metafile="mod_request.xml.meta">
<name>mod_request</name>
-<description>Filtres permettant de traiter et de mettre à disposition
-les corps de requêtes HTTP</description>
+<description>Filtres permettant de traiter et de mettre à disposition
+les corps de requêtes HTTP</description>
<status>Base</status>
<sourcefile>mod_request.c</sourcefile>
<identifier>request_module</identifier>
@@ -34,8 +34,8 @@ les corps de requêtes HTTP</descri
<directivesynopsis>
<name>KeptBodySize</name>
-<description>Conserve le corps de la requête à concurrence de la taille
-maximale spécifiée, pour une utilisation éventuelle par des filtres
+<description>Conserve le corps de la requête à concurrence de la taille
+maximale spécifiée, pour une utilisation éventuelle par des filtres
comme mod_include.</description>
<syntax>KeptBodySize <var>taille maximale en octets</var></syntax>
<default>KeptBodySize 0</default>
@@ -43,46 +43,46 @@ comme mod_include.</description>
</contextlist>
<usage>
- <p>Dans une situation normale, les gestionnaires de requête tels que
- le gestionnaire par défaut des fichiers statiques suppriment le
- corps de la requête s'il n'est pas nécessaire au gestionnaire de
- requête. Il en résulte que les filtres comme mod_include sont
- limités à des requêtes <code>GET</code> lors de l'inclusion d'autres
- URLs en tant que sous-requêtes, et ceci même si la requête originale
- était une requête <code>POST</code>, car le corps de la requête a
- été supprimé et n'est donc plus disponible une fois le traitement du
+ <p>Dans une situation normale, les gestionnaires de requête tels que
+ le gestionnaire par défaut des fichiers statiques suppriment le
+ corps de la requête s'il n'est pas nécessaire au gestionnaire de
+ requête. Il en résulte que les filtres comme mod_include sont
+ limités à des requêtes <code>GET</code> lors de l'inclusion d'autres
+ URLs en tant que sous-requêtes, et ceci même si la requête originale
+ était une requête <code>POST</code>, car le corps de la requête a
+ été supprimé et n'est donc plus disponible une fois le traitement du
filtre mis en oeuvre.</p>
- <p>Lorsque l'argument de cette directive a une valeur supérieure à
- zéro, les gestionnaires de requête qui suppriment habituellement les
- corps de requête vont alors conserver ces corps de requête, à
- concurrence de la taille maximale spécifiée, pour être
- éventuellement utilisés par des filtres. Dans le cas du filtre
- mod_include, une tentative de requête <code>POST</code> pour un
- fichier shtml statique se traduira par des sous-requêtes
- <code>POST</code>, et non par des sous-requêtes <code>GET</code>
+ <p>Lorsque l'argument de cette directive a une valeur supérieure à
+ zéro, les gestionnaires de requête qui suppriment habituellement les
+ corps de requête vont alors conserver ces corps de requête, à
+ concurrence de la taille maximale spécifiée, pour être
+ éventuellement utilisés par des filtres. Dans le cas du filtre
+ mod_include, une tentative de requête <code>POST</code> pour un
+ fichier shtml statique se traduira par des sous-requêtes
+ <code>POST</code>, et non par des sous-requêtes <code>GET</code>
comme avant.</p>
- <p>Cette fonctionnalité permet de découper des pages web complexes
- et des applications web en petits éléments individuels, et de
- combiner ces éléments avec la structure de la page web sous-jacente
- en utilisant <module>mod_include</module>. Les éléments peuvent se
- présenter sous la forme de programmes CGI, de langages de scripts,
+ <p>Cette fonctionnalité permet de découper des pages web complexes
+ et des applications web en petits éléments individuels, et de
+ combiner ces éléments avec la structure de la page web sous-jacente
+ en utilisant <module>mod_include</module>. Les éléments peuvent se
+ présenter sous la forme de programmes CGI, de langages de scripts,
ou d'URLs issues d'un mandataire inverse dans l'espace d'URL d'un
autre serveur en utilisant <module>mod_proxy</module>.</p>
- <p><strong>Note :</strong> Chaque requête dont le corps est ainsi
- conservé doit être enregistrée temporairement en mémoire vive
- jusqu'à la fin du traitement de la requête. Il faut donc s'assurer
- que la mémoire RAM du serveur est suffisante pour pouvoir supporter
- la charge induite. L'utilisation de cette directive doit être
- limitée à certaines portions de votre espace d'URL bien précises qui
- le nécessitent, et en spécifiant comme taille maximale une valeur la
- plus petite possible, mais tout de même suffisante pour un corps de
- requête.</p>
+ <p><strong>Note :</strong> Chaque requête dont le corps est ainsi
+ conservé doit être enregistrée temporairement en mémoire vive
+ jusqu'à la fin du traitement de la requête. Il faut donc s'assurer
+ que la mémoire RAM du serveur est suffisante pour pouvoir supporter
+ la charge induite. L'utilisation de cette directive doit être
+ limitée à certaines portions de votre espace d'URL bien précises qui
+ le nécessitent, et en spécifiant comme taille maximale une valeur la
+ plus petite possible, mais tout de même suffisante pour un corps de
+ requête.</p>
- <p>Si la taille de la requête envoyée par le client dépasse la taille
- maximale autorisée par cette directive, le serveur renverra l'erreur
+ <p>Si la taille de la requête envoyée par le client dépasse la taille
+ maximale autorisée par cette directive, le serveur renverra l'erreur
<code>413 Request Entity Too Large</code>.</p>
</usage>
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_rewrite.xml
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_rewrite.xml?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_rewrite.xml (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_rewrite.xml Wed Sep 12 13:00:53 2018
@@ -291,6 +291,13 @@ LogLevel alert rewrite:trace3
URL. Available in 2.4.26 and later.</p>
</dd>
+ <dt><code>LongURLOptimization</code></dt>
+ <dd>
+ <p>This option reduces memory usage of long, unoptimized rule sets
+ that repeatedly expand long values in RewriteCond and RewriteRule
+ variables. Available in 2.5 and later.</p>
+ </dd>
+
</dl>
</usage>
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_rewrite.xml.fr
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_rewrite.xml.fr?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_rewrite.xml.fr [utf-8] (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_rewrite.xml.fr [utf-8] Wed Sep 12 13:00:53 2018
@@ -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: 1827609 -->
+<!-- English Revision: 1827608 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -329,6 +329,14 @@ pour le moteur de réécriture</descript
2.4.26 du serveur HTTP Apache.</p>
</dd>
+ <dt><code>LongURLOptimization</code></dt>
+ <dd>
+ <p>Cette option permet de réduire la consommation de mémoire des jeux de
+ règles longs et non optimisés qui enregistrent de manière répétitive de
+ longues valeurs dans des variables au sein des directives RewriteCond et
+ RewriteRule. Disponible à partir de la version 2.5 du serveur HTTP Apache.</p>
+ </dd>
+
</dl>
</usage>
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_sed.xml.fr
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_sed.xml.fr?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_sed.xml.fr [utf-8] (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_sed.xml.fr [utf-8] Wed Sep 12 13:00:53 2018
@@ -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: 1817952 -->
+<!-- English Revision: 1817950 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
Modified: httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_session.xml
URL: http://svn.apache.org/viewvc/httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_session.xml?rev=1840675&r1=1840674&r2=1840675&view=diff
==============================================================================
--- httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_session.xml (original)
+++ httpd/sandbox/httpd-2.4.x-trunk-delta/docs/manual/mod/mod_session.xml Wed Sep 12 13:00:53 2018
@@ -263,7 +263,7 @@ SessionCookieName session path=/
AuthFormProvider file
AuthUserFile "conf/passwd"
AuthType form
-AuthName realm
+AuthName "realm"
#...
</highlight>
</example>
@@ -468,6 +468,7 @@ AuthName realm
<context>directory</context>
<context>.htaccess</context>
</contextlist>
+<override>AuthConfig</override>
<usage>
<p>The <directive>SessionExclude</directive> directive allows sessions to
@@ -487,4 +488,42 @@ AuthName realm
</usage>
</directivesynopsis>
+<directivesynopsis>
+<name>SessionExpiryUpdateInterval</name>
+<description>Define the number of seconds a session's expiry may change without
+the session being updated</description>
+<syntax>SessionExpiryUpdateInterval <var>interval</var></syntax>
+<default>SessionExpiryUpdateInterval 0 (always update)</default>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+<context>directory</context>
+<context>.htaccess</context>
+</contextlist>
+<override>AuthConfig</override>
+
+<usage>
+ <p>The <directive>SessionExpiryUpdateInterval</directive> directive allows
+ sessions to avoid the cost associated with writing the session each request
+ when only the expiry time has changed. This can be used to make a website
+ more efficient or reduce load on a database when using
+ <module>mod_session_dbd</module>. The session is always written if the data
+ stored in the session has changed or the expiry has changed by more than the
+ configured interval.</p>
+
+ <p>Setting the interval to zero disables this directive, and the session
+ expiry is refreshed for each request.</p>
+
+ <p>This directive only has an effect when combined with
+ <directive module="mod_session">SessionMaxAge</directive> to enable session
+ expiry. Sessions without an expiry are only written when the data stored in
+ the session has changed.</p>
+
+ <note type="warning"><title>Warning</title>
+ <p>Because the session expiry may not be refreshed with each request, it's
+ possible for sessions to expire up to <var>interval</var> seconds early.
+ Using a small interval usually provides sufficient savings while having a
+ minimal effect on expiry resolution.</p></note>
+</usage>
+</directivesynopsis>
+
</modulesynopsis>