summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLucien Gentis <lgentis@apache.org>2017-02-11 17:36:33 +0100
committerLucien Gentis <lgentis@apache.org>2017-02-11 17:36:33 +0100
commit240dd20a51268ac93057142ea4f2f7fd9874014c (patch)
treeeb0e90a52aede8664a943a4d4423b0830af4e8a9
parentdocs: add more notes on ProxyFCGISetEnvIf (diff)
downloadapache2-240dd20a51268ac93057142ea4f2f7fd9874014c.tar.xz
apache2-240dd20a51268ac93057142ea4f2f7fd9874014c.zip
XML updates.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1782616 13f79535-47bb-0310-9956-ffa450edef68
-rw-r--r--docs/manual/mod/core.xml.fr14
-rw-r--r--docs/manual/mod/mod_proxy.xml.fr2
-rw-r--r--docs/manual/mod/mod_proxy_fcgi.xml.fr50
-rw-r--r--docs/manual/mod/mod_remoteip.xml.fr3
-rw-r--r--docs/manual/mod/mod_setenvif.xml.fr4
-rw-r--r--docs/manual/vhosts/examples.xml.fr20
6 files changed, 72 insertions, 21 deletions
diff --git a/docs/manual/mod/core.xml.fr b/docs/manual/mod/core.xml.fr
index 2f157b2148..6234a467b0 100644
--- a/docs/manual/mod/core.xml.fr
+++ b/docs/manual/mod/core.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: 1780918:1782140 (outdated) -->
+<!-- English Revision: 1782140 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -1369,7 +1369,7 @@ host</context>
<directivesynopsis>
<name>HttpProtocolOptions</name>
-<description>Modifie les contraintes sur les messages des requêtes HTTP</description>
+<description>Modifie les contraintes sur le format des requêtes HTTP</description>
<syntax>HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods]
[Allow0.9|Require1.0]</syntax>
<default>HttpProtocolOptions Strict LenientMethods Allow0.9</default>
@@ -1434,6 +1434,16 @@ Apache</compatibility>
# Missing CRLF<br />
GET / HTTP/1.0\n\n
</example>
+ <note type="warning"><title>Utilitaires en ligne de commande et CRLF</title>
+ <p>Il peut s'avérer nécessaire de forcer certains utilitaires à utiliser
+ CRLF ; si ce n'est pas le cas, httpd reverra une réponse HTTP 400 comme
+ dans le cas précédent. Par exemple, le <strong>client OpenSSL s_client
+ doit utiliser le paramètre -crlf pour fonctionner correctement</strong>.</p>
+ <p>Pour détecter des problèmes tels que l'absence de CRLF, vous pouvez
+ utiliser la directive <directive
+ module="mod_dumpio">DumpIOInput</directive> qui permet de décortiquer
+ les requêtes HTTP.</p>
+ </note>
</dd>
<dt>RegisteredMethods|LenientMethods</dt>
<dd>
diff --git a/docs/manual/mod/mod_proxy.xml.fr b/docs/manual/mod/mod_proxy.xml.fr
index dbb590e11b..cbec4a3f0d 100644
--- a/docs/manual/mod/mod_proxy.xml.fr
+++ b/docs/manual/mod/mod_proxy.xml.fr
@@ -454,7 +454,7 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10
</highlight>
<p>La définition de la variable d'environnement "no-proxy" permet de
- désactiver le traitement par <module>mod_proxy</module> de la requête
+ désactiver <module>mod_proxy</module> dans le traitement de la requête
courante. Cette variable doit être définie via la directive <directive
module="mod_setenvif">SetEnvIf</directive> car la directive <directive
module="mod_env">SetEnv</directive> n'est pas évaluée assez tôt.</p>
diff --git a/docs/manual/mod/mod_proxy_fcgi.xml.fr b/docs/manual/mod/mod_proxy_fcgi.xml.fr
index 627deb31a5..df04797ff9 100644
--- 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:1782194 (outdated) -->
+<!-- English Revision: 1782538 -->
<!-- French translation : Lucien GENTIS -->
<!--
@@ -246,8 +246,8 @@ 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>
@@ -283,26 +283,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>
diff --git a/docs/manual/mod/mod_remoteip.xml.fr b/docs/manual/mod/mod_remoteip.xml.fr
index f476b355e8..c27d8f4d95 100644
--- a/docs/manual/mod/mod_remoteip.xml.fr
+++ b/docs/manual/mod/mod_remoteip.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: 1776624:1781701 (outdated) -->
+<!-- English Revision: 1781701 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -258,6 +258,7 @@ RemoteIPProxiesHeader X-Forwarded-By
<syntax>RemoteIPProxyProtocol On|Optional|Off</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
+<compatibility>Disponible à partir de la version 2.4.26 du serveur HTTP Apache</compatibility>
<usage>
<p>La directive <directive>RemoteIPProxyProtocol</directive> permet
diff --git a/docs/manual/mod/mod_setenvif.xml.fr b/docs/manual/mod/mod_setenvif.xml.fr
index 7f4db67403..027feaf67f 100644
--- a/docs/manual/mod/mod_setenvif.xml.fr
+++ b/docs/manual/mod/mod_setenvif.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: 1727647:1782252 (outdated) -->
+<!-- English Revision: 1782252 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -151,7 +151,7 @@ attributs de la requête</description>
<p>La directive <directive>SetEnvIf</directive> permet de définir
des variables d'environnement en fonction des attributs de la
requête. L'<em>attribut</em> spécifié comme premier argument peut
- se présenter sous l'une des trois formes suivantes :</p>
+ se présenter sous l'une des formes suivantes :</p>
<ol>
<li>Un champ d'en-tête de requête HTTP (voir la <a
diff --git a/docs/manual/vhosts/examples.xml.fr b/docs/manual/vhosts/examples.xml.fr
index 7d6551cd15..f33560e058 100644
--- a/docs/manual/vhosts/examples.xml.fr
+++ b/docs/manual/vhosts/examples.xml.fr
@@ -1,7 +1,7 @@
<?xml version='1.0' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1746754:1781930 (outdated) -->
+<!-- English Revision: 1781930 -->
<!-- French translation by Vincent Deffontaines, Alain B. -->
<!-- reviewed by Lucien Gentis -->
@@ -29,12 +29,26 @@
<summary>
<p>Le but de ce document est d'essayer de répondre aux questions
- les plus répandues sur la configuration des <a href="index.html">serveurs virtuels</a>.
+ les plus fréquentes sur la configuration des <a href="index.html">serveurs virtuels</a>.
Les scénarios présentés ici se rencontrent quand plusieurs
- serveurs Webs doivent tourner sur une seule et même machine au
+ serveurs web doivent tourner sur une seule et même machine au
moyen de serveurs virtuels <a href="name-based.html">par nom</a>
ou <a href="ip-based.html">par IP</a>.</p>
+ <note><title>Note à propos du contexte de configuration</title><p>Les serveurs virtuels
+ doivent être spécifiés au niveau de la configuration globale du serveur.
+ Certaines distributions tierces du serveur peuvent cependant utiliser un fichier de
+ configuration initial alternatif ou des fichiers de configuration multiples
+ qui acceptent tous des directives à portée globale. Elles peuvent aussi
+ proposer une convention de spécification des serveurs virtuels au sein de
+ ces fichiers multiples qui seront eux-mêmes inclus dans le fichier de
+ configuration global via la directive <directive
+ module="core">Include</directive>. Vous pourrez trouver plus de détails dans
+ le README de la distribution tierce, tel que
+ /usr/share/doc/apache2/README.Debian.gz pour les distributions basées sur
+ Debian et Ubuntu.</p>
+ </note>
+
</summary>
<section id="purename"><title>Fonctionnement de plusieurs serveurs