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 2018/01/04 16:51:04 UTC
svn commit: r1820127 - in /httpd/httpd/branches/2.4.x/docs/manual:
mod/core.xml.fr mod/mod_ext_filter.xml.fr mod/mod_filter.xml.fr
mod/mod_sed.xml.fr mod/mod_substitute.xml.fr upgrading.xml.fr
vhosts/mass.xml.fr
Author: lgentis
Date: Thu Jan 4 16:51:04 2018
New Revision: 1820127
URL: http://svn.apache.org/viewvc?rev=1820127&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_ext_filter.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_filter.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_sed.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_substitute.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/upgrading.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/vhosts/mass.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=1820127&r1=1820126&r2=1820127&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] Thu Jan 4 16:51:04 2018
@@ -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: 1807765:1818964 (outdated) -->
+<!-- English Revision: 1818964 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -2613,20 +2613,21 @@ Include conf/vhosts/*.conf
<name>IncludeOptional</name>
<description>Inclusion de fichiers dans le fichier de configuration</description>
<syntax>IncludeOptional
-<var>chemin-fichier</var>|<var>chemin-répertoire</var>|<var>wildcard</var></syntax>
+<var>file-path</var>|<var>directory-path</var>|<var>wildcard</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context>
</contextlist>
<compatibility>Disponible à partir de la version 2.3.6 du serveur HTTP
-Apache</compatibility>
+Apache. Après la version 2.4.30, les chemins de fichiers non existants et
+ne comportant pas de caractères génériques ne génèrent plus d'erreurs de syntaxe</compatibility>
<usage>
<p>Cette directive permet d'inclure des fichiers dans les fichiers
de configuration du serveur. Elle fonctionne de manière identique à
- la directive <directive module="core">Include</directive>, à
- l'exception du fait que si l'expression avec caractères génériques
- wilcard ne correspond à aucun fichier ou répertoire, elle sera
- ignorée silencieusement au lieu de causer une erreur.</p>
+ la directive <directive module="core">Include</directive>, mais au lieu de
+ générer une erreur, elle sera ignorée silensieusement si malgré
+ l'utilisation de caractères génériques, le chemin de fichier ou de
+ répertoire spécifié n'existe pas dans le système de fichiers.</p>
</usage>
@@ -5329,14 +5330,15 @@ comme si la directive QualifyRedirectURL
<contextlist><context>server config</context></contextlist>
<usage>
-<p>Normalement, les méthodes HTTP non conformes aux RFCs correspondantes
-sont rejetées au cours du traitement de la requête par HTTPD. Pour
-éviter ceci, les modules peuvent enregistrer les méthodes HTTP non
-standards qu'ils supportent. La directive
-<directive>RegisterHttpMethod</directive> permet d'enregistrer de telles
-méthodes manuellement. Ceci peut s'avérer utile si de telle méthodes
-doivent être utilisées dans un traitement externe, comme un script CGI.</p>
+<p>Cette directive permet d'enregistrer des méthodes HTTP supplémentaires. Ceci
+s'avérera nécessaire si l'on doit utiliser des méthodes non standards avec des
+directives qui acceptent des noms de méthodes en paramètres, ou pour permettre
+l'utilisation de méthodes particulières non standards en passant par un serveur
+mandataire ou au sein de scripts CGI, et ceci alors que le serveur a été
+configuré pour ne transmettre que des méthodes reconnues aux modules.</p>
</usage>
+<seealso><directive module="core">HTTPProtocolOptions</directive></seealso>
+<seealso><directive module="mod_allowmethods">AllowMethods</directive></seealso>
</directivesynopsis>
</modulesynopsis>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ext_filter.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ext_filter.xml.fr?rev=1820127&r1=1820126&r2=1820127&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ext_filter.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ext_filter.xml.fr [utf-8] Thu Jan 4 16:51:04 2018
@@ -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: 1673563:1818953 (outdated) -->
+<!-- English Revision: 1818953 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -25,35 +25,35 @@
<modulesynopsis metafile="mod_ext_filter.xml.meta">
<name>mod_ext_filter</name>
-<description>Fait traiter le corps de la réponse par un programme
+<description>Fait traiter le corps de la réponse par un programme
externe avant de l'envoyer au client</description>
<status>Extension</status>
<sourcefile>mod_ext_filter.c</sourcefile>
<identifier>ext_filter_module</identifier>
<summary>
- <p><module>mod_ext_filter</module> représente un modèle de
+ <p><module>mod_ext_filter</module> représente un modèle de
programmation simple et bien connu pour les <a
href="../filter.html">filtres</a>. Avec ce module, tout programme
- qui lit l'entrée standard stdin et écrit sur la sortie standard
+ qui lit l'entrée standard stdin et écrit sur la sortie standard
stdout (autrement dit une commande filtre de style Unix) peut
- servir de filtre pour Apache. Ce mécanisme de filtrage est beaucoup
- plus lent qu'un filtre spécialement écrit pour
- l'API d'Apache et faisant partie intégrante du processus du serveur
- Apache, mais il présente les avantages suivants :</p>
+ servir de filtre pour Apache. Ce mécanisme de filtrage est beaucoup
+ plus lent qu'un filtre spécialement écrit pour
+ l'API d'Apache et faisant partie intégrante du processus du serveur
+ Apache, mais il présente les avantages suivants :</p>
<ul>
- <li>le modèle de programmation est beaucoup plus simple</li>
+ <li>le modèle de programmation est beaucoup plus simple</li>
- <li>tout langage de script ou de programmation peut être utilisé,
- pourvu qu'il permette au programme de lire l'entrée standard et
- d'écrire sur la sortie standard.</li>
+ <li>tout langage de script ou de programmation peut être utilisé,
+ pourvu qu'il permette au programme de lire l'entrée standard et
+ d'écrire sur la sortie standard.</li>
<li>on peut utiliser des programmes existants comme filtres Apache
sans modification.</li>
</ul>
- <p>Même dans le cas où le niveau de performance est insuffisant pour
+ <p>Même dans le cas où le niveau de performance est insuffisant pour
une utilisation en production, on peut utiliser
<module>mod_ext_filter</module> comme prototype d'environnement pour
les filtres.</p>
@@ -63,39 +63,39 @@ externe avant de l'envoyer au client</de
<section id="examples"><title>Exemples</title>
- <section><title>Générer du HTML à partir d'un autre type de
+ <section><title>Générer du HTML à partir d'un autre type de
contenu</title>
<highlight language="config">
-# la directive de mod_ext_filter définissant un filtre
+# la directive de mod_ext_filter définissant un filtre
# permettant de mettre des fichiers text/c au format HTML en
# utilisant le programme externe /usr/bin/enscript, le type du
-# fichier résultant étant défini à text/html
+# fichier résultant étant défini à text/html
ExtFilterDefine c-to-html mode=output \
intype=text/c outtype=text/html \
- cmd="/usr/bin/enscript --color -W html -Ec -o - -"
+ cmd="/usr/bin/enscript --color -w html -Ec -o -"
<Directory "/export/home/trawick/apacheinst/htdocs/c">
# directive de base permettant de traiter la sortie avec le
# nouveau filtre
SetOutputFilter c-to-html
- # directive de mod_mime définissant le type des fichiers dont
- # le nom possède l'extension .c à text/c
+ # directive de mod_mime définissant le type des fichiers dont
+ # le nom possède l'extension .c à text/c
AddType text/c .c
</Directory>
</highlight>
</section>
- <section><title>Implémentation d'un filtre de codage de
+ <section><title>Implémentation d'un filtre de codage de
contenu</title>
- <p>Note : cet exemple avec gzip n'est fourni qu'à titre
- d'illustration. Veuillez vous reporter à la documentation de
- <module>mod_deflate</module> pour un exemple d'implémentation plus
+ <p>Note : cet exemple avec gzip n'est fourni qu'à titre
+ d'illustration. Veuillez vous reporter à la documentation de
+ <module>mod_deflate</module> pour un exemple d'implémentation plus
pratique.</p>
<highlight language="config">
-# la directive de mod_ext_filter qui définit le filtre externe
+# la directive de mod_ext_filter qui définit le filtre externe
ExtFilterDefine gzip mode=output cmd=/bin/gzip
<Location "/gzipped">
@@ -105,7 +105,7 @@ ExtFilterDefine gzip mode=output cmd=/bi
SetOutputFilter gzip
# la directive de mod_headers permettant d'ajouter le champ
- # d'en-tête "Content-Encoding: gzip"
+ # d'en-tête "Content-Encoding: gzip"
Header set Content-Encoding gzip
</Location>
</highlight>
@@ -114,10 +114,10 @@ ExtFilterDefine gzip mode=output cmd=/bi
<section><title>Ralentissement du serveur</title>
<highlight language="config">
-# directive de mod_ext_filter définissant un filtre qui fait
+# directive de mod_ext_filter définissant un filtre qui fait
# passer tous les flux en sortie par la commande cat ; cat ne
# modifie rien ; elle ne fait que compliquer le cheminement des
-# flux et consommer des ressources supplémentaires
+# flux et consommer des ressources supplémentaires
ExtFilterDefine slowdown mode=output cmd=/bin/cat \
ExtFilterDefine slowdown mode=output cmd=/bin/cat \
preservescontentlength
@@ -132,11 +132,11 @@ ExtFilterDefine slowdown mode=output cmd
</section>
<section><title>Utilisation de sed pour remplacer du texte dans la
- réponse</title>
+ réponse</title>
<highlight language="config">
-# directive de mod_ext_filter définissant un filtre qui
-# remplace du texte dans la réponse
+# directive de mod_ext_filter définissant un filtre qui
+# remplace du texte dans la réponse
#
ExtFilterDefine fixtext mode=output intype=text/html \
cmd="/bin/sed s/verdana/arial/g"
@@ -150,7 +150,7 @@ ExtFilterDefine fixtext mode=output inty
<note>
<p>Vous pouvez aussi utiliser <module>mod_substitute</module> pour
-effectuer le même traitement sans avoir à invoquer un programme
+effectuer le même traitement sans avoir à invoquer un programme
externe.</p>
</note>
@@ -158,8 +158,8 @@ externe.</p>
<section><title>Tracer un autre filtre</title>
<highlight language="config">
-# Trace les données lues et écrites par mod_deflate pour un
-# client particulier (IP 192.168.1.31) qui a des problèmes de
+# Trace les données lues et écrites par mod_deflate pour un
+# client particulier (IP 192.168.1.31) qui a des problèmes de
# compression.
# Ce premier filtre va tracer ce qui entre dans mod_deflate.
ExtFilterDefine tracebefore \
@@ -167,12 +167,12 @@ ExtFilterDefine tracebefore \
EnableEnv=trace_this_client
# Ce second filtre va tracer ce qui sort de mod_deflate.
-# Notez que sans le paramètre ftype, le type de filtre par
-# défaut AP_FTYPE_RESOURCE placerait le filtre *avant*
-# mod_deflate dans la chaîne de filtrage. Le fait d'affecter
-# à ce paramètre une valeur numérique sensiblement supérieure à
+# Notez que sans le paramètre ftype, le type de filtre par
+# défaut AP_FTYPE_RESOURCE placerait le filtre *avant*
+# mod_deflate dans la chaîne de filtrage. Le fait d'affecter
+# à ce paramètre une valeur numérique sensiblement supérieure à
# AP_FTYPE_CONTENT_SET permet de s'assurer que le filtre sera
-# placé après mod_deflate.
+# placé après mod_deflate.
ExtFilterDefine traceafter \
cmd="/bin/tracefilter.pl /tmp/traceafter" \
EnableEnv=trace_this_client ftype=21
@@ -183,7 +183,7 @@ ExtFilterDefine traceafter \
</Directory>
</highlight>
- <example><title>Voici le filtre qui trace les données :</title>
+ <example><title>Voici le filtre qui trace les données :</title>
<highlight language="perl">
#!/usr/local/bin/perl -w
use strict;
@@ -204,100 +204,100 @@ close(SAVE);
<directivesynopsis>
<name>ExtFilterDefine</name>
-<description>Définit un filtre externe</description>
-<syntax>ExtFilterDefine <var>nom_filtre</var> <var>paramètres</var></syntax>
+<description>Définit un filtre externe</description>
+<syntax>ExtFilterDefine <var>nom_filtre</var> <var>paramètres</var></syntax>
<contextlist><context>server config</context></contextlist>
<usage>
<p>La directive <directive>ExtFilterDefine</directive>
- définit les caractéristiques d'un filtre externe, et en particulier
- le programme à exécuter ainsi que ses arguments.</p>
+ définit les caractéristiques d'un filtre externe, et en particulier
+ le programme à exécuter ainsi que ses arguments.</p>
- <p><var>nom_filtre</var> spécifie le nom du filtre en cours de
- définition. On peut ensuite utiliser ce nom pour référencer le
+ <p><var>nom_filtre</var> spécifie le nom du filtre en cours de
+ définition. On peut ensuite utiliser ce nom pour référencer le
filtre dans les directives <directive module="core"
- >SetOutputFilter</directive>. Il doit être unique parmi les noms de
- tous les filtres enregistrés. <em>Pour le moment, aucune erreur
- n'est signalée par l'API register-filter, si bien qu'un problème de
- noms dupliqués ne sera pas porté à la connaissance de
+ >SetOutputFilter</directive>. Il doit être unique parmi les noms de
+ tous les filtres enregistrés. <em>Pour le moment, aucune erreur
+ n'est signalée par l'API register-filter, si bien qu'un problème de
+ noms dupliqués ne sera pas porté à la connaissance de
l'utilisateur.</em></p>
- <p>Viennent ensuite un ou plusieurs paramètres dans un ordre
- indéfini, qui permettent de spécifier la commande externe à exécuter
- et certaines autres caractéristiques. Le seul paramètre obligatoire
- est <code>cmd=</code>. Voici la liste de ces paramètres :</p>
+ <p>Viennent ensuite un ou plusieurs paramètres dans un ordre
+ indéfini, qui permettent de spécifier la commande externe à exécuter
+ et certaines autres caractéristiques. Le seul paramètre obligatoire
+ est <code>cmd=</code>. Voici la liste de ces paramètres :</p>
<dl>
<dt><code>cmd=<var>ligne de commande</var></code></dt>
- <dd>Le mot-clé <code>cmd=</code> spécifie la commande
- externe à exécuter. Si la ligne de commande comporte des
- arguments, elle doit être entourée de guillemets (par exemple
+ <dd>Le mot-clé <code>cmd=</code> spécifie la commande
+ externe à exécuter. Si la ligne de commande comporte des
+ arguments, elle doit être entourée de guillemets (par exemple
<code>cmd="<var>/bin/mypgm</var> <var>arg1</var>
<var>arg2</var>"</code>). Les guillemets habituels du shell ne
- sont pas nécessaires car le programme est lancé directement, sans
- passer par le shell. Les arguments du programme doivent être
- séparés par des espaces. Si un argument contient des espaces, ces
- derniers doivent être échappés par un antislash '\'. Si un
- argument contient des antislashes '\', ces derniers doivent être
- eux-mêmes échappés par un antislash '\'. Outre les variables
+ sont pas nécessaires car le programme est lancé directement, sans
+ passer par le shell. Les arguments du programme doivent être
+ séparés par des espaces. Si un argument contient des espaces, ces
+ derniers doivent être échappés par un antislash '\'. Si un
+ argument contient des antislashes '\', ces derniers doivent être
+ eux-mêmes échappés par un antislash '\'. Outre les variables
d'environnement CGI standards, les variables DOCUMENT_URI,
- DOCUMENT_PATH_INFO, et QUERY_STRING_UNESCAPED seront également
- définies pour le programme.</dd>
+ DOCUMENT_PATH_INFO, et QUERY_STRING_UNESCAPED seront également
+ définies pour le programme.</dd>
<dt><code>mode=<var>mode</var></code></dt>
- <dd>Utilisez <code>mode=output</code> (valeur par défaut) pour les
- filtres qui traitent les réponses. Utilisez
+ <dd>Utilisez <code>mode=output</code> (valeur par défaut) pour les
+ filtres qui traitent les réponses. Utilisez
<code>mode=input</code> pour les filtres qui traitent les
- requêtes. <code>mode=input</code> est disponible depuis la version
+ requêtes. <code>mode=input</code> est disponible depuis la version
2.1 d'Apache.</dd>
<dt><code>intype=<var>type MIME</var></code></dt>
- <dd>Ce paramètre spécifie le type de médium Internet
- (c'est à dire le type MIME) des documents qui doivent être
- filtrés. Par défaut, tous les documents sont filtrés. Aucun des
- documents possédant un type MIME autre que celui spécifié par
- <code>intype=</code> ne sera filtré.</dd>
+ <dd>Ce paramètre spécifie le type de médium Internet
+ (c'est à dire le type MIME) des documents qui doivent être
+ filtrés. Par défaut, tous les documents sont filtrés. Aucun des
+ documents possédant un type MIME autre que celui spécifié par
+ <code>intype=</code> ne sera filtré.</dd>
<dt><code>outtype=<var>type MIME</var></code></dt>
- <dd>Ce paramètre spécifie le type de médium Internet
- (c'est à dire le type MIME) des documents filtrés. Il intervient
- lorsque les opérations de filtrage comprennent une modification du
- type MIME. Par défaut, le type MIME n'est pas modifié.</dd>
+ <dd>Ce paramètre spécifie le type de médium Internet
+ (c'est à dire le type MIME) des documents filtrés. Il intervient
+ lorsque les opérations de filtrage comprennent une modification du
+ type MIME. Par défaut, le type MIME n'est pas modifié.</dd>
<dt><code>PreservesContentLength</code></dt>
- <dd>Le mot-clé <code>PreservesContentLength</code> indique que le
+ <dd>Le mot-clé <code>PreservesContentLength</code> indique que le
filtre doit conserver la taille du contenu. Ce n'est pas le
- comportement par défaut, car la plupart des filtres modifient cette
- taille. Ce mot-clé doit être spécifié si le filtre ne doit pas
+ comportement par défaut, car la plupart des filtres modifient cette
+ taille. Ce mot-clé doit être spécifié si le filtre ne doit pas
modifier la taille du contenu.</dd>
<dt><code>ftype=<var>type de filtre</var></code></dt>
- <dd>Ce paramètre spécifie une valeur numérique
- représentant le type de filtre sous lequel le filtre doit être
- enregistré. La valeur par défaut, AP_FTYPE_RESOURCE, convient dans
- la plupart des situations. Ce paramètre devient nécessaire dès lors
- que le filtre doit opérer à un autre point de la chaîne de filtrage
+ <dd>Ce paramètre spécifie une valeur numérique
+ représentant le type de filtre sous lequel le filtre doit être
+ enregistré. La valeur par défaut, AP_FTYPE_RESOURCE, convient dans
+ la plupart des situations. Ce paramètre devient nécessaire dès lors
+ que le filtre doit opérer à un autre point de la chaîne de filtrage
que les filtres de ressources.
- Voir les définitions de AP_FTYPE_...
- dans util_filter.h pour trouver une valeur appropriée.</dd>
+ Voir les définitions de AP_FTYPE_...
+ dans util_filter.h pour trouver une valeur appropriée.</dd>
<dt><code>disableenv=<var>env</var></code></dt>
- <dd>Ce paramètre spécifie le nom d'une variable
- d'environnement qui, si elle est définie, va désactiver le
+ <dd>Ce paramètre spécifie le nom d'une variable
+ d'environnement qui, si elle est définie, va désactiver le
filtre.</dd>
<dt><code>enableenv=<var>env</var></code></dt>
- <dd>Ce paramètre spécifie le nom d'une variable
- d'environnement qui doit être définie pour que le filtre ne soit
- pas désactivé.</dd>
+ <dd>Ce paramètre spécifie le nom d'une variable
+ d'environnement qui doit être définie pour que le filtre ne soit
+ pas désactivé.</dd>
</dl>
</usage>
</directivesynopsis>
@@ -312,24 +312,24 @@ close(SAVE);
<usage>
<p>La directive <directive>ExtFilterOptions</directive>
- spécifie des options de traitement particulières pour
+ spécifie des options de traitement particulières pour
<module>mod_ext_filter</module>. Les arguments <var>option</var>
peuvent contenir :</p>
<dl>
<dt><code>LogStderr | NoLogStderr</code></dt>
- <dd>Le mot-clé <code>LogStderr</code> indique que les messages
- envoyés par le programme de filtrage externe sur la sortie
- d'erreurs standard doivent être enregistrés dans le journal des
+ <dd>Le mot-clé <code>LogStderr</code> indique que les messages
+ envoyés par le programme de filtrage externe sur la sortie
+ d'erreurs standard doivent être enregistrés dans le journal des
erreurs d'Apache. <code>NoLogStderr</code> inverse ce
comportement.</dd>
<dt><code>Onfail=[abort|remove]</code></dt>
- <dd>Indique la marche à suivre si le programme de filtrage externe
- ne peut pas démarrer. Avec <code>abort</code> (la valeur par
- défaut), le traitement de la requête sera abandonné. Avec <code>remove</code>, le
- filtre est supprimé, et le traitement de la requête se poursuit
+ <dd>Indique la marche à suivre si le programme de filtrage externe
+ ne peut pas démarrer. Avec <code>abort</code> (la valeur par
+ défaut), le traitement de la requête sera abandonné. Avec <code>remove</code>, le
+ filtre est supprimé, et le traitement de la requête se poursuit
sans lui.</dd>
</dl>
@@ -337,8 +337,8 @@ close(SAVE);
ExtFilterOptions LogStderr
</highlight>
- <p>Les messages envoyés vers la sortie d'erreurs standard du filtre
- seront enregistrés dans le journal des erreurs d'Apache.</p>
+ <p>Les messages envoyés vers la sortie d'erreurs standard du filtre
+ seront enregistrés dans le journal des erreurs d'Apache.</p>
</usage>
</directivesynopsis>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_filter.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_filter.xml.fr?rev=1820127&r1=1820126&r2=1820127&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_filter.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_filter.xml.fr [utf-8] Thu Jan 4 16:51:04 2018
@@ -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: 1673563:1818967 (outdated) -->
+<!-- English Revision: 1818967 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -221,15 +221,15 @@ FilterChain gzip
JPEG et PNG.
<highlight language="config">
FilterProvider unpack jpeg_unpack "%{CONTENT_TYPE} = 'image/jpeg'"
-FilterProvider unpack gif_unpack "%{CONTENT_TYPE} = 'image/gif'"
-FilterProvider unpack png_unpack "%{CONTENT_TYPE} = 'image/png'"
+FilterProvider unpack gif_unpack "%{CONTENT_TYPE} = 'image/gif'"
+FilterProvider unpack png_unpack "%{CONTENT_TYPE} = 'image/png'"
FilterProvider downsample downsample_filter "%{CONTENT_TYPE} = m|^image/(jpeg|gif|png)|"
FilterProtocol downsample "change=yes"
FilterProvider repack jpeg_pack "%{CONTENT_TYPE} = 'image/jpeg'"
-FilterProvider repack gif_pack "%{CONTENT_TYPE} = 'image/gif'"
-FilterProvider repack png_pack "%{CONTENT_TYPE} = 'image/png'"
+FilterProvider repack gif_pack "%{CONTENT_TYPE} = 'image/gif'"
+FilterProvider repack png_pack "%{CONTENT_TYPE} = 'image/png'"
<Location "/image-filter">
FilterChain unpack downsample repack
</Location>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_sed.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_sed.xml.fr?rev=1820127&r1=1820126&r2=1820127&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_sed.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_sed.xml.fr [utf-8] Thu Jan 4 16:51:04 2018
@@ -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: 1334024:1817952 (outdated) -->
+<!-- English Revision: 1817952 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -25,59 +25,53 @@
<modulesynopsis metafile="mod_sed.xml.meta">
<name>mod_sed</name>
-<description>Filtre les contenus en entrée (requêtes) et en sortie
-(réponses) en utilisant la syntaxe de <code>sed</code></description>
-<status>Expérimental</status>
+<description>Filtre les contenus en entrée (requêtes) et en sortie
+(réponses) en utilisant la syntaxe de <code>sed</code></description>
+<status>Expérimental</status>
<sourcefile>mod_sed.c sed0.c sed1.c regexp.c regexp.h sed.h</sourcefile>
<identifier>sed_module</identifier>
<compatibility>Disponible depuis la version 2.3 d'Apache</compatibility>
<summary>
<p><module>mod_sed</module> est un filtre de contenu "in-process". Le
-filtre <module>mod_sed</module> fournit les commandes d'édition de
-<code>sed</code> implémentées par le programme <code>sed</code> de
-Solaris 10 comme décrit dans la <a
+filtre <module>mod_sed</module> fournit les commandes d'édition de
+<code>sed</code> implémentées par le programme <code>sed</code> de
+Solaris 10 comme décrit dans la <a
href="http://www.gnu.org/software/sed/manual/sed.txt">page de
-manuel</a>. Cependant, à la différence de <code>sed</code>,
-<module>mod_sed</module> ne reçoit pas de données sur son entrée
-standard. Au lieu de cela, le filtre agit sur les données échangées
-entre le client et le serveur. <module>mod_sed</module> peut être
-utilisé comme filtre en entrée ou en sortie. <module>mod_sed</module>
+manuel</a>. Cependant, à la différence de <code>sed</code>,
+<module>mod_sed</module> ne reçoit pas de données sur son entrée
+standard. Au lieu de cela, le filtre agit sur les données échangées
+entre le client et le serveur. <module>mod_sed</module> peut être
+utilisé comme filtre en entrée ou en sortie. <module>mod_sed</module>
est un filtre de contenu, ce qui signifie qu'on ne peut pas l'utiliser
-pour modifier les en-têtes http du client ou du serveur.
+pour modifier les en-têtes http du client ou du serveur.
</p>
<p>
-Le filtre en sortie <module>mod_sed</module> accepte un tronçon de
-données, exécute le script <code>sed</code> sur ces données, puis génère
-une sortie qui est transmise au filtre suivant dans la chaîne.
+Le filtre en sortie <module>mod_sed</module> accepte un tronçon de
+données, exécute le script <code>sed</code> sur ces données, puis génère
+une sortie qui est transmise au filtre suivant dans la chaîne.
</p>
<p>
-Le filtre en entrée <module>mod_sed</module> reçoit des données en
-provenance du filtre suivant dans la chaîne, exécute les scripts
-<code>sed</code>, et renvoie les données générées au filtre appelant
-dans la chaîne de filtrage.
+Le filtre en entrée <module>mod_sed</module> reçoit des données en
+provenance du filtre suivant dans la chaîne, exécute les scripts
+<code>sed</code>, et renvoie les données générées au filtre appelant
+dans la chaîne de filtrage.
</p>
<p>
-Les filtres en entrée ou en sortie ne traitent les données que si des
-caractères newline sont détectés dans le contenu à filtrer. A la fin des
-données, ce qui reste est traité comme la dernière ligne.
+Les filtres en entrée ou en sortie ne traitent les données que si des
+caractères newline sont détectés dans le contenu à filtrer. A la fin des
+données, ce qui reste est traité comme la dernière ligne.
</p>
-<p>Vous trouverez sur le <a
-href="https://blogs.oracle.com/basant/entry/using_mod_sed_to_filter">blog de
-l'auteur</a> un article en forme de tutoriel, ainsi que les raisons pour
-lesquelles ce filtre est plus puissant qu'une simple
-recherche/remplacement de chaîne ou d'expression rationnelle.</p>
-
</summary>
<section id="sampleconf"><title>Exemple de configuration</title>
<example><title>Ajout d'un filtre en sortie</title>
<highlight language="config">
-# Dans l'exemple suivant, le filtre sed va remplacer la chaîne
- # "monday" par "MON" et la chaîne "sunday" par "SUN" dans les
+# Dans l'exemple suivant, le filtre sed va remplacer la chaîne
+ # "monday" par "MON" et la chaîne "sunday" par "SUN" dans les
# documents html avant de les envoyer au client.
<Directory "/var/www/docs/sed">
AddOutputFilter Sed html
@@ -87,11 +81,11 @@ recherche/remplacement de chaîne o
</highlight>
</example>
- <example><title>Ajout d'un filtre en entrée</title>
+ <example><title>Ajout d'un filtre en entrée</title>
<highlight language="config">
- # Dans l'exemple suivant, le filtre sed va remplacer la chaîne
- # "monday" par "MON" et la chaîne "sunday" par "SUN" dans les
- # données POST envoyées à PHP.
+ # Dans l'exemple suivant, le filtre sed va remplacer la chaîne
+ # "monday" par "MON" et la chaîne "sunday" par "SUN" dans les
+ # données POST envoyées à PHP.
<Directory "/var/www/docs/sed">
AddInputFilter Sed php
InputSed "s/monday/MON/g"
@@ -102,13 +96,13 @@ recherche/remplacement de chaîne o
</section>
<section id="sed_commands"><title>Commandes sed</title>
<p>
- Vous trouverez tous les détails à propos de la commande
+ Vous trouverez tous les détails à propos de la commande
<code>sed</code> dans sa <a href="http://www.gnu.org/software/sed/manual/sed.txt">page
de manuel</a>.
</p>
<dl>
<dt><code>b</code></dt>
- <dd>Saut vers le label spécifié (similaire à goto).</dd>
+ <dd>Saut vers le label spécifié (similaire à goto).</dd>
<dt><code>h</code></dt>
<dd>Copie la ligne courante dans le tampon.</dd>
<dt><code>H</code></dt>
@@ -116,7 +110,7 @@ recherche/remplacement de chaîne o
<dt><code>g</code></dt>
<dd>Copie le contenu du tampon dans la ligne courante.</dd>
<dt><code>G</code></dt>
- <dd>Ajoute le contenu du tampon à la ligne courante.</dd>
+ <dd>Ajoute le contenu du tampon à la ligne courante.</dd>
<dt><code>x</code></dt>
<dd>Echange les contenus du tampon et de la ligne courante.</dd>
</dl>
@@ -125,31 +119,31 @@ recherche/remplacement de chaîne o
<directivesynopsis>
<name>OutputSed</name>
<description>Commande sed pour le filtrage des contenus de type
-réponse</description>
+réponse</description>
<syntax>OutputSed <var>commande-sed</var></syntax>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<usage>
- <p>La directive <directive>OutputSed</directive> permet de spécifier
- la commande <code>sed</code> à exécuter dans le cadre du traitement
- d'une réponse.
+ <p>La directive <directive>OutputSed</directive> permet de spécifier
+ la commande <code>sed</code> à exécuter dans le cadre du traitement
+ d'une réponse.
</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>InputSed</name>
-<description>Commande sed à exécuter pour le filtrage des données d'une
-requête (en général des données <code>POST</code>)</description>
+<description>Commande sed à exécuter pour le filtrage des données d'une
+requête (en général des données <code>POST</code>)</description>
<syntax>InputSed <var>commande-sed</var></syntax>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<usage>
- <p>La directive <directive>InputSed</directive> permet de spécifier
- la commande sed à exécuter pour le filtrage des données (en général
- des données <code>POST</code>) d'une requête.
+ <p>La directive <directive>InputSed</directive> permet de spécifier
+ la commande sed à exécuter pour le filtrage des données (en général
+ des données <code>POST</code>) d'une requête.
</p>
</usage>
</directivesynopsis>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_substitute.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_substitute.xml.fr?rev=1820127&r1=1820126&r2=1820127&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_substitute.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_substitute.xml.fr [utf-8] Thu Jan 4 16:51:04 2018
@@ -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: 1815482:1818828 (outdated) -->
+<!-- English Revision: 1818828 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -95,8 +95,13 @@ réponse</description>
</highlight>
</example>
+ <p>Le caractère utilisé pour séparer (ou "délimiter") les différentes partie
+ de la valeur de substitution est référencé sous le nom de "délimiteur", et
+ il s'agit le plus souvent d'un "slash".</p>
+
<p>Si le modèle ou la chaîne de substitution contient un caractère
- slash '/', il faut utiliser un autre délimiteur :</p>
+ slash '/', il est possible d'utiliser un autre délimiteur afin de rendre la
+ directive plus lisible :</p>
<example><title>Exemple d'utilisation d'un délimiteur
alternatif</title>
@@ -116,7 +121,7 @@ réponse</description>
<Location "/">
AddOutputFilterByType SUBSTITUTE text/html
# "foo=k,bar=k" -> "foo/bar=k"
- Substitute "s|foo=(\w+),bar=\1|foo/bar=$1"
+ Substitute "s|foo=(\w+),bar=\1|foo/bar=$1|"
</Location>
</highlight>
</example>
@@ -134,7 +139,7 @@ réponse</description>
<example><title>Réécriture des URLs intégrées à un contenu mandaté</title>
<highlight language="config">
-ProxyPass "/blog/" "http://internal.blog.example.com"
+ProxyPass "/blog/" "http://internal.blog.example.com/"
ProxyPassReverse "/blog/" "http://internal.blog.example.com/"
Substitute "s|http://internal.blog.example.com/|http://www.example.com/blog/|i"
Modified: httpd/httpd/branches/2.4.x/docs/manual/upgrading.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/upgrading.xml.fr?rev=1820127&r1=1820126&r2=1820127&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/upgrading.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/upgrading.xml.fr [utf-8] Thu Jan 4 16:51:04 2018
@@ -3,7 +3,7 @@
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1784914:1819908 (outdated) -->
+<!-- English Revision: 1819908 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -303,9 +303,12 @@ access.log - GET /server-status 200 127.
<example>
<title>Version 2.2 :</title>
<highlight language="config">
+# configuration en version 2.2 qui désactive le contrôle d'accès basé sur le nom
+# d'hôte pour n'utiliser que l'authentification
Order Deny,Allow
-Deny from all
-AuthBasicProvider File
+Allow from all
+AuthType Basic
+AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user
@@ -314,8 +317,10 @@ Require valid-user
<example>
<title>Version 2.4 :</title>
<highlight language="config">
-# Pas besoin de remplacer les directives Order et deny
-AuthBasicProvider File
+# Pas besoin de remplacer les directives de contrôle d'accès basées sur le nom
+# d'hôte désactivées
+AuthType Basic
+AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user
@@ -334,7 +339,8 @@ Deny from all
# ALL est la valeur par défaut de Satisfy
Satisfy ALL
Allow from 127.0.0.1
-AuthBasicProvider File
+AuthType Basic
+AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user
@@ -343,7 +349,8 @@ Require valid-user
<example>
<title>Version 2.4 :</title>
<highlight language="config">
-AuthBasicProvider File
+AuthType Basic
+AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
<RequireAll>
@@ -364,7 +371,8 @@ Order allow,deny
Deny from all
Satisfy any
Allow from 127.0.0.1
-AuthBasicProvider File
+AuthType Basic
+AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user
@@ -373,7 +381,8 @@ Require valid-user
<example>
<title>Version 2.4 :</title>
<highlight language="config">
-AuthBasicProvider File
+AuthType Basic
+AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
# Implicite : <RequireAny>
Modified: httpd/httpd/branches/2.4.x/docs/manual/vhosts/mass.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/vhosts/mass.xml.fr?rev=1820127&r1=1820126&r2=1820127&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/vhosts/mass.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/vhosts/mass.xml.fr [utf-8] Thu Jan 4 16:51:04 2018
@@ -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: 1673563:1818061 (outdated) -->
+<!-- English Revision: 1818061 -->
<!-- French translation : Lucien GENTIS -->
<!--
@@ -22,25 +22,25 @@
-->
<manualpage metafile="mass.xml.meta">
-<parentdocument href="./">Hébergement virtuel</parentdocument>
- <title>Hébergement virtuel de masse configuré dynamiquement</title>
+<parentdocument href="./">Hébergement virtuel</parentdocument>
+ <title>Hébergement virtuel de masse configuré dynamiquement</title>
<summary>
- <p>Ce document propose une méthode performante pour servir un nombre
- quelconque d'hôtes virtuels avec le serveur HTTP Apache. Un <a
- href="../rewrite/vhosts.html">document séparé</a> décrit comment
- utiliser <module>mod_rewrite</module> pour gérer l'hébergement
+ <p>Ce document propose une méthode performante pour servir un nombre
+ quelconque d'hôtes virtuels avec le serveur HTTP Apache. Un <a
+ href="../rewrite/vhosts.html">document séparé</a> décrit comment
+ utiliser <module>mod_rewrite</module> pour gérer l'hébergement
virtuel de masse dynamique.
</p>
</summary>
-<section id="motivation"><title>A qui ce document est-il destiné ?</title>
+<section id="motivation"><title>A qui ce document est-il destiné ?</title>
- <p>Les techniques décrites ici vous concernent si votre
+ <p>Les techniques décrites ici vous concernent si votre
<code>httpd.conf</code> contient de nombreuses sections
- <code><VirtualHost></code> très semblables,
+ <code><VirtualHost></code> très semblables,
dans le style :</p>
<highlight language="config">
@@ -64,107 +64,107 @@
</highlight>
<p>Nous voulons remplacer toutes les configurations
- <code><VirtualHost></code> par un mécanisme qui les génère
- dynamiquement. Ceci présente certains avantages :</p>
+ <code><VirtualHost></code> par un mécanisme qui les génère
+ dynamiquement. Ceci présente certains avantages :</p>
<ol>
<li>Votre fichier de configuration est plus petit, ainsi Apache
- démarre plus rapidement et consomme moins de mémoire. Et ce qui
- est peut-être le plus important, le fichier de configuration plus
- petit est plus facile à maintenir, et le risque d'erreurs en est
- diminué d'autant.
+ démarre plus rapidement et consomme moins de mémoire. Et ce qui
+ est peut-être le plus important, le fichier de configuration plus
+ petit est plus facile à maintenir, et le risque d'erreurs en est
+ diminué d'autant.
</li>
- <li>Pour ajouter des serveurs virtuels, il suffit de créer les
- répertoires appropriés dans le système de fichiers et les entrées
- dans le DNS - il n'est plus nécessaire de reconfigurer ou de
- redémarrer Apache.</li>
+ <li>Pour ajouter des serveurs virtuels, il suffit de créer les
+ répertoires appropriés dans le système de fichiers et les entrées
+ dans le DNS - il n'est plus nécessaire de reconfigurer ou de
+ redémarrer Apache.</li>
</ol>
- <p>Le principal désavantage réside dans le fait que vous ne pouvez
- pas définir un fichier journal différent pour chaque serveur
- virtuel. De toute façon, ce serait une mauvaise idée si vous avez de
- nombreux serveurs virtuels, car cela nécessiterait un <a
+ <p>Le principal désavantage réside dans le fait que vous ne pouvez
+ pas définir un fichier journal différent pour chaque serveur
+ virtuel. De toute façon, ce serait une mauvaise idée si vous avez de
+ nombreux serveurs virtuels, car cela nécessiterait un <a
href="fd-limits.html">nombre important de descripteurs de
- fichier</a>. Il est préférable de rediriger <a
+ fichier</a>. Il est préférable de rediriger <a
href="../logs.html#piped">les journaux via un pipe ou
une file fifo</a> vers un
- programme, et faire en sorte que ce dernier éclate les journaux
+ programme, et faire en sorte que ce dernier éclate les journaux
en un journal par serveur virtuel. L'utilitaire <a
- href="../programs/other.html#split-logfile">split-logfile</a>
+ href="../programs/split-logfile.html">split-logfile</a>
constitue un exemple de ce traitement.</p>
</section>
<section id="overview"><title>Vue d'ensemble</title>
- <p>Un serveur virtuel peut être défini par deux informations : son
- adresse IP, et le contenu de l'en-tête <code>Host:</code> de la
- requête HTTP. La technique d'hébergement virtuel dynamique de masse
- utilisée ici consiste à insérer automatiquement ces informations
- dans le chemin du fichier à utiliser pour répondre à la requête. On
+ <p>Un serveur virtuel peut être défini par deux informations : son
+ adresse IP, et le contenu de l'en-tête <code>Host:</code> de la
+ requête HTTP. La technique d'hébergement virtuel dynamique de masse
+ utilisée ici consiste à insérer automatiquement ces informations
+ dans le chemin du fichier à utiliser pour répondre à la requête. On
peut y parvenir assez facilement en utilisant
<module>mod_vhost_alias</module> avec Apache httpd, mais on peut aussi
<a href="../rewrite/vhosts.html">utiliser mod_rewrite</a>. </p>
- <p>Par défaut, ces deux modules
- sont désactivés ; vous devez activer l'un d'eux lors de la
+ <p>Par défaut, ces deux modules
+ sont désactivés ; vous devez activer l'un d'eux lors de la
compilation et de la configuration d'Apache httpd si vous voulez utiliser
cette technique.</p>
- <p>Certains paramètres doivent être extraits de la requête pour que le serveur
- dynamique se présente comme un serveur dynamique normal. Le plus
- important est le nom du serveur, que le serveur utilise pour générer des
- URLs d'auto-référencement, etc... Il est défini via la directive
- <code>ServerName</code>, et les CGIs peuvent s'y référer via la
- variable d'environnement <code>SERVER_NAME</code>. Sa véritable
- valeur utilisée à l'exécution est contrôlée par la définition de la
+ <p>Certains paramètres doivent être extraits de la requête pour que le serveur
+ dynamique se présente comme un serveur dynamique normal. Le plus
+ important est le nom du serveur, que le serveur utilise pour générer des
+ URLs d'auto-référencement, etc... Il est défini via la directive
+ <code>ServerName</code>, et les CGIs peuvent s'y référer via la
+ variable d'environnement <code>SERVER_NAME</code>. Sa véritable
+ valeur utilisée à l'exécution est contrôlée par la définition de la
directive
<directive module="core">UseCanonicalName</directive>. Avec
<code>UseCanonicalName Off</code>, le nom du serveur correspond au
- contenu de l'en-tête <code>Host:</code> de la requête. Avec
+ contenu de l'en-tête <code>Host:</code> de la requête. Avec
<code>UseCanonicalName DNS</code>, il est extrait d'une recherche
- DNS inverse sur l'adresse IP du serveur virtuel. La première
- configuration est utilisée pour l'hébergement virtuel dynamique par
- nom, et la deuxième pour l'hébergement virtuel dynamique par IP. Si
- httpd ne peut pas déterminer le nom du serveur, soit parce qu'il
- n'y a pas d'en-tête <code>Host:</code>, soit parce que la recherche
- DNS a échoué, il prend en compte la valeur définie par la directive
+ DNS inverse sur l'adresse IP du serveur virtuel. La première
+ configuration est utilisée pour l'hébergement virtuel dynamique par
+ nom, et la deuxième pour l'hébergement virtuel dynamique par IP. Si
+ httpd ne peut pas déterminer le nom du serveur, soit parce qu'il
+ n'y a pas d'en-tête <code>Host:</code>, soit parce que la recherche
+ DNS a échoué, il prend en compte la valeur définie par la directive
<code>ServerName</code>.</p>
- <p>L'autre paramètre à extraire est la racine des documents (définie
+ <p>L'autre paramètre à extraire est la racine des documents (définie
via la directive <code>DocumentRoot</code> et disponible pour les
scripts CGI via la variable d'environnement <code>DOCUMENT_ROOT</code>).
- Dans une configuration classique, il est utilisé par le module core
+ Dans une configuration classique, il est utilisé par le module core
pour faire correspondre les URIs aux noms de fichiers, mais lorsque
la configuration du serveur comporte des serveurs virtuels, ce
- traitement doit être pris en charge par un autre module (soit
+ traitement doit être pris en charge par un autre module (soit
<module>mod_vhost_alias</module>, soit <module>mod_rewrite</module>), qui
- utilise un méthode de correspondance différente. Aucun de ces
- modules ne se chargeant de définir la variable d'environnement
+ utilise un méthode de correspondance différente. Aucun de ces
+ modules ne se chargeant de définir la variable d'environnement
<code>DOCUMENT_ROOT</code>, si des CGIs ou des documents SSI
- doivent en faire usage, ils obtiendront une valeur erronée.</p>
+ doivent en faire usage, ils obtiendront une valeur erronée.</p>
</section>
-<section id="simple"><title>Hébergement virtuel
+<section id="simple"><title>Hébergement virtuel
dynamique avec mod_vhost_alias</title>
- <p>Cet extrait de fichier <code>httpd.conf</code> implémente
- l'hébergement virtuel décrit dans la section <a
- href="#motivation">À qui ce document est-il destiné ?</a> ci-dessus
+ <p>Cet extrait de fichier <code>httpd.conf</code> implémente
+ l'hébergement virtuel décrit dans la section <a
+ href="#motivation">À qui ce document est-il destiné ?</a> ci-dessus
en utilisant <module>mod_vhost_alias</module>.</p>
<highlight language="config">
-# extrait le nom du serveur de l'en-tête Host:
+# extrait le nom du serveur de l'en-tête Host:
UseCanonicalName Off
-# ce format de journal peut être éclaté en journaux par serveur virtuel
-# à l'aide du premier champ via l'utilitaire split-logfile
+# ce format de journal peut être éclaté en journaux par serveur virtuel
+# à l'aide du premier champ via l'utilitaire split-logfile
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log" vcommon
# inclut le nom du serveur dans les noms de fichiers ressources
-# nécessaires aux traitements des requêtes
+# nécessaires aux traitements des requêtes
VirtualDocumentRoot "/www/hosts/%0/docs"
VirtualScriptAlias "/www/hosts/%0/cgi-bin"
</highlight>
@@ -172,9 +172,9 @@ VirtualScriptAlias "/www/hosts/%0/cgi-b
<p>Pour changer cette configuration en solution de serveur virtuel
par IP, il suffit de remplacer <code>UseCanonicalName
Off</code> par <code>UseCanonicalName DNS</code>. Le nom du serveur
- inséré dans le nom de fichier sera alors déduit de l'adresse IP du
- serveur virtuel. La variable <code>%0</code> fait référence au nom
- de serveur de la requête, tel qu'il est indiqué dans l'en-tête
+ inséré dans le nom de fichier sera alors déduit de l'adresse IP du
+ serveur virtuel. La variable <code>%0</code> fait référence au nom
+ de serveur de la requête, tel qu'il est indiqué dans l'en-tête
<code>Host:</code>.</p>
<p>Voir la documentation du module <module>mod_vhost_alias</module>
@@ -182,15 +182,15 @@ VirtualScriptAlias "/www/hosts/%0/cgi-b
</section>
-<section id="homepages"><title>Système de serveurs virtuels dynamiques
-simplifié</title>
+<section id="homepages"><title>Système de serveurs virtuels dynamiques
+simplifié</title>
- <p>Il s'agit d'une adaptation du système ci-dessus, ajusté pour un
- serveur d'hébergement web de FAI. Grâce à la variable
- <code>%2</code>, on peut extraire des sous-chaînes de caractères du
+ <p>Il s'agit d'une adaptation du système ci-dessus, ajusté pour un
+ serveur d'hébergement web de FAI. Grâce à la variable
+ <code>%2</code>, on peut extraire des sous-chaînes de caractères du
nom du serveur pour les utiliser dans le nom de fichier afin, par
- exemple, de définir <code>/home/user/www</code> comme emplacement des
- documents pour <code>www.user.example.com</code>. Un seul répertoire
+ exemple, de définir <code>/home/user/www</code> comme emplacement des
+ documents pour <code>www.user.example.com</code>. Un seul répertoire
<code>cgi-bin</code> suffit pour l'ensemble des
serveurs virtuels.</p>
@@ -198,32 +198,32 @@ simplifié</title>
UseCanonicalName Off
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
-CustomLog logs/access_log vcommon
+CustomLog "logs/access_log" vcommon
# insertion d'une partie du nom du serveur dans les noms de fichiers
VirtualDocumentRoot "/home/%2/www"
-# répertoire cgi-bin unique
+# répertoire cgi-bin unique
ScriptAlias "/cgi-bin/" "/www/std-cgi/"
</highlight>
- <p>Vous trouverez des exemples plus élaborés d'utilisation de la
+ <p>Vous trouverez des exemples plus élaborés d'utilisation de la
directive <code>VirtualDocumentRoot</code> dans la documentation du
module <module>mod_vhost_alias</module>.</p>
</section>
-<section id="combinations"><title>Utiliser plusieurs systèmes
-d'hébergement virtuel sur le même serveur</title>
+<section id="combinations"><title>Utiliser plusieurs systèmes
+d'hébergement virtuel sur le même serveur</title>
- <p>Moyennant une configuration un peu plus compliquée, vous pouvez
- contrôler la portée des différentes configurations d'hébergement
- virtuel à l'aide des directives <code><VirtualHost></code>
+ <p>Moyennant une configuration un peu plus compliquée, vous pouvez
+ contrôler la portée des différentes configurations d'hébergement
+ virtuel à l'aide des directives <code><VirtualHost></code>
normales de httpd. Par exemple, on peut associer une adresse IP pour
- les pages d'accueil des clients en général, et une autre pour les
+ les pages d'accueil des clients en général, et une autre pour les
clients commerciaux avec la configuration suivante. Cette
- configuration peut être combinée avec les sections
- <code><VirtualHost></code> conventionnelles, comme indiqué
+ configuration peut être combinée avec les sections
+ <code><VirtualHost></code> conventionnelles, comme indiqué
plus loin.</p>
<highlight language="config">
@@ -264,26 +264,26 @@ LogFormat "%V %h %l %u %t \"%r\" %s %b"
<title>Note</title>
<p>Si le premier bloc VirtualHost ne comporte <em>pas</em> de
directive <directive module="core">ServerName</directive>, c'est
- le nom issu d'une recherche DNS inverse à partir de l'adresse IP
- du serveur virtuel qui sera utilisé. Si ce nom ne correspond pas
- à celui que vous voulez utiliser, vous pouvez ajouter une entrée
+ le nom issu d'une recherche DNS inverse à partir de l'adresse IP
+ du serveur virtuel qui sera utilisé. Si ce nom ne correspond pas
+ à celui que vous voulez utiliser, vous pouvez ajouter une entrée
de remplacement (par exemple <code>ServerName
- none.example.com</code>) pour éviter ce comportement.</p>
+ none.example.com</code>) pour éviter ce comportement.</p>
</note>
</section>
-<section id="ipbased"><title>Pour un hébergement virtuel par IP plus
+<section id="ipbased"><title>Pour un hébergement virtuel par IP plus
efficace</title>
- <p>Les changements de configuration suggérés pour transformer <a
- href="#simple">le premier exemple</a> en hébergement virtuel par IP
- conduisent à une configuration peu efficace. Chaque requête
- nécessite une nouvelle recherche DNS. Pour éviter cette surcharge de
- travail, le système de fichiers peut être organisé pour correspondre
- aux adresses IP, plutôt qu'aux noms de serveurs, supprimant par
- la-même la nécessité d'une recherche DNS. La journalisation doit
- aussi être adaptée pour fonctionner sur un tel système.</p>
+ <p>Les changements de configuration suggérés pour transformer <a
+ href="#simple">le premier exemple</a> en hébergement virtuel par IP
+ conduisent à une configuration peu efficace. Chaque requête
+ nécessite une nouvelle recherche DNS. Pour éviter cette surcharge de
+ travail, le système de fichiers peut être organisé pour correspondre
+ aux adresses IP, plutôt qu'aux noms de serveurs, supprimant par
+ la-même la nécessité d'une recherche DNS. La journalisation doit
+ aussi être adaptée pour fonctionner sur un tel système.</p>
<highlight language="config">
# obtention du nom du serveur par recherche DNS inverse
@@ -291,7 +291,7 @@ efficace</title>
UseCanonicalName DNS
# insertion de l'adresse IP dans les journaux afin de pouvoir les
-# éclater
+# éclater
LogFormat "%A %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log" vcommon
@@ -302,19 +302,29 @@ VirtualScriptAliasIP "/www/hosts/%0/cgi
</section>
-<section id="rewrite"><title>Hébergement virtuel de masse avec
+<section id="rewrite"><title>Hébergement virtuel de masse avec
mod_rewrite</title>
<p>
-L'hébergement virtuel de masse peut aussi être effectué en utilisant
-<module>mod_rewrite</module>, soit à l'aide de simples directives <directive
+L'hébergement virtuel de masse peut aussi être effectué en utilisant
+<module>mod_rewrite</module>, soit à l'aide de simples directives <directive
module="mod_rewrite">RewriteRule</directive>, soit en utilisant des
-techniques plus compliquées comme le stockage externe des définitions
-des serveurs virtuels, ces dernières étant accessibles via des
+techniques plus compliquées comme le stockage externe des définitions
+des serveurs virtuels, ces dernières étant accessibles via des
directives <directive module="mod_rewrite">RewriteMap</directive>. Ces
-techniques sont décrites dans la <a
-href="../rewrite/vhosts.html">documentation sur la réécriture</a>.</p>
+techniques sont décrites dans la <a
+href="../rewrite/vhosts.html">documentation sur la réécriture</a>.</p>
+
+</section>
+
+<section id="macro"><title>Hébergement virtuel en masse avec mod_macro</title>
+<p>Une autre option pour générer dynamiquement des serveurs virtuels :
+mod_macro ; ce module permet de créer un modèle de serveur virtuel que
+vous pourrez invoquer pour des noms d'hôtes multiples. La section
+<strong>Usage</strong> de la documentation du module présente un exemple qui
+illustre cette méthode.
+</p>
</section>
</manualpage>