<?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 : 1778350 -->
+<!-- English Revision: 1793934 -->
<!-- French translation : Lucien GENTIS -->
-<!-- $LastChangedRevision: 2017011401 $ -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
# SetHandler est la partie qui suit le "pipe". Si vous devez faire
# une distinction, "localhost" peut être changé en un nom de serveur
# unique.
- <Proxy fcgi://localhost/ enablereuse=on max=10>
+ <Proxy "fcgi://localhost/" enablereuse=on max=10>
</Proxy>
<FilesMatch ...>
<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
</usage>
</directivesynopsis>
+<directivesynopsis>
+<name>ProxyFCGISetEnvIf</name>
+<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>
+<contextlist><context>server config</context>
+<context>virtual host</context><context>directory</context>
+<context>.htaccess</context></contextlist>
+<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
+coeur du programme du serveur web définit un certain nombre de variables
+d'environnement en fonction de certains détails de la requête considérée. Les
+programmes FastCGI utilisent souvent ces variables comme données en entrée afin
+de déterminer quels scripts sous-jacents ils vont exécuter, ou quelles données
+en sortie doivent être produites.</p>
+<p>Voici quelques exemples de variables d'environnement importantes :</p>
+<ul>
+ <li>SCRIPT_NAME</li>
+ <li>SCRIPT_FILENAME</li>
+ <li>REQUEST_URI</li>
+ <li>PATH_INFO</li>
+ <li>PATH_TRANSLATED</li>
+</ul>
+
+<p>Cette directive permet de passer outre les variables d'environnement
+ci-dessus, entre autres. Elle est évaluée après la définition de la valeur
+initiale de ces variables ; elle peuvent donc être utilisées comme entrées dans
+les expressions définissants les conditions et les valeurs.</p>
+<p>Syntaxe des paramètres :</p>
+<dl>
+<dt>conditional-expression</dt>
+<dd>Définit une condition en fonction de laquelle la
+variable d'environnement qui suit sera modifiée ou non. Pour la syntaxe de cette
+expression, reportez-vous aux exemples qui suivent ou à la spécification
+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. 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>. Si cette valeur est
+omise, la variable est définie (ou sa valeur est écrasée) par une chaîne vide
+— voir cependant la note ci-après.</dd>
+</dl>
+
+<example>
+ <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
+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>
+
</modulesynopsis>