From: Lucien Gentis
Date: Thu, 4 Jan 2018 16:29:02 +0000 (+0000)
Subject: XML updates.
X-Git-Tag: 2.5.0-alpha2-ci-test-only~3001
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2d84b5ff296557356cb4faca8814e90e387bc031;p=thirdparty%2Fapache%2Fhttpd.git
XML updates.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1820118 13f79535-47bb-0310-9956-ffa450edef68
---
diff --git a/docs/manual/mod/core.xml.fr b/docs/manual/mod/core.xml.fr
index 4cd77f24ae1..253be7dcc02 100644
--- a/docs/manual/mod/core.xml.fr
+++ b/docs/manual/mod/core.xml.fr
@@ -1,7 +1,7 @@
-
+
@@ -5515,18 +5515,19 @@ entre elles à la réception d'une requête
RegisterHttpMethod
Enregistrement de méthodes HTTP non standards
-RegisterHttpMethod méthode [méthode [...]]
+RegisterHttpMethod method [method [...]]
server config
-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
-RegisterHttpMethod 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.
+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.
+HTTPProtocolOptions
+AllowMethods
diff --git a/docs/manual/mod/event.xml.fr b/docs/manual/mod/event.xml.fr
index 36c92804504..cf836de418c 100644
--- a/docs/manual/mod/event.xml.fr
+++ b/docs/manual/mod/event.xml.fr
@@ -1,7 +1,7 @@
-
+
@@ -138,7 +138,9 @@ propose le MPM worker, avec l'unique addition de la directive
entièrement. La fermeture progressive est limitée dans le temps,
mais elle peut tout de même être assez longue, si bien qu'il est
intéressant qu'un thread de travail puisse se décharger de cette
- tâche sur le thread d'écoute.
+ tâche sur le thread d'écoute. A partir de la version 2.4.28, au lieu
+ d'effectuer lui-même la fermeture progressive, le thread d'écoute
+ confie cette tâche au premier thread de travail disponible.
Ces améliorations sont disponible pour les connexions HTTP ou HTTPS.
diff --git a/docs/manual/mod/mod_brotli.xml.fr b/docs/manual/mod/mod_brotli.xml.fr
index d5eda396b8d..f8c22a92f74 100644
--- a/docs/manual/mod/mod_brotli.xml.fr
+++ b/docs/manual/mod/mod_brotli.xml.fr
@@ -29,22 +29,22 @@
Extension
mod_brotli.c
brotli_module
-Disponible à partir de la version 2.4.26 du serveur HTTP Apache
+Disponible à partir de la version 2.4.26 du serveur HTTP Apache
Le module mod_brotli fournit le filtre en sortie
BROTLI_COMPRESS qui permet de compresser un contenu avant sa
- livraison au client en utilisant la bibliothèque brotli. Ce filtre est
- implémenté en utilisant la bibliothèque Brotli que l'on peut trouver à https://github.com/google/brotli.
Filters
Exemples de configurations
Compression et TLS
- Certaines applications web sont vulnérables à une attaque de type vol
- d'informations lorsqu'une connexion TLS transmet des données
- compressées. Pour plus d'informations, étudiez en détail la famille
+
Certaines applications web sont vulnérables à une attaque de type vol
+ d'informations lorsqu'une connexion TLS transmet des données
+ compressées. Pour plus d'informations, étudiez en détail la famille
d'attaques "BREACH".
Voici une configuration simple qui compresse des types de contenus
@@ -60,24 +60,24 @@ AddOutputFilterByType BROTLI_COMPRESS text/html text/plain text/xml text/css tex
Activation de la compression
Compression et TLS
- Certaines applications web sont vulnérables à une attaque de type vol
- d'informations lorsqu'une connexion TLS transmet des données
- compressées. Pour plus d'informations, étudiez en détail la famille
+
Certaines applications web sont vulnérables à une attaque de type vol
+ d'informations lorsqu'une connexion TLS transmet des données
+ compressées. Pour plus d'informations, étudiez en détail la famille
d'attaques "BREACH".
Compression en sortie
- La compression est implémentée par le La compression est implémentée par le filtre BROTLI_COMPRESS. La
directive suivante active la compression pour les documents correspondant
- au conteneur dans lequel elle est placée :
+ au conteneur dans lequel elle est placée :
SetOutputFilter BROTLI_COMPRESS
SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-brotli
- Si vous voulez restreindre la compression à certains types MIME
+
Si vous voulez restreindre la compression à certains types MIME
particuliers, vous pouvez utiliser la directive AddOutputFilterByType. Dans l'exemple
suivant, l'activation de la compression est restreinte aux fichiers html
@@ -90,15 +90,15 @@ SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-brotli
Note
- Le filtre BROTLI_COMPRESS est toujours inséré après les
- filtres RESOURCE comme PHP ou SSI. Il n'affecte jamais les sous-requêtes
+ Le filtre BROTLI_COMPRESS est toujours inséré après les
+ filtres RESOURCE comme PHP ou SSI. Il n'affecte jamais les sous-requêtes
internes.
Note
- Définie via SetEnv, la variable
- d'environnement no-brotli permet de désactiver la
- compression brotli pour une requête particulière, et ceci même si elle
- est supportée par le client.
+ Définie via SetEnv, la variable
+ d'environnement no-brotli permet de désactiver la
+ compression brotli pour une requête particulière, et ceci même si elle
+ est supportée par le client.
@@ -107,29 +107,29 @@ SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-brotli
Interaction avec les serveurs mandataires
- Le module mod_brotli envoie un en-tête de réponse HTTP
+
Le module mod_brotli envoie un en-tête de réponse HTTP
Vary:Accept-Encoding pour indiquer aux mandataires qu'une
- réponse mise en cache ne doit être envoyée qu'aux clients qui envoient
- l'en-tête de requête Accept-Encoding approprié. Ceci permet
- d'éviter d'envoyer du contenu compressé à un client qui ne sera pas en
- mesure de le décompresser.
-
- Si vous utilisez des exclusions spéciales dépendant, par exemple, de
- l'en-tête User-Agent, vous devez faire un ajout manuel à
- l'en-tête Vary afin d'informer les mandataires des restrictions
- supplémentaires. Par exemple, dans une configuration typique où l'addition
- du filtre BROTLI_COMPRESS dépend de l'en-tête User-Agent,
+ réponse mise en cache ne doit être envoyée qu'aux clients qui envoient
+ l'en-tête de requête Accept-Encoding approprié. Ceci permet
+ d'éviter d'envoyer du contenu compressé à un client qui ne sera pas en
+ mesure de le décompresser.
+
+ Si vous utilisez des exclusions spéciales dépendant, par exemple, de
+ l'en-tête User-Agent, vous devez faire un ajout manuel Ã
+ l'en-tête Vary afin d'informer les mandataires des restrictions
+ supplémentaires. Par exemple, dans une configuration typique où l'addition
+ du filtre BROTLI_COMPRESS dépend de l'en-tête User-Agent,
vous devez ajouter :
Header append Vary User-Agent
- Si votre décision d'utiliser la compression ou non dépend d'autres
- informations que le contenu d'en-têtes de requêtes (par exemple la version
- HTTP), vous devez affecter la valeur * à l'en-tête
- Vary. Ceci permet d'éviter que des mandataires qui le
- supportent n'effectuent une mise en cache intégrale.
+ Si votre décision d'utiliser la compression ou non dépend d'autres
+ informations que le contenu d'en-têtes de requêtes (par exemple la version
+ HTTP), vous devez affecter la valeur * à l'en-tête
+ Vary. Ceci permet d'éviter que des mandataires qui le
+ supportent n'effectuent une mise en cache intégrale.
Exemple
@@ -138,23 +138,23 @@ Header set Vary *
-Servir un contenu pré-compressé
+Servir un contenu pré-compressé
- comme mod_brotli compresse systématiquement un contenu
- pour chaque requête le concernant, il est possible d'obtenir un gain en
- performance en pré-compressant le contenu et en disant à mod_brotli de le
+
comme mod_brotli compresse systématiquement un contenu
+ pour chaque requête le concernant, il est possible d'obtenir un gain en
+ performance en pré-compressant le contenu et en disant à mod_brotli de le
servir sans le recompresser. Pour cela, vous pouvez utiliser une
configuration du style :
<IfModule mod_headers.c>
- # Sert des fichiers CSS et JS compressés par brotli, s'ils existent
+ # Sert des fichiers CSS et JS compressés par brotli, s'ils existent
# et si le client supporte brotli.
RewriteCond "%{HTTP:Accept-encoding}" "br"
RewriteCond "%{REQUEST_FILENAME}\.br" "-s"
RewriteRule "^(.*)\.(js|css)" "$1\.$2\.br" [QSA]
- # Sert des types de contenu corrects, et évite la double compression.
+ # Sert des types de contenu corrects, et évite la double compression.
RewriteRule "\.css\.gz$" "-" [T=text/css,E=no-brotli:1]
RewriteRule "\.js\.gz$" "-" [T=text/javascript,E=no-brotli:1]
@@ -163,8 +163,8 @@ Header set Vary *
# Sert un type d'encodage correct.
Header append Content-Encoding br
- # Force les mandataires à mettre en cache séparément les fichiers css/js
- # compressés ou non par brotli.
+ # Force les mandataires à mettre en cache séparément les fichiers css/js
+ # compressés ou non par brotli.
Header append Vary Accept-Encoding
</FilesMatch>
</IfModule>
@@ -174,7 +174,7 @@ Header set Vary *
BrotliFilterNote
-Enregistre le taux de compression dans une note à des fins de
+Enregistre le taux de compression dans une note à des fins de
journalisation
BrotliFilterNote [type] notename
server configvirtual host
@@ -182,10 +182,10 @@ journalisation
La directive BrotliFilterNote permet d'indiquer
- qu'une note à propos du taux de compression doit être attachée à la
- requête. L'argument notename permet de spécifier le nom de la
- note. Vous pouvez utiliser cette note à des fins de statistiques en ajoutant
- l'information correspondante à votre access
+ qu'une note à propos du taux de compression doit être attachée à la
+ requête. L'argument notename permet de spécifier le nom de la
+ note. Vous pouvez utiliser cette note à des fins de statistiques en ajoutant
+ l'information correspondante à votre access
log.
Exemple
@@ -197,15 +197,15 @@ CustomLog "logs/brotli_log" brotli
- Si vous souhaitez que l'information enregistrée dans vos journaux soit
+
Si vous souhaitez que l'information enregistrée dans vos journaux soit
plus pertinente, vous pouvez renseigner l'argument optionnel type
- afin de spécifier le type de données à enregistrer dans la note à
+ afin de spécifier le type de données à enregistrer dans la note Ã
journaliser. L'argument type accepte les valeurs suivantes :
Input
- Enregistre dans la note le nombre d'octets contenus dans le flux
- d'entrée du filtre.
+ d'entrée du filtre.
Output
- Enregistre dans la note le nombre d'octets contenus dans le flux
@@ -213,13 +213,13 @@ CustomLog "logs/brotli_log" brotli
Ratio
- Enregistre dans la note le taux de compression (
output/input *
- 100). Il s'agit de l'option par défaut si l'argument
+ 100). Il s'agit de l'option par défaut si l'argument
type est omis.
- Vous pouvez alors configurer vos journaux de la manière suivante :
+ Vous pouvez alors configurer vos journaux de la manière suivante :
- Journalisation spécifique
+ Journalisation spécifique
BrotliFilterNote Input instream
BrotliFilterNote Output outstream
@@ -235,7 +235,7 @@ CustomLog "logs/brotli_log" brotli
BrotliCompressionQuality
-Qualité de la compression
+Qualité de la compression
BrotliCompressionQuality value
BrotliCompressionQuality 5
server configvirtual host
@@ -243,16 +243,16 @@ CustomLog "logs/brotli_log" brotli
La directive BrotliCompressionQuality permet de
- spécifier la qualité de la compression (une valeur entre 0 et
- 11). Les valeurs les plus hautes correspondent à une compression de
- meilleure qualité mais plus lente.
+ spécifier la qualité de la compression (une valeur entre 0 et
+ 11). Les valeurs les plus hautes correspondent à une compression de
+ meilleure qualité mais plus lente.
BrotliCompressionWindow
-Taille de la fenêtre de compression glissante brotli
+Taille de la fenêtre de compression glissante brotli
BrotliCompressionWindow value
BrotliCompressionWindow 18
server configvirtual host
@@ -260,16 +260,16 @@ CustomLog "logs/brotli_log" brotli
La directive BrotliCompressionWindow permet de
- spécifier la taille de la fenêtre de compression glissante brotli (une
- valeur comprise entre 10 et 24). Une taille de fenêtre plus grande peut
- améliorer la qualité de la compression mais consomme d'avantage de mémoire.
+ spécifier la taille de la fenêtre de compression glissante brotli (une
+ valeur comprise entre 10 et 24). Une taille de fenêtre plus grande peut
+ améliorer la qualité de la compression mais consomme d'avantage de mémoire.
BrotliCompressionMaxInputBlock
-Taille maximale du bloc de données en entrée
+Taille maximale du bloc de données en entrée
BrotliCompressionMaxInputBlock value
(automatic)
server configvirtual host
@@ -277,15 +277,15 @@ CustomLog "logs/brotli_log" brotli
La directive BrotliCompressionMaxInputBlock permet
- de spécifier la taille maximale du bloc de données en entrée entre 16 et 24,
- sachant que plus cette taille sera grande, plus grande sera la quantité de
- mémoire consommée.
+ de spécifier la taille maximale du bloc de données en entrée entre 16 et 24,
+ sachant que plus cette taille sera grande, plus grande sera la quantité de
+ mémoire consommée.
BrotliAlterETag
-Comment l'en-tête de réponse ETag doit être modifié au cours de la
+Comment l'en-tête de réponse ETag doit être modifié au cours de la
compression
BrotliAlterETag AddSuffix|NoChange|Remove
BrotliAlterETag AddSuffix
@@ -294,26 +294,26 @@ compression
La directive BrotliAlterETag permet d'indiquer
- comment l'en-tête ETag doit être modifié lorsqu'une réponse est compressée.
+ comment l'en-tête ETag doit être modifié lorsqu'une réponse est compressée.
- AddSuffix
- Ajoute la méthode de compression à la fin de l'en-tête ETag, ce qui
- implique que les représentations compressées et non compressées possèderont
- des en-têtes ETag uniques. C'était le comportement par défaut depuis la
+
Ajoute la méthode de compression à la fin de l'en-tête ETag, ce qui
+ implique que les représentations compressées et non compressées possèderont
+ des en-têtes ETag uniques. C'était le comportement par défaut depuis la
version 2.4.0 avec un autre module de compression dynamique,
- mod-deflate. Ce paramètre permet d'éviter l'envoi de messages
- "HTTP Not Modified" (304) en réponse aux requêtes conditionnelles pour des
- contenus compressés.
+ mod-deflate. Ce paramètre permet d'éviter l'envoi de messages
+ "HTTP Not Modified" (304) en réponse aux requêtes conditionnelles pour des
+ contenus compressés.
- NoChange
- Ne modifie pas l'en-tête ETag d'une réponse compressée. C'était le
- comportement par défaut depuis la version 2.4.0 avec un autre module de
- compression dynamique, mod-deflate. Ce paramètre ne respecte pas la
- propriété HTTP/1.1 selon laquelle toutes les représentations d'une même
- ressource ont des en-têtes ETag uniques.
+ Ne modifie pas l'en-tête ETag d'une réponse compressée. C'était le
+ comportement par défaut depuis la version 2.4.0 avec un autre module de
+ compression dynamique, mod-deflate. Ce paramètre ne respecte pas la
+ propriété HTTP/1.1 selon laquelle toutes les représentations d'une même
+ ressource ont des en-têtes ETag uniques.
- Remove
- Supprime l'en-tête ETag des réponses compressées, ce qui rend
- impossibles certaines requêtes conditionnelles, mais évite les inconvénients
- des options précédentes.
+ Supprime l'en-tête ETag des réponses compressées, ce qui rend
+ impossibles certaines requêtes conditionnelles, mais évite les inconvénients
+ des options précédentes.
diff --git a/docs/manual/mod/mod_ext_filter.xml.fr b/docs/manual/mod/mod_ext_filter.xml.fr
index 8628d01e5cc..3a75795fc2c 100644
--- a/docs/manual/mod/mod_ext_filter.xml.fr
+++ b/docs/manual/mod/mod_ext_filter.xml.fr
@@ -1,7 +1,7 @@
-
+
@@ -25,35 +25,35 @@
mod_ext_filter
-Fait traiter le corps de la réponse par un programme
+Fait traiter le corps de la réponse par un programme
externe avant de l'envoyer au client
Extension
mod_ext_filter.c
ext_filter_module
- mod_ext_filter représente un modèle de
+
mod_ext_filter représente un modèle de
programmation simple et bien connu pour les filtres. 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 :
+ 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 :
- - le modèle de programmation est beaucoup plus simple
+ - le modèle de programmation est beaucoup plus simple
- - 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.
+ - 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.
- on peut utiliser des programmes existants comme filtres Apache
sans modification.
- Même dans le cas où le niveau de performance est insuffisant pour
+
Même dans le cas où le niveau de performance est insuffisant pour
une utilisation en production, on peut utiliser
mod_ext_filter comme prototype d'environnement pour
les filtres.
@@ -63,39 +63,39 @@ externe avant de l'envoyer au client
Exemples
- Générer du HTML à partir d'un autre type de
+ Générer du HTML à partir d'un autre type de
contenu
-# 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>
- Implémentation d'un filtre de codage de
+ Implémentation d'un filtre de codage de
contenu
- Note : cet exemple avec gzip n'est fourni qu'à titre
- d'illustration. Veuillez vous reporter à la documentation de
- mod_deflate pour un exemple d'implémentation plus
+
Note : cet exemple avec gzip n'est fourni qu'Ã titre
+ d'illustration. Veuillez vous reporter à la documentation de
+ mod_deflate pour un exemple d'implémentation plus
pratique.
-# 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=/bin/gzip
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>
@@ -114,10 +114,10 @@ ExtFilterDefine gzip mode=output cmd=/bin/gzip
Ralentissement du serveur
-# 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=/bin/cat \
Utilisation de sed pour remplacer du texte dans la
- réponse
+ réponse
-# 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 intype=text/html \
Vous pouvez aussi utiliser mod_substitute pour
-effectuer le même traitement sans avoir à invoquer un programme
+effectuer le même traitement sans avoir à invoquer un programme
externe.
@@ -158,8 +158,8 @@ externe.
Tracer un autre filtre
-# 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>
- Voici le filtre qui trace les données :
+ Voici le filtre qui trace les données :
#!/usr/local/bin/perl -w
use strict;
@@ -204,100 +204,100 @@ close(SAVE);
ExtFilterDefine
-Définit un filtre externe
-ExtFilterDefine nom_filtre paramètres
+Définit un filtre externe
+ExtFilterDefine nom_filtre paramètres
server config
La directive ExtFilterDefine
- définit les caractéristiques d'un filtre externe, et en particulier
- le programme à exécuter ainsi que ses arguments.
+ définit les caractéristiques d'un filtre externe, et en particulier
+ le programme à exécuter ainsi que ses arguments.
- nom_filtre spécifie le nom du filtre en cours de
- définition. On peut ensuite utiliser ce nom pour référencer le
+
nom_filtre 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 SetOutputFilter. Il doit être unique parmi les noms de
- tous les filtres enregistrés. 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. Il doit être unique parmi les noms de
+ tous les filtres enregistrés. 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.
- 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 cmd=. Voici la liste de ces paramètres :
+ 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 cmd=. Voici la liste de ces paramètres :
cmd=ligne de commande
- - Le mot-clé
cmd= spécifie la commande
- externe à exécuter. Si la ligne de commande comporte des
- arguments, elle doit être entourée de guillemets (par exemple
+ - Le mot-clé
cmd= spécifie la commande
+ externe à exécuter. Si la ligne de commande comporte des
+ arguments, elle doit être entourée de guillemets (par exemple
cmd="/bin/mypgm arg1
arg2"). 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.
+ DOCUMENT_PATH_INFO, et QUERY_STRING_UNESCAPED seront également
+ définies pour le programme.
mode=mode
- - Utilisez
mode=output (valeur par défaut) pour les
- filtres qui traitent les réponses. Utilisez
+ - Utilisez
mode=output (valeur par défaut) pour les
+ filtres qui traitent les réponses. Utilisez
mode=input pour les filtres qui traitent les
- requêtes. mode=input est disponible depuis la version
+ requêtes. mode=input est disponible depuis la version
2.1 d'Apache.
intype=type MIME
- - 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
-
intype= ne sera filtré.
+ - 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
+
intype= ne sera filtré.
outtype=type MIME
- - 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é.
+ - 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é.
PreservesContentLength
- - Le mot-clé
PreservesContentLength indique que le
+ - Le mot-clé
PreservesContentLength 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.
ftype=type de filtre
- - 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
+
- 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.
+ Voir les définitions de AP_FTYPE_...
+ dans util_filter.h pour trouver une valeur appropriée.
disableenv=env
- - Ce paramètre spécifie le nom d'une variable
- d'environnement qui, si elle est définie, va désactiver le
+
- Ce paramètre spécifie le nom d'une variable
+ d'environnement qui, si elle est définie, va désactiver le
filtre.
enableenv=env
- - 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é.
+ - 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é.
@@ -312,24 +312,24 @@ close(SAVE);
La directive ExtFilterOptions
- spécifie des options de traitement particulières pour
+ spécifie des options de traitement particulières pour
mod_ext_filter. Les arguments option
peuvent contenir :
LogStderr | NoLogStderr
- - Le mot-clé
LogStderr 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
+ - Le mot-clé
LogStderr 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. NoLogStderr inverse ce
comportement.
Onfail=[abort|remove]
- - Indique la marche à suivre si le programme de filtrage externe
- ne peut pas démarrer. Avec
abort (la valeur par
- défaut), le traitement de la requête sera abandonné. Avec remove, le
- filtre est supprimé, et le traitement de la requête se poursuit
+ - Indique la marche à suivre si le programme de filtrage externe
+ ne peut pas démarrer. Avec
abort (la valeur par
+ défaut), le traitement de la requête sera abandonné. Avec remove, le
+ filtre est supprimé, et le traitement de la requête se poursuit
sans lui.
@@ -337,8 +337,8 @@ close(SAVE);
ExtFilterOptions LogStderr
- Les messages envoyés vers la sortie d'erreurs standard du filtre
- seront enregistrés dans le journal des erreurs d'Apache.
+ Les messages envoyés vers la sortie d'erreurs standard du filtre
+ seront enregistrés dans le journal des erreurs d'Apache.
diff --git a/docs/manual/mod/mod_log_config.xml.fr b/docs/manual/mod/mod_log_config.xml.fr
index 3f6d7d81f4b..0f498a3807b 100644
--- a/docs/manual/mod/mod_log_config.xml.fr
+++ b/docs/manual/mod/mod_log_config.xml.fr
@@ -1,7 +1,7 @@
-
+
diff --git a/docs/manual/mod/mod_sed.xml.fr b/docs/manual/mod/mod_sed.xml.fr
index 6cd3c08bb72..0020d9c28b2 100644
--- a/docs/manual/mod/mod_sed.xml.fr
+++ b/docs/manual/mod/mod_sed.xml.fr
@@ -25,44 +25,44 @@
mod_sed
-Filtre les contenus en entrée (requêtes) et en sortie
-(réponses) en utilisant la syntaxe de sed
-Expérimental
+Filtre les contenus en entrée (requêtes) et en sortie
+(réponses) en utilisant la syntaxe de sed
+Expérimental
mod_sed.c sed0.c sed1.c regexp.c regexp.h sed.h
sed_module
Disponible depuis la version 2.3 d'Apache
mod_sed est un filtre de contenu "in-process". Le
-filtre mod_sed fournit les commandes d'édition de
-sed implémentées par le programme sed de
-Solaris 10 comme décrit dans la mod_sed fournit les commandes d'édition de
+sed implémentées par le programme sed de
+Solaris 10 comme décrit dans la page de
-manuel. Cependant, à la différence de sed,
-mod_sed 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. mod_sed peut être
-utilisé comme filtre en entrée ou en sortie. mod_sed
+manuel. Cependant, à la différence de sed,
+mod_sed 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. mod_sed peut être
+utilisé comme filtre en entrée ou en sortie. mod_sed
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.
-Le filtre en sortie mod_sed accepte un tronçon de
-données, exécute le script sed sur ces données, puis génère
-une sortie qui est transmise au filtre suivant dans la chaîne.
+Le filtre en sortie mod_sed accepte un tronçon de
+données, exécute le script sed sur ces données, puis génère
+une sortie qui est transmise au filtre suivant dans la chaîne.
-Le filtre en entrée mod_sed reçoit des données en
-provenance du filtre suivant dans la chaîne, exécute les scripts
-sed, et renvoie les données générées au filtre appelant
-dans la chaîne de filtrage.
+Le filtre en entrée mod_sed reçoit des données en
+provenance du filtre suivant dans la chaîne, exécute les scripts
+sed, et renvoie les données générées au filtre appelant
+dans la chaîne de filtrage.
-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.
@@ -70,8 +70,8 @@ données, ce qui reste est traité comme la dernière ligne.
Exemple de configuration
Ajout d'un filtre en sortie
-# 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
@@ -81,11 +81,11 @@ données, ce qui reste est traité comme la dernière ligne.
- Ajout d'un filtre en entrée
+ Ajout d'un filtre en entrée
- # 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"
@@ -96,13 +96,13 @@ données, ce qui reste est traité comme la dernière ligne.
Commandes sed
- Vous trouverez tous les détails à propos de la commande
+ Vous trouverez tous les détails à propos de la commande
sed dans sa page
de manuel.
b
- - Saut vers le label spécifié (similaire à goto).
+ - Saut vers le label spécifié (similaire à goto).
h
- Copie la ligne courante dans le tampon.
H
@@ -110,7 +110,7 @@ données, ce qui reste est traité comme la dernière ligne.
g
- Copie le contenu du tampon dans la ligne courante.
G
- - Ajoute le contenu du tampon à la ligne courante.
+ - Ajoute le contenu du tampon à la ligne courante.
x
- Echange les contenus du tampon et de la ligne courante.
@@ -119,31 +119,31 @@ données, ce qui reste est traité comme la dernière ligne.
OutputSed
Commande sed pour le filtrage des contenus de type
-réponse
+réponse
OutputSed commande-sed
directory.htaccess
- La directive OutputSed permet de spécifier
- la commande sed à exécuter dans le cadre du traitement
- d'une réponse.
+
La directive OutputSed permet de spécifier
+ la commande sed à exécuter dans le cadre du traitement
+ d'une réponse.
InputSed
-Commande sed à exécuter pour le filtrage des données d'une
-requête (en général des données POST)
+Commande sed à exécuter pour le filtrage des données d'une
+requête (en général des données POST)
InputSed commande-sed
directory.htaccess
- La directive InputSed permet de spécifier
- la commande sed à exécuter pour le filtrage des données (en général
- des données POST) d'une requête.
+
La directive InputSed permet de spécifier
+ la commande sed à exécuter pour le filtrage des données (en général
+ des données POST) d'une requête.
diff --git a/docs/manual/mod/mod_ssl.xml.fr b/docs/manual/mod/mod_ssl.xml.fr
index ca4cfd678ab..084a956e1b4 100644
--- a/docs/manual/mod/mod_ssl.xml.fr
+++ b/docs/manual/mod/mod_ssl.xml.fr
@@ -676,7 +676,7 @@ SSLSessionCacheTimeout 600
server config
virtual host
Le paramètre addr:port est disponible à partir de la
-version 2.4.30 du serveur HTTPApache.
+version 2.4.30 du serveur HTTP Apache.
Cette directive permet d'activer/désactiver le moteur du protocole SSL/TLS.
diff --git a/docs/manual/mod/mod_substitute.xml.fr b/docs/manual/mod/mod_substitute.xml.fr
index 2f488cffbb7..5185cd6a9db 100644
--- a/docs/manual/mod/mod_substitute.xml.fr
+++ b/docs/manual/mod/mod_substitute.xml.fr
@@ -1,7 +1,7 @@
-
+
@@ -45,6 +45,8 @@ réponse
directory
.htaccess
FileInfo
+Les valeurs de substitution "expr=" ont été ajoutées à partir de
+la version 2.5.1
La directive Substitute permet de
@@ -82,7 +84,10 @@ réponse
substitution peut contenir du texte et des références arrières
- d'expressions rationnelles.
+ d'expressions rationnelles. Si la valeur de substitution commence par la
+ chaîne expr=, elle est interprétée comme une expression rationnelle, ce qui permet d'utiliser des
+ variables d'environnement et des valeurs d'en-têtes.
Exemple
@@ -94,8 +99,13 @@ réponse
+ 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".
+
Si le modèle ou la chaîne de substitution contient un caractère
- slash '/', il faut utiliser un autre délimiteur :
+ slash '/', il est possible d'utiliser un autre délimiteur afin de rendre la
+ directive plus lisible :
Exemple d'utilisation d'un délimiteur
alternatif
@@ -120,6 +130,29 @@ réponse
+ Lorsque la valeur de substitution est spécifiée sous la forme
+ d'une expression rationnelle, les références
+ arrières doivent être échappées avec un backslash ('\') comme illustré dans
+ l'exemple suivant :
+ Exemple de substitution sous forme d'expression rationnelle
+
+<Location "/">
+ AddOutputFilterByType SUBSTITUTE text/html
+ Substitute "s/example.com/expr=%{HTTP:HOST}/i"
+ Substitute "s/Hello, (\S+)/expr=Hello from %{REQUEST_URI}, \$1/i"
+</Location>
+
+
+
+ Expressions rationnelles et mise en cache
+ La prudence s'impose lorsqu'on effectue des substitutions qui font
+ références à des en-têtes de requêtes HTTP. En effet, comme ce module agit
+ après l'envoi des en-têtes de la réponse, l'interpréteur d'expression n'est pas en mesure
+ d'ajouter les en-têtes de la requête HTTP référencés à l'en-tête Vary de
+ sortie.
+
+
Un scénario courant d'utilisation de mod_substitute
est la situation où un serveur frontal mandate des requêtes pour un
serveur d'arrière-plan qui renvoie des documents HTML contenant des
diff --git a/docs/manual/upgrading.xml.fr b/docs/manual/upgrading.xml.fr
index 07d35a241f3..6a729b1ed88 100644
--- a/docs/manual/upgrading.xml.fr
+++ b/docs/manual/upgrading.xml.fr
@@ -3,7 +3,7 @@
-
+
-
-Hébergement virtuel
- Hébergement virtuel de masse configuré dynamiquement
+Hébergement virtuel
+ Hébergement virtuel de masse configuré dynamiquement
- Ce document propose une méthode performante pour servir un nombre
- quelconque d'hôtes virtuels avec le serveur HTTP Apache. Un document séparé décrit comment
- utiliser mod_rewrite pour gérer l'hébergement
+
Ce document propose une méthode performante pour servir un nombre
+ quelconque d'hôtes virtuels avec le serveur HTTP Apache. Un document séparé décrit comment
+ utiliser mod_rewrite pour gérer l'hébergement
virtuel de masse dynamique.
-A qui ce document est-il destiné ?
+A qui ce document est-il destiné ?
- Les techniques décrites ici vous concernent si votre
+
Les techniques décrites ici vous concernent si votre
httpd.conf contient de nombreuses sections
- <VirtualHost> très semblables,
+ <VirtualHost> très semblables,
dans le style :
@@ -66,32 +65,32 @@
Nous voulons remplacer toutes les configurations
- <VirtualHost> par un mécanisme qui les génère
- dynamiquement. Ceci présente certains avantages :
+ <VirtualHost> par un mécanisme qui les génère
+ dynamiquement. Ceci présente certains avantages :
- 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.
- - 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.
+ - 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.
- 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 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 nombre important de descripteurs de
- fichier. Il est préférable de rediriger . Il est préférable de rediriger les journaux via un pipe ou
une file fifo 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 split-logfile
constitue un exemple de ce traitement.
@@ -100,73 +99,73 @@
Vue d'ensemble
- Un serveur virtuel peut être défini par deux informations : son
- adresse IP, et le contenu de l'en-tête Host: 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
+
Un serveur virtuel peut être défini par deux informations : son
+ adresse IP, et le contenu de l'en-tête Host: 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
mod_vhost_alias avec Apache httpd, mais on peut aussi
utiliser mod_rewrite.
- Par défaut, ces deux modules
- sont désactivés ; vous devez activer l'un d'eux lors de la
+
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.
- 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
- ServerName, et les CGIs peuvent s'y référer via la
- variable d'environnement SERVER_NAME. Sa véritable
- valeur utilisée à l'exécution est contrôlée par la définition de la
+
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
+ ServerName, et les CGIs peuvent s'y référer via la
+ variable d'environnement SERVER_NAME. Sa véritable
+ valeur utilisée à l'exécution est contrôlée par la définition de la
directive
UseCanonicalName. Avec
UseCanonicalName Off, le nom du serveur correspond au
- contenu de l'en-tête Host: de la requête. Avec
+ contenu de l'en-tête Host: de la requête. Avec
UseCanonicalName DNS, 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 Host:, 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 Host:, soit parce que la recherche
+ DNS a échoué, il prend en compte la valeur définie par la directive
ServerName.
- L'autre paramètre à extraire est la racine des documents (définie
+
L'autre paramètre à extraire est la racine des documents (définie
via la directive DocumentRoot et disponible pour les
scripts CGI via la variable d'environnement DOCUMENT_ROOT).
- 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
mod_vhost_alias, soit mod_rewrite), 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
DOCUMENT_ROOT, si des CGIs ou des documents SSI
- doivent en faire usage, ils obtiendront une valeur erronée.
+ doivent en faire usage, ils obtiendront une valeur erronée.
-Hébergement virtuel
+Hébergement virtuel
dynamique avec mod_vhost_alias
- Cet extrait de fichier httpd.conf implémente
- l'hébergement virtuel décrit dans la section À qui ce document est-il destiné ? ci-dessus
+
Cet extrait de fichier httpd.conf implémente
+ l'hébergement virtuel décrit dans la section à qui ce document est-il destiné ? ci-dessus
en utilisant mod_vhost_alias.
-# 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"
@@ -174,9 +173,9 @@ VirtualScriptAlias "/www/hosts/%0/cgi-bin"
Pour changer cette configuration en solution de serveur virtuel
par IP, il suffit de remplacer UseCanonicalName
Off par UseCanonicalName DNS. Le nom du serveur
- inséré dans le nom de fichier sera alors déduit de l'adresse IP du
- serveur virtuel. La variable %0 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 %0 fait référence au nom
+ de serveur de la requête, tel qu'il est indiqué dans l'en-tête
Host:.
Voir la documentation du module mod_vhost_alias
@@ -184,15 +183,15 @@ VirtualScriptAlias "/www/hosts/%0/cgi-bin"
-Système de serveurs virtuels dynamiques
-simplifié
+Système de serveurs virtuels dynamiques
+simplifié
- 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
- %2, on peut extraire des sous-chaînes de caractères du
+
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
+ %2, 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 /home/user/www comme emplacement des
- documents pour www.user.example.com. Un seul répertoire
+ exemple, de définir /home/user/www comme emplacement des
+ documents pour www.user.example.com. Un seul répertoire
cgi-bin suffit pour l'ensemble des
serveurs virtuels.
@@ -205,27 +204,27 @@ 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/"
- Vous trouverez des exemples plus élaborés d'utilisation de la
+
Vous trouverez des exemples plus élaborés d'utilisation de la
directive VirtualDocumentRoot dans la documentation du
module mod_vhost_alias.
-Utiliser plusieurs systèmes
-d'hébergement virtuel sur le même serveur
+Utiliser plusieurs systèmes
+d'hébergement virtuel sur le même serveur
- 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 <VirtualHost>
+
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 <VirtualHost>
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
- <VirtualHost> conventionnelles, comme indiqué
+ configuration peut être combinée avec les sections
+ <VirtualHost> conventionnelles, comme indiqué
plus loin.
@@ -245,18 +244,18 @@ LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
<VirtualHost 111.22.33.44>
ServerName www.commercial.example.com
-
+
CustomLog "logs/access_log.commercial" vcommon
-
+
VirtualDocumentRoot "/www/commercial/%0/docs"
VirtualScriptAlias "/www/commercial/%0/cgi-bin"
</VirtualHost>
<VirtualHost 111.22.33.45>
ServerName www.homepages.example.com
-
+
CustomLog "logs/access_log.homepages" vcommon
-
+
VirtualDocumentRoot "/www/homepages/%0/docs"
ScriptAlias "/cgi-bin/" "/www/std-cgi/"
</VirtualHost>
@@ -266,26 +265,26 @@ LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
Note
Si le premier bloc VirtualHost ne comporte pas de
directive ServerName, 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 ServerName
- none.example.com) pour éviter ce comportement.
+ none.example.com) pour éviter ce comportement.
-Pour un hébergement virtuel par IP plus
+Pour un hébergement virtuel par IP plus
efficace
- Les changements de configuration suggérés pour transformer le premier exemple 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.
+ Les changements de configuration suggérés pour transformer le premier exemple 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.
# obtention du nom du serveur par recherche DNS inverse
@@ -293,7 +292,7 @@ efficace
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
@@ -304,28 +303,28 @@ VirtualScriptAliasIP "/www/hosts/%0/cgi-bin"
-Hébergement virtuel de masse avec
+Hébergement virtuel de masse avec
mod_rewrite
-L'hébergement virtuel de masse peut aussi être effectué en utilisant
-mod_rewrite, soit à l'aide de simples directives mod_rewrite, soit à l'aide de simples directives RewriteRule, 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 RewriteMap. Ces
-techniques sont décrites dans la documentation sur la réécriture.
+techniques sont décrites dans la documentation sur la réécriture.
-Hébergement virtuel en masse avec mod_macro
+Hébergement virtuel en masse avec mod_macro
-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
-Usage de la documentation du module présente un exemple qui
-illustre cette méthode.
+
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
+Usage de la documentation du module présente un exemple qui
+illustre cette méthode.