You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by lg...@apache.org on 2017/03/26 13:16:38 UTC
svn commit: r1788729 - in /httpd/httpd/branches/2.4.x/docs/manual:
mod/core.xml.fr mod/mod_proxy_fcgi.xml.fr sections.xml.fr
Author: lgentis
Date: Sun Mar 26 13:16:38 2017
New Revision: 1788729
URL: http://svn.apache.org/viewvc?rev=1788729&view=rev
Log:
XML updates.
Modified:
httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_fcgi.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/sections.xml.fr
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml.fr?rev=1788729&r1=1788728&r2=1788729&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml.fr [utf-8] Sun Mar 26 13:16:38 2017
@@ -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: 1782180:1787736 (outdated) -->
+<!-- English Revision: 1787736 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -2373,6 +2373,15 @@ host</context>
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
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_fcgi.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_fcgi.xml.fr?rev=1788729&r1=1788728&r2=1788729&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_fcgi.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_fcgi.xml.fr [utf-8] Sun Mar 26 13:16:38 2017
@@ -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: 1745815:1788445 (outdated) -->
+<!-- English Revision: 1788445 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -211,4 +211,126 @@ ProxyPass "/myapp/" "balancer://myappclu
</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
+— 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>
Modified: httpd/httpd/branches/2.4.x/docs/manual/sections.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/sections.xml.fr?rev=1788729&r1=1788728&r2=1788729&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/sections.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/sections.xml.fr [utf-8] Sun Mar 26 13:16:38 2017
@@ -3,7 +3,7 @@
<?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
@@ -420,7 +420,9 @@ directives <directive type="section" mod
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>