Merge in APR[-util] macros from branches/trunk-buildconf-noapr

[apache] / docs / manual / mod / mod_proxy_fcgi.xml.fr

diff --git a/docs/manual/mod/mod_proxy_fcgi.xml.fr b/docs/manual/mod/mod_proxy_fcgi.xml.fr
index 8bc8e249e2628818c04c02d2c5e9ec8141d3a2aa..2c659bfe3d5747ff667be8f1e4b35010e24d9147 100644 (file)
--- 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: 1781329 -->
+<!-- English Revision: 1793934 -->
 <!-- French translation : Lucien GENTIS -->
 
 <!--
@@ -155,7 +155,7 @@ ProxyPass "/myapp/" "balancer://myappcluster/"
    # SetHandler est la partie qui suit le "pipe". Si vous devez faire
    # une distinction, "localhost" peut être changé en un nom de serveur
    # unique.
-   &lt;Proxy fcgi://localhost/ enablereuse=on max=10&gt;
+   &lt;Proxy "fcgi://localhost/" enablereuse=on max=10&gt;
    &lt;/Proxy&gt;
 
 &lt;FilesMatch ...&gt;
@@ -218,7 +218,8 @@ ProxyPass "/myapp/" "balancer://myappcluster/"
 <contextlist><context>server config</context>
 <context>virtual host</context><context>directory</context>
 <context>.htaccess</context></contextlist>
-<compatibility>Disponible à partir de la version 2.5 du serveur HTTP Apache</compatibility>
+<override>FileInfo</override>
+<compatibility>Disponible à partir de la version 2.4.26 du serveur HTTP Apache</compatibility>
 
 <usage>
 <p>Cette directive permet de spécifier le type de l'application FastCGI
@@ -246,12 +247,13 @@ certains scénarios.</p>
 <description>Permet d'adapter la valeur des variables envoyées aux serveurs
 FastCGI</description>
 <syntax>ProxyFCGISetEnvIf <var>conditional-expression</var>
-    <var>environment-variable-name</var>
-    <var>value-expression</var></syntax>
+    [!]<var>environment-variable-name</var>
+    [<var>value-expression</var>]</syntax>
 <contextlist><context>server config</context>
 <context>virtual host</context><context>directory</context>
 <context>.htaccess</context></contextlist>
-<compatibility>Disponible à partir de la version 2.5 du serveur HTTP Apache.</compatibility>
+<override>FileInfo</override>
+<compatibility>Disponible à partir de la version 2.4.26 du serveur HTTP Apache.</compatibility>
 
 <usage>
 <p>Juste avant la transmission d'une requête au serveur FastCGI configuré, le
@@ -283,26 +285,52 @@ détaillée dans le document <a href="../expr.html">ap_expr</a>.
    </dd>
 <dt>environment-variable-name</dt> 
 <dd>Spécifie le nom de la variable d'environnement à modifier, par exemple
-PATH_INFO.</dd>
+PATH_INFO. Si elle est précédée d'un point d'exclamation, la définition de la
+variable sera annulée.</dd>
 <dt>value-expression</dt>
 <dd>Spécifie la nouvelle valeur de la variable "environment-variable-name". On
 peut inclure des
 références arrières, comme "$1", issues de captures en provenance de
-l'expression rationnelle <var>conditional-expression</var></dd>
+l'expression rationnelle <var>conditional-expression</var>. Si cette valeur est
+omise, la variable est définie (ou sa valeur est écrasée) par une chaîne vide
+&mdash; voir cependant la note ci-après.</dd>
 </dl>
   
 <example>
-# Une modification basique, inconditionnelle<br/>
-ProxyFCGISetEnvIf "true" PATH_INFO "/example"<br/>
-<br/>
-# Utilisation d'une variable d'environnement pour spécidier la nouvelle valeur<br/>
-ProxyFCGISetEnvIf "true" PATH_INFO "%{reqenv:SCRIPT_NAME}"<br/>
+   <highlight language="config">
+# Une modification basique, inconditionnelle
+ProxyFCGISetEnvIf "true" PATH_INFO "/example"
+
+# Utilisation d'une variable d'environnement pour spécifier la nouvelle valeur
+ProxyFCGISetEnvIf "true" PATH_INFO "%{reqenv:SCRIPT_NAME}"
 <br/>
 # Utilisation de captures dans la condition et de références arrières dans la
-# nouvelle valeur<br/>
-ProxyFCGISetEnvIf "reqenv('PATH_TRANSLATED') =~ m#(/.*prefix)(\d+)(.*)#" PATH_TRANSLATED "$1$3"<br/>
+# nouvelle valeur
+ProxyFCGISetEnvIf "reqenv('PATH_TRANSLATED') =~ m#(/.*prefix)(\d+)(.*)#" PATH_TRANSLATED "$1$3"
+   </highlight>
 </example>
 
+<note><title>Note : Annulation définition ou valeur vide</title>
+  La ligne suivante annule la définition de la variable <code>VARIABLE</code>,
+  ce qui l'empêche d'être envoyée au serveur FastCGI :
+
+    <highlight language="config">ProxyFCGISetEnvIf true !VARIABLE</highlight>
+
+  La ligne suivante, quant à elle, efface la <em>valeur</em> de la variable
+  <code>VARIABLE</code> en lui affectant la chaîne vide ; cette variable
+  <code>VARIABLE</code> sera alors tout de même envoyée au serveur FastCGI :
+
+    <highlight language="config">ProxyFCGISetEnvIf true VARIABLE</highlight>
+
+  La spécification CGI/1.1 <a
+  href="https://tools.ietf.org/html/rfc3875#section-4.1">ne fait pas de
+  distinction</a> entre une variable contenant une chaîne vide et une variable qui
+  n'existe pas. De nombreuses implémentations CGI et FastCGI font cependant
+  cette distinction (ou permettent aux scripts de la faire). Le choix de celle
+  que vous allez utiliser dépend de votre implémentation et de la raison qui
+  vous pousse à modifier cette variable.
+</note>
+
 </usage>
 </directivesynopsis>