diff options
author | Lucien Gentis <lgentis@apache.org> | 2017-02-11 17:36:33 +0100 |
---|---|---|
committer | Lucien Gentis <lgentis@apache.org> | 2017-02-11 17:36:33 +0100 |
commit | 240dd20a51268ac93057142ea4f2f7fd9874014c (patch) | |
tree | eb0e90a52aede8664a943a4d4423b0830af4e8a9 | |
parent | docs: add more notes on ProxyFCGISetEnvIf (diff) | |
download | apache2-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.fr | 14 | ||||
-rw-r--r-- | docs/manual/mod/mod_proxy.xml.fr | 2 | ||||
-rw-r--r-- | docs/manual/mod/mod_proxy_fcgi.xml.fr | 50 | ||||
-rw-r--r-- | docs/manual/mod/mod_remoteip.xml.fr | 3 | ||||
-rw-r--r-- | docs/manual/mod/mod_setenvif.xml.fr | 4 | ||||
-rw-r--r-- | docs/manual/vhosts/examples.xml.fr | 20 |
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 +— 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 |