XML updates.

<?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: 1782180:1787736 (outdated) -->

<!-- English Revision: 1787736 -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->

    directives qui supportent le <a

    href="directive-dict.html#Context">contexte de répertoire</a>.</p>

    <note><title>Ce n'est pas un langage de scripting</title>

    Le nom de cette directive peut sembler très familier aux programmeurs et

    administrateurs, mais il ne doit pas être confondu avec son homonyme des langages de

    scripting. A ce titre, l'implémentation actuelle n'envisage pas la

    possibilité d'imbriquer une section <directive type="section">If</directive>

    dans une autre (la section <directive type="section">If</directive> qui se

    trouve à l'intérieure de l'autre serait ignorée).

    </note>

    <note type="warning">

    Certain variables, such as <code>CONTENT_TYPE</code> and other

    response headers, are set after <If> conditions have already

<?xml version="1.0"?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>

<!-- English Revision: 1745815:1788445 (outdated) -->

<!-- English Revision: 1788445 -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->

    </dl>

</section>

<directivesynopsis>

<name>ProxyFCGIBackendType</name>

<description>Spécifie le type de l'application FastCGI d'arrière-plan</description>

<syntax>ProxyFCGIBackendType FPM|GENERIC</syntax>

<default>ProxyFCGIBackendType FPM</default>

<contextlist><context>server config</context>

<context>virtual host</context><context>directory</context>

<context>.htaccess</context></contextlist>

<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

d'arrière-plan. Certains serveurs FastCGI, comme PHP-FPM, utilisent de manière

historique des variables d'environnement exotiques pour identifier le type du

serveur mandataire utilisé. Définissez cette directive à "GENERIC" si votre

application n'est pas de type PHP-FPM et n'interpréter pas correctement des

variables d'environnement comme SCRIPT_FILENAME ou PATH_TRANSLATED telles

qu'elles sont définies par le serveur.</p>

<p>SCRIPT_FILENAME est un exemple de valeur modifiée par la définition de cette

directive. Historiquement, lorsqu'on utilisait le module

<module>mod_proxy_fcgi</module>, SCRIPT_FILENAME était préfixé par la chaîne

"proxy:fcgi://". C'est cette variable que lisent certaines applications FastCGI

génériques en tant que valeur en entrée pour leur script ; cependant, PHP-FPM

peut supprimer le préfixe, puis garder en mémoire qu'il communique avec Apache.

Avec les versions 2.4.21 à 2.4.25, ce préfixe était automatiquement supprimé par

le serveur, empêchant ainsi PHP-FPM de détecter et interopérer avec Apache dans

certains scénarios.</p> 

</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>

<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

&mdash; 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>

<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->

<!-- English Revision: 1786895:1787736 (outdated) -->

<!-- English Revision: 1787736 -->

<!--

 Licensed to the Apache Software Foundation (ASF) under one or more

l'intérieur des sections <directive type="section"

module="core">Directory</directive>, <directive type="section"

module="core">Location</directive> et <directive type="section"

module="core">Files</directive>. Les valeurs des expressions

module="core">Files</directive> (mais pas à l'intérieur d'une autre section

<directive type="section" module="core">If</directive>). Les valeurs des

expressions

rationnelles correspondant aux sections nommées se comportent de manière

identique.</p>