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/01/08 17:10:58 UTC
svn commit: r1777890 - in /httpd/httpd/trunk/docs/manual: mod/core.xml.fr
mod/mod_info.xml.fr mod/mod_remoteip.xml.fr mod/mod_rewrite.xml.fr
vhosts/details.xml.fr
Author: lgentis
Date: Sun Jan 8 17:10:57 2017
New Revision: 1777890
URL: http://svn.apache.org/viewvc?rev=1777890&view=rev
Log:
XML update.
Modified:
httpd/httpd/trunk/docs/manual/mod/core.xml.fr
httpd/httpd/trunk/docs/manual/mod/mod_info.xml.fr
httpd/httpd/trunk/docs/manual/mod/mod_remoteip.xml.fr
httpd/httpd/trunk/docs/manual/mod/mod_rewrite.xml.fr
httpd/httpd/trunk/docs/manual/vhosts/details.xml.fr
Modified: httpd/httpd/trunk/docs/manual/mod/core.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/core.xml.fr?rev=1777890&r1=1777889&r2=1777890&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/core.xml.fr [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/mod/core.xml.fr [utf-8] Sun Jan 8 17:10:57 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: 1769718:1777163 (outdated) -->
+<!-- English Revision: 1777163 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -843,6 +843,8 @@ DESACTIV�S � partir de la version 2.3.
Content-Type, et le destinataire devra d�terminer lui-m�me le type
de m�dium.</p>
</usage>
+<seealso><directive module="core">UnDefine</directive></seealso>
+<seealso><directive module="core">IfDefine</directive></seealso>
</directivesynopsis>
<directivesynopsis>
@@ -5078,6 +5080,8 @@ host</context></contextlist>
changements qu'elle induit sont visibles de toute directive
ult�rieure, au del� de tout bloc VirtualHost.</p>
</usage>
+<seealso><directive module="core">Define</directive></seealso>
+<seealso><directive module="core">IfDefine</directive></seealso>
</directivesynopsis>
<directivesynopsis>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_info.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_info.xml.fr?rev=1777890&r1=1777889&r2=1777890&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_info.xml.fr [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_info.xml.fr [utf-8] Sun Jan 8 17:10:57 2017
@@ -1,7 +1,7 @@
-<?xml version="1.0"?>
+<?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: 1702012:1774505 (outdated) -->
+<!-- English Revision: 1774505 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -25,7 +25,7 @@
<modulesynopsis metafile="mod_info.xml.meta">
<name>mod_info</name>
-<description>Affiche une présentation complète de la configuration du
+<description>Affiche une pr�sentation compl�te de la configuration du
serveur</description>
<status>Extension</status>
<sourcefile>mod_info.c</sourcefile>
@@ -33,7 +33,7 @@ serveur</description>
<summary>
<p>Pour activer <module>mod_info</module>, ajoutez les lignes
- suivantes à votre fichier <code>httpd.conf</code>.</p>
+ suivantes � votre fichier <code>httpd.conf</code>.</p>
<highlight language="config">
<Location "/server-info">
@@ -41,9 +41,9 @@ serveur</description>
</Location>
</highlight>
- <p>Il est recommandé d'utiliser <module>mod_authz_host</module> à
- l'intérieur de la section <directive type="section"
- module="core">Location</directive> afin de restreindre l'accès aux
+ <p>Il est recommand� d'utiliser <module>mod_authz_host</module> �
+ l'int�rieur de la section <directive type="section"
+ module="core">Location</directive> afin de restreindre l'acc�s aux
informations de configuration de votre serveur :</p>
<highlight language="config">
@@ -53,38 +53,38 @@ serveur</description>
</Location>
</highlight>
- <p>Une fois cette configuration effectuée, les informations du
- serveur sont disponibles à l'adresse
+ <p>Une fois cette configuration effectu�e, les informations du
+ serveur sont disponibles � l'adresse
<code>http://votre-serveur.com/infos-serveur</code>.</p>
</summary>
-<section id="security"><title>Problèmes liés à la sécurité</title>
- <p>Une fois <module>mod_info</module> chargé dans le serveur, sa
- fonctionnalité de gestionnaire est disponible dans <em>tous</em> les
+<section id="security"><title>Probl�mes li�s � la s�curit�</title>
+ <p>Une fois <module>mod_info</module> charg� dans le serveur, sa
+ fonctionnalit� de gestionnaire est disponible dans <em>tous</em> les
fichiers de configuration, y compris les fichiers de configuration
- des répertoires (par exemple <code>.htaccess</code>). Ceci peut
- avoir des répercutions en matière de sécurité pour votre site.</p>
+ des r�pertoires (par exemple <code>.htaccess</code>). Ceci peut
+ avoir des r�percutions en mati�re de s�curit� pour votre site.</p>
- <p>En particulier, l'utilisation de ce module peut conduire à la
- divulgation d'informations sensibles à partir des directives de
- configuration d'autres modules Apache comme des chemins systèmes,
+ <p>En particulier, l'utilisation de ce module peut conduire � la
+ divulgation d'informations sensibles � partir des directives de
+ configuration d'autres modules Apache comme des chemins syst�mes,
des couples nom d'utilisateur/mot de passe, des noms de bases de
- données, etc... C'est pourquoi ce module ne doit être utilisé
- <strong>que</strong> dans un environnement sous contrôle et toujours
- avec les plus grandes précautions.</p>
+ donn�es, etc... C'est pourquoi ce module ne doit �tre utilis�
+ <strong>que</strong> dans un environnement sous contr�le et toujours
+ avec les plus grandes pr�cautions.</p>
- <p>Il est recommandé d'utiliser <module>mod_authz_host</module> pour
- restreindre l'accès aux informations de configuration de votre
+ <p>Il est recommand� d'utiliser <module>mod_authz_host</module> pour
+ restreindre l'acc�s aux informations de configuration de votre
serveur.</p>
- <example><title>Contrôle d'accès</title>
+ <example><title>Contr�le d'acc�s</title>
<highlight language="config">
<Location "/server-info">
SetHandler server-info
- # Autorisation d'accès depuis le serveur lui-même
+ # Autorisation d'acc�s depuis le serveur lui-m�me
Require ip 127.0.0.1
- # Autorisation d'accès depuis une station de travail du réseau
+ # Autorisation d'acc�s depuis une station de travail du r�seau
# local
Require ip 192.168.1.17
</Location>
@@ -92,99 +92,107 @@ serveur</description>
</example>
</section>
-<section id="queries"><title>Filtrage des informations affichées</title>
- <p>Par défaut, les informations affichées comprennent une liste de
- tous les modules activés, et pour chaque module, une description des
+<section id="queries"><title>Filtrage des informations affich�es</title>
+ <p>Par d�faut, les informations affich�es comprennent une liste de
+ tous les modules activ�s, et pour chaque module, une description des
directives qu'il accepte, les branchements (hooks) qu'il
- implémente, ainsi que les directives concernées dans la
+ impl�mente, ainsi que les directives concern�es dans la
configuration courante.</p>
<p>Il est possible d'afficher d'autres vues de la configuration en
- ajoutant un argument à la requête <code>infos-serveur</code>. Par
+ ajoutant un argument � la requ�te <code>infos-serveur</code>. Par
exemple, <code>http://votre-serveur.com/infos-serveur?config</code>
affichera toutes les directives de configuration.</p>
<dl>
<dt><code>?<module-name></code></dt>
<dd>Uniquement les informations relatives au module
- spécifié</dd>
+ sp�cifi�</dd>
<dt><code>?config</code></dt>
- <dd>Uniquement les directives de configuration, non triées
+ <dd>Uniquement les directives de configuration, non tri�es
par module</dd>
<dt><code>?hooks</code></dt>
<dd>Uniquement la liste des branchements (hooks)
- auxquels le module est attaché</dd>
+ auxquels le module est attach�</dd>
<dt><code>?list</code></dt>
- <dd>Une simple liste des modules activés</dd>
+ <dd>Une simple liste des modules activ�s</dd>
<dt><code>?server</code></dt>
<dd>Uniquement des informations de base sur le serveur</dd>
+ <dt><code>?providers</code></dt>
+ <dd>Liste des fournisseurs disponbles pour votre serveur</dd>
</dl>
</section>
-<section id="startup"><title>Affichage de la configuration au démarrage</title>
+<section id="startup"><title>Affichage de la configuration au d�marrage</title>
<p>Si la directive de configuration define
- <code>-DDUMP_CONFIG</code> est utilisée, <module>mod_info</module> va
- envoyer la configuration préinterprétée vers <code>stdout</code> au
- cours du démarrage du serveur. "Préinterprétée" signifie que
+ <code>-DDUMP_CONFIG</code> est utilis�e, <module>mod_info</module> va
+ envoyer la configuration pr�interpr�t�e vers <code>stdout</code> au
+ cours du d�marrage du serveur.</p>
+
+ <highlight language="sh">
+ httpd -DDUMP_CONFIG -k start
+ </highlight>
+
+ <p>"Pr�interpr�t�e" signifie que
les directives telles que <directive type="section"
module="core">IfDefine</directive> et <directive type="section"
- module="core">IfModule</directive> sont évaluées et les variables
- d'environnement remplacées par leurs valeurs. Cela ne représente
- cependant pas la configuration définitive. En particulier, les
- fusions ou écrasementsde définitions en cas de directives multiples ne sont pas
- représentés.</p>
+ module="core">IfModule</directive> sont �valu�es et les variables
+ d'environnement remplac�es par leurs valeurs. Cela ne repr�sente
+ cependant pas la configuration d�finitive. En particulier, les
+ fusions ou �crasementsde d�finitions en cas de directives multiples ne sont pas
+ repr�sent�s.</p>
- <p>Le résultat est équivalent à celui de la requête
+ <p>Le r�sultat est �quivalent � celui de la requ�te
<code>?config</code>.</p>
</section>
<section id="limitations"><title>Limitations connues</title>
<p><module>mod_info</module> tire ses informations de
- la configuration interprétée, et non du fichier de configuration
- original. La manière dont l'arbre de configuration interprété est
- créé induit quelques limitations :</p>
+ la configuration interpr�t�e, et non du fichier de configuration
+ original. La mani�re dont l'arbre de configuration interpr�t� est
+ cr�� induit quelques limitations :</p>
<ul>
- <li>Les directives qui sont traitées immédiatement sans être
- enregistrées dans l'arbre de configuration interprété ne sont pas
+ <li>Les directives qui sont trait�es imm�diatement sans �tre
+ enregistr�es dans l'arbre de configuration interpr�t� ne sont pas
prises en compte. Celles-ci comprennent <directive
module="core">ServerRoot</directive>, <directive
module="mod_so">LoadModule</directive> et <directive
module="mod_so">LoadFile</directive>.</li>
- <li>Les directives qui contrôlent le fichier de configuration
- lui-même, comme <directive module="core">Include</directive>,
+ <li>Les directives qui contr�lent le fichier de configuration
+ lui-m�me, comme <directive module="core">Include</directive>,
<directive type="section" module="core">IfModule</directive> et
<directive type="section" module="core">IfDefine</directive> ne
sont pas prises en compte, mais les directives de configuration
incluses le sont.</li>
- <li>Les commentaires ne sont pas pris en compte (Ce qui peut être
- considéré comme une fonctionnalité).</li>
+ <li>Les commentaires ne sont pas pris en compte (Ce qui peut �tre
+ consid�r� comme une fonctionnalit�).</li>
<li>Les directives de configuration des fichiers
<code>.htaccess</code> ne sont pas prises en compte (car elles ne
font pas partie de la configuration permanente du serveur).</li>
<li>Les directives de conteneur comme <directive type="section"
- module="core">Directory</directive> sont affichées
+ module="core">Directory</directive> sont affich�es
normalement, mais <module>mod_info</module> est incapable de
- déterminer le numéro de ligne de la balise fermante
+ d�terminer le num�ro de ligne de la balise fermante
<directive type="section" module="core"
name="Directory">/Directory</directive>.</li>
- <li>Les directives générées par des modules tiers comme
- <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas être
+ <li>Les directives g�n�r�es par des modules tiers comme
+ <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas �tre
prises en compte.</li>
</ul>
</section>
<directivesynopsis>
<name>AddModuleInfo</name>
-<description>Ajoute des données supplémentaires aux informations de
-module affichées par le gestionnaire server-info</description>
-<syntax>AddModuleInfo <var>nom-module</var> <var>chaîne</var></syntax>
+<description>Ajoute des donn�es suppl�mentaires aux informations de
+module affich�es par le gestionnaire server-info</description>
+<syntax>AddModuleInfo <var>nom-module</var> <var>cha�ne</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
- <p>Cette directive permet d'afficher le contenu de <var>chaîne</var>
- en tant qu'<strong>Information supplémentaire</strong> interprétée
+ <p>Cette directive permet d'afficher le contenu de <var>cha�ne</var>
+ en tant qu'<strong>Information suppl�mentaire</strong> interpr�t�e
en HTML pour le module <var>nom-module</var>. Exemple :</p>
<highlight language="config">
Modified: httpd/httpd/trunk/docs/manual/mod/mod_remoteip.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_remoteip.xml.fr?rev=1777890&r1=1777889&r2=1777890&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_remoteip.xml.fr [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_remoteip.xml.fr [utf-8] Sun Jan 8 17:10:57 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: 1704683:1776624 (outdated) -->
+<!-- English Revision: 1776624 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -46,6 +46,11 @@ r�partiteur de charge via les en-t�tes
l'en-t�te de requ�te configur� via la directive
<directive module="mod_remoteip">RemoteIPHeader</directive>.</p>
+ <p>En outre, ce module impl�mente la partie serveur du <a
+ href="http://blog.haproxy.com/haproxy/proxy-protocol/">protocole PROXY</a>
+ de HAProxy lorsqu'on utilise la directive <directive
+ module="mod_remoteip">RemoteIPProxyProtocol</directive>.</p>
+
<p>Une fois sa valeur modifi�e comme indiqu�, cette adresse IP client est
utilis�e pour la fonctionnalit� <directive
module="mod_authz_host" name="Require">Require ip</directive> de
@@ -66,6 +71,7 @@ r�partiteur de charge via les en-t�tes
<seealso><module>mod_authz_host</module></seealso>
<seealso><module>mod_status</module></seealso>
<seealso><module>mod_log_config</module></seealso>
+<seealso><a href="http://www.haproxy.org/download/1.5/doc/proxy-protocol.txt">Proxy Protocol Spec</a></seealso>
<section id="processing"><title>Traitement des adresses distantes</title>
@@ -246,6 +252,75 @@ RemoteIPProxiesHeader X-Forwarded-By
</usage>
</directivesynopsis>
+<directivesynopsis>
+<name>RemoteIPProxyProtocol</name>
+<description>Active ou d�sactive la gestion du protocole PROXY</description>
+<syntax>RemoteIPProxyProtocol On|Optional|Off</syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+</contextlist>
+
+<usage>
+ <p>La directive <directive>RemoteIPProxyProtocol</directive> permet
+ d'activer ou de d�sactiver la prise en compte et la gestion de l'en-t�te de
+ connexion du protocole PROXY. Si elle est d�finie � <code>On</code>, la
+ demande du client <em>doit</em> envoyer l'en-t�te appropri� pour chaque
+ nouvelle connexion, sinon cette derni�re sera ferm�e. Si elle est d�finie �
+ <code>Optional</code>, la demande du client <em>peut</em> envoyer l'en-t�te
+ appropri�, mais ce n'est pas obligatoire.</p>
+
+ <p>Bien que cette directive peut �tre d�finie au niveau de n'importe quel
+ serveur virtuel, il est important de garder � l'esprit que, �tant donn� que
+ le protocole PROXY est bas� sur la connexion et agnostique quant au
+ protocle, son activation/d�sactivation est bas�e sur le couple adresse
+ IP/port. Cela signifie que si plusieurs serveurs virtuels � base de nom sont
+ configur�s avec le m�me couple adresse IP/port, et si vous activez le
+ protocole PROXY pour l'un d'entre eux, il le sera aussi pour tous les autres
+ (avec le m�me couple adresse IP/port). Cela signifie aussi que si vous
+ tentez d'activer le protocole PROXY pour un serveur virtuel et de le
+ d�sactiver pour un autre, cela ne marchera pas ; dans ce dernier cas, la
+ derni�re directive l'emporte sur les autres et une notification sera
+ enregistr�e dans le journal pour indiquer les r�glages qui ont �t� annul�s.</p>
+
+ <note type="hint">Lorsque plusieurs serveurs virtuels avec le m�me couple
+ adresse IP/port sont configur�s avec une combinaison de drapeaux
+ <code>On</code> et <code>Optional</code>, les connexions ne seront pas
+ ferm�es si l'en-t�te appropri� n'est pas envoy�. L'activation interviendra
+ alors apr�s la lecture de la requ�te si bien que les serveurs virtuels
+ configur�s avec le drapeau <code>On</code> renverront une erreur 400 Bad
+ Request. Les serveurs virtuels configur�s avec le drapeau
+ <code>Optional</code> quant � eux continueront de fonctionner de mani�re
+ habituelle mais sans remplacer les informations IP du client.</note>
+
+ <highlight language="config">
+Listen 80
+<VirtualHost *:80>
+ ServerName www.example.com
+ RemoteIPProxyProtocol Optional
+
+ #Les requ�tes pour ce serveur virtuel ne doivent pas obligatoirement
+ #contenir d'en-t�te du protocole PROXY
+</VirtualHost>
+
+<VirtualHost *:80>
+ ServerName www.example.com
+ RemoteIPProxyProtocol On
+
+ #Les requ�tes pour ce serveur virtuel doivent contenir un en-t�te du
+ #protocole PROXY. Si ce n'est pas le cas, une erreur 400 sera renvoy�e
+</VirtualHost>
+
+Listen 8080
+<VirtualHost *:8080>
+ ServerName www.example.com
+ RemoteIPProxyProtocol On
+
+ #Les requ�tes pour ce serveur virtuel doivent contenir un en-t�te du
+ #protocole PROXY. Si ce n'est pas le cas, la connexion sera ferm�e
+</VirtualHost>
+ </highlight>
+</usage>
+</directivesynopsis>
+
<directivesynopsis>
<name>RemoteIPTrustedProxy</name>
<description>Restreint les adresses IP clients dignes de
Modified: httpd/httpd/trunk/docs/manual/mod/mod_rewrite.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_rewrite.xml.fr?rev=1777890&r1=1777889&r2=1777890&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_rewrite.xml.fr [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_rewrite.xml.fr [utf-8] Sun Jan 8 17:10:57 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: 1760590:1776708 (outdated) -->
+<!-- English Revision: 1776708 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -309,6 +309,26 @@ pour le moteur de r��criture</descript
version 2.4.16 du serveur HTTP Apache.</p>
</dd>
+ <dt><code>LegacyPrefixDocRoot</code></dt>
+ <dd>
+
+ <p>Avant la version 2.4.26, si une substitution �tait une URL absolue qui
+ correspondait au serveur virtuel courant, l'URL pouvait �tre tout d'abord
+ r�duite � sa partie chemin, puis enfin en chemin local. Comme l'URL peut
+ �tre r�duite en chemin local, le chemin doit �tre pr�fix� par la
+ valeur de la directive DocumentRoot, ce qui permet d'interdire l'acc�s �
+ un fichier tel que /tmp/myfile suite � une requ�te pour
+ http://host/file/myfile avec la <directive
+ module="mod_rewrite">RewriteRule</directive> suivante :</p>
+ <highlight language="config">
+ RewriteRule /file/(.*) http://localhost/tmp/$1
+ </highlight>
+ <p>Cette option permet de restaurer l'ancien comportement lorsqu'un chemin
+ local obtenu � partir de la r�duction d'une URL n'est pas pr�fix� par la
+ valeur de la directive DocumentRoot. Disponible � partir de la version
+ 2.4.26 du serveur HTTP Apache.</p>
+ </dd>
+
</dl>
</usage>
Modified: httpd/httpd/trunk/docs/manual/vhosts/details.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/vhosts/details.xml.fr?rev=1777890&r1=1777889&r2=1777890&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/vhosts/details.xml.fr [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/vhosts/details.xml.fr [utf-8] Sun Jan 8 17:10:57 2017
@@ -1,7 +1,7 @@
-<?xml version='1.0' ?>
+<?xml version='1.0' encoding="UTF-8"?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1673947:1777061 (outdated) -->
+<!-- English Revision: 1777061 -->
<!-- French translation by Vincent Deffontaines, review by alain B -->
<!-- Updated by Lucien Gentis -->