From: Lucien Gentis Date: Thu, 4 Jan 2018 16:51:04 +0000 (+0000) Subject: XML updates. X-Git-Tag: 2.4.30~183 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=586c9382a719792073de91bec7202bc2a28fc71b;p=apache XML updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1820127 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/core.xml.fr b/docs/manual/mod/core.xml.fr index dec04ba27c..2799c4977d 100644 --- a/docs/manual/mod/core.xml.fr +++ b/docs/manual/mod/core.xml.fr @@ -1,7 +1,7 @@ - + @@ -2613,20 +2613,21 @@ Include conf/vhosts/*.conf IncludeOptional Inclusion de fichiers dans le fichier de configuration IncludeOptional -chemin-fichier|chemin-répertoire|wildcard +file-path|directory-path|wildcard server configvirtual host directory Disponible à partir de la version 2.3.6 du serveur HTTP -Apache +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

Cette directive permet d'inclure des fichiers dans les fichiers de configuration du serveur. Elle fonctionne de manière identique à - la directive Include, à - 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.

+ la directive Include, 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.

 @@ -5329,14 +5330,15 @@ comme si la directive QualifyRedirectURL était définie à ON. 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/mod_ext_filter.xml.fr b/docs/manual/mod/mod_ext_filter.xml.fr index 0719922430..386fafa8af 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 + <section><title>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 + <section><title>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_filter.xml.fr b/docs/manual/mod/mod_filter.xml.fr index bff6677be0..ce59f4b695 100644 --- a/docs/manual/mod/mod_filter.xml.fr +++ b/docs/manual/mod/mod_filter.xml.fr @@ -1,7 +1,7 @@ - + @@ -221,15 +221,15 @@ FilterChain gzip JPEG et PNG. 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> diff --git a/docs/manual/mod/mod_sed.xml.fr b/docs/manual/mod/mod_sed.xml.fr index b00c31d1e5..48ee4cc65c 100644 --- a/docs/manual/mod/mod_sed.xml.fr +++ b/docs/manual/mod/mod_sed.xml.fr @@ -1,7 +1,7 @@ - + @@ -25,59 +25,53 @@ 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.

-

Vous trouverez sur le blog de -l'auteur 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.

-
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 @@ -87,11 +81,11 @@ recherche/remplacement de chaîne ou d'expression rationnelle.

 - 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" @@ -102,13 +96,13 @@ recherche/remplacement de chaîne ou d'expression rationnelle.

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
@@ -116,7 +110,7 @@ recherche/remplacement de chaîne ou d'expression rationnelle.

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.
@@ -125,31 +119,31 @@ recherche/remplacement de chaîne ou d'expression rationnelle.

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_substitute.xml.fr b/docs/manual/mod/mod_substitute.xml.fr index b67469e29b..b1a1f2e3a4 100644 --- a/docs/manual/mod/mod_substitute.xml.fr +++ b/docs/manual/mod/mod_substitute.xml.fr @@ -1,7 +1,7 @@ - + @@ -95,8 +95,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 @@ -116,7 +121,7 @@ réponse <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> @@ -134,7 +139,7 @@ réponse Réécriture des URLs intégrées à un contenu mandaté -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" diff --git a/docs/manual/upgrading.xml.fr b/docs/manual/upgrading.xml.fr index c8805d33c6..13e1a8dc53 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 :

@@ -64,107 +64,107 @@

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 :

  1. 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.
    2. -
  2. 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.
    3. +
  3. 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 + href="../programs/split-logfile.html">split-logfile constitue un exemple de ce traitement.

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 +<section id="simple"><title>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" @@ -172,9 +172,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 @@ -182,15 +182,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.

@@ -198,32 +198,32 @@ simplifié 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/" -

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.

@@ -264,26 +264,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 +<section id="ipbased"><title>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 @@ -291,7 +291,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 @@ -302,19 +302,29 @@ VirtualScriptAliasIP "/www/hosts/%0/cgi-bin"
-
Hébergement virtuel de masse avec +<section id="rewrite"><title>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 +

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. +