From: Vincent Deffontaines Date: Sun, 27 Jan 2013 07:39:16 +0000 (+0000) Subject: [Documentation] Adding a number of french translation for some module documentation X-Git-Tag: 2.4.4~74 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=5e0b12350a0c596cb4ce866cfa17e1069002db56;p=apache [Documentation] Adding a number of french translation for some module documentation git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1439038 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_cgi.html b/docs/manual/mod/mod_cgi.html index f57e574b1b..52ef69efd1 100644 --- a/docs/manual/mod/mod_cgi.html +++ b/docs/manual/mod/mod_cgi.html @@ -4,6 +4,10 @@ URI: mod_cgi.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_cgi.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_cgi.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_cgi.html.fr b/docs/manual/mod/mod_cgi.html.fr new file mode 100644 index 0000000000..1d88ef2d32 --- /dev/null +++ b/docs/manual/mod/mod_cgi.html.fr @@ -0,0 +1,288 @@ + + + +mod_cgi - Serveur Apache HTTP + + + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_cgi

Langues Disponibles: en | + fr | + ja | + ko

+ + + +

Description:	Exécution des scripts CGI
Statut:	Base
Identificateur de Module:	cgi_module
Fichier Source:	mod_cgi.c

Sommaire

+ +

Tout fichier pris en compte par le gestionnaire + cgi-script sera traité en tant que script CGI et + exécuté par le serveur, sa sortie étant renvoyée au client. Les + fichiers sont associés à ce gestionnaire soit parce qu'ils possèdent + un nom contenant une extension définie par la directive AddHandler, soit parce qu'ils se + situent dans un répertoire défini par une directive ScriptAlias.

+ +

Comme introduction à l'utilisation des scripts CGI avec Apache, + voir notre tutoriel Les contenus + dynamiques avec CGI.

+ +

Il est recommandé d'utiliser le module mod_cgid + à la place de mod_cgi lorsqu'on utilise un module MPM + multi-threadé sous Unix. Vus de l'utilisateur, les deux modules + sont pratiquement identiques.

+ +

À des fins de compatibilité ascendante, le gestionnaire + cgi-script sera aussi activé pour tout fichier possédant le type + MIME application/x-httpd-cgi. L'utilisation du type + MIME magic est obsolète.

Les variables d'environnement CGI

Le serveur va définir les variables d'environnement CGI comme + décrit dans la Spécification CGI, de la + manière suivante :

+ +

PATH_INFO: Cette variable ne sera pas disponible si la directive + AcceptPathInfo est + explicitement définie à off. Par défaut, si la + directive AcceptPathInfo n'est pas définie, + mod_cgi acceptera des informations de chemin (en + ajoutant /infos/chemin après le nom du script dans l'URI), alors + que le serveur de base retournera une erreur 404 NOT FOUND pour + les requêtes contenant des informations de chemin supplémentaires. + Ne pas définir la directive AcceptPathInfo + a le même effet sur les requêtes avec mod_cgi que + de la définir à On.
REMOTE_HOST: Cette variable ne sera définie que si la directive HostnameLookups est définie à + on (elle est à off par défaut), et si + une recherche DNS inverse sur l'adresse IP de l'hôte client + aboutit effectivement à un nom d'hôte.
REMOTE_IDENT: Cette variable ne sera définie que si la directive IdentityCheck + est définie à on, et si l'hôte client supporte le + protocole ident. Notez que l'on ne peut accorder une confiance + aveugle au contenu de cette variable car il peut être aisément + falsifié, et si un mandataire s'intercale entre le client et le + serveur, il est totalement inutilisable.
REMOTE_USER: Cette variable ne sera définie que si le script CGI fait + l'objet d'une authentification.

Débogage des scripts CGI

Le débogage des scripts CGI était difficile par le passé, + principalement parce qu'il n'était pas possible d'étudier la sortie + (sortie standard et erreurs) des scripts dont l'exécution échouait. + Les directives qui suivent permettent une journalisation plus détaillée des + erreurs.

+ +

Format du fichier journal CGI

Lorsqu'il est configuré, le journal des erreurs CGI enregistre + la sortie de tout programme CGI dont l'exécution ne s'effectue pas + correctement. Un script CGI dont l'exécution échoue provoque la + journalisation d'une grande quantité d'informations. Les deux + premières lignes possèdent toujours le format suivant :

+ +

+ %% [date] requête + %% état HTTP nom du script CGI +

+ +

Si le script CGI n'a pas pu démarrer, le fichier journal + contiendra les deux lignes supplémentaires suivantes :

+ +

+ %%erreur + message d'erreur +

+ +

Par contre, si l'erreur provient du renvoi par le script + d'informations incorrectes dans les en-têtes (dû souvent à une + bogue du script), les informations suivantes sont journalisées + :

+ +

+ %requête + Tous les en-têtes de requête HTTP reçus + Les entités POST ou PUT (s'il en existe) + %réponse + Tous les en-têtes générés par le script CGI + %stdout + la sortie standard CGI + %stderr + la sortie d'erreurs standard CGI +

+ +

(Les parties %stdout et %stderr seront absentes si le script + n'a rien envoyé sur la sortie standard ou la sortie + d'erreurs).

+ +

ScriptLog Directive

+ + + + + + +

Description:	Chemin du fichier journal des erreurs du script +CGI
Syntaxe:	`ScriptLog chemin fichier`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	`mod_cgi`, `mod_cgid`

La directive ScriptLog permet de définir + le chemin du fichier journal des erreurs du script CGI. Si cette + directive n'est pas définie, aucune journalisation des erreurs n'est + effectuée. Si elle est définie, toute erreur CGI sera enregistrée + dans le fichier dont le nom est fourni en argument. S'il s'agit d'un + chemin de fichier relatif, il est considéré par rapport au + répertoire défini par la directive ServerRoot. +

+ +

Exemple

+      ScriptLog logs/cgi_log
+

+ +

Ce journal sera ouvert par l'utilisateur sous lequel les + processus enfants s'exécutent, c'est à dire l'utilisateur spécifié + par la directive du serveur User. Ceci implique que le + répertoire dans lequel se trouve le journal doit être accessible en + écriture pour cet utilisateur, ou bien que le fichier est créé + manuellement et accessible en écriture pour cet utilisateur. Si vous + placez le journal du script dans votre répertoire principal des + journaux, ne modifiez JAMAIS les permissions de ce + dernier afin de le le rendre accessible en écriture par + l'utilisateur sous lequel les processus enfants s'exécutent.

+ +

Notez que l'on ne doit activer la journalisation des scripts + qu'à des fins de débogage lors de l'écriture de scripts CGI, et non + de manière permanente sur un serveur en production. Elle n'est pas + optimisée en terme de performances et d'efficacité, et peut + présenter des problèmes de sécurité si on l'utilise dans un cadre + autre que celui pour lequel elle a été conçue.

+ +

ScriptLogBuffer Directive

+ + + + + + + +

Description:	Taille maximale des requêtes PUT ou POST qui seront +enregistrées dans le journal du script
Syntaxe:	`ScriptLogBuffer octets`
Défaut:	`ScriptLogBuffer 1024`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	`mod_cgi`, `mod_cgid`

Cette directive permet de limiter la taille du corps de toute + entité PUT ou POST qui sera enregistrée dans le journal, afin + de prévenir une croissance trop importante et trop rapide du fichier + journal due à la réception de corps de requête de grandes tailles. + Cette directive permet de modifier cette taille maximale, dont la + valeur par défaut est de 1024 octets.

+ +

ScriptLogLength Directive

+ + + + + + + +

Description:	Taille maximale du fichier journal des scripts +CGI
Syntaxe:	`ScriptLogLength octets`
Défaut:	`ScriptLogLength 10385760`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	`mod_cgi`, `mod_cgid`

La directive ScriptLogLength permet de + définir la taille maximale du fichier journal des scripts CGI. Comme + le fichier journal accumule une grande quantité d'informations par + erreur CGI (tous les en-têtes de la requête, toutes les sorties du + script), il peut vite atteindre une grande taille. En limitant la + taille du fichier, cette directive permet d'éviter les problèmes que + causerait sa croissance sans limites. Lorsque le fichier a atteint + cette taille maximale, plus aucune information n'y est + enregistrée.

+ +

Langues Disponibles: en | + fr | + ja | + ko

Commentaires

Notice:
This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_cgi.xml.fr b/docs/manual/mod/mod_cgi.xml.fr new file mode 100644 index 0000000000..3fcb1e2f40 --- /dev/null +++ b/docs/manual/mod/mod_cgi.xml.fr @@ -0,0 +1,256 @@ + + + + + + + + + + + +mod_cgi +Exécution des scripts CGI +Base +mod_cgi.c +cgi_module + +

Tout fichier pris en compte par le gestionnaire + cgi-script sera traité en tant que script CGI et + exécuté par le serveur, sa sortie étant renvoyée au client. Les + fichiers sont associés à ce gestionnaire soit parce qu'ils possèdent + un nom contenant une extension définie par la directive AddHandler, soit parce qu'ils se + situent dans un répertoire défini par une directive ScriptAlias.

+ +

Comme introduction à l'utilisation des scripts CGI avec Apache, + voir notre tutoriel Les contenus + dynamiques avec CGI.

+ +

Il est recommandé d'utiliser le module mod_cgid + à la place de mod_cgi lorsqu'on utilise un module MPM + multi-threadé sous Unix. Vus de l'utilisateur, les deux modules + sont pratiquement identiques.

+ +

+ +AcceptPathInfo +Options ExecCGI +ScriptAlias +AddHandler +Exécuter des programmes CGI sous des +utilisateurs différents +La spécification +CGI + +

Les variables d'environnement CGI +

Le serveur va définir les variables d'environnement CGI comme + décrit dans la Spécification CGI, de la + manière suivante :

+ +

PATH_INFO: Cette variable ne sera pas disponible si la directive + AcceptPathInfo est + explicitement définie à off. Par défaut, si la + directive AcceptPathInfo n'est pas définie, + mod_cgi acceptera des informations de chemin (en + ajoutant /infos/chemin après le nom du script dans l'URI), alors + que le serveur de base retournera une erreur 404 NOT FOUND pour + les requêtes contenant des informations de chemin supplémentaires. + Ne pas définir la directive AcceptPathInfo + a le même effet sur les requêtes avec mod_cgi que + de la définir à On.
REMOTE_HOST: Cette variable ne sera définie que si la directive HostnameLookups est définie à + on (elle est à off par défaut), et si + une recherche DNS inverse sur l'adresse IP de l'hôte client + aboutit effectivement à un nom d'hôte.
REMOTE_IDENT: Cette variable ne sera définie que si la directive IdentityCheck + est définie à on, et si l'hôte client supporte le + protocole ident. Notez que l'on ne peut accorder une confiance + aveugle au contenu de cette variable car il peut être aisément + falsifié, et si un mandataire s'intercale entre le client et le + serveur, il est totalement inutilisable.
REMOTE_USER: Cette variable ne sera définie que si le script CGI fait + l'objet d'une authentification.

+ +

Débogage des scripts CGI +

+ +

Format du fichier journal CGI +

+ + + %% [date] requête
+ %% état HTTP nom du script CGI + + +

Si le script CGI n'a pas pu démarrer, le fichier journal + contiendra les deux lignes supplémentaires suivantes :

+ + + %%erreur
+ message d'erreur + + +

Par contre, si l'erreur provient du renvoi par le script + d'informations incorrectes dans les en-têtes (dû souvent à une + bogue du script), les informations suivantes sont journalisées + :

+ + + %requête
+ Tous les en-têtes de requête HTTP reçus
+ Les entités POST ou PUT (s'il en existe)
+ %réponse
+ Tous les en-têtes générés par le script CGI
+ %stdout
+ la sortie standard CGI
+ %stderr
+ la sortie d'erreurs standard CGI
+ + +

(Les parties %stdout et %stderr seront absentes si le script + n'a rien envoyé sur la sortie standard ou la sortie + d'erreurs).

+ + +ScriptLog +Chemin du fichier journal des erreurs du script +CGI +ScriptLog chemin fichier +server config +virtual host +mod_cgimod_cgid + + + +

La directive ScriptLog permet de définir + le chemin du fichier journal des erreurs du script CGI. Si cette + directive n'est pas définie, aucune journalisation des erreurs n'est + effectuée. Si elle est définie, toute erreur CGI sera enregistrée + dans le fichier dont le nom est fourni en argument. S'il s'agit d'un + chemin de fichier relatif, il est considéré par rapport au + répertoire défini par la directive ServerRoot. +

+ + Exemple + + ScriptLog logs/cgi_log + + + +

Ce journal sera ouvert par l'utilisateur sous lequel les + processus enfants s'exécutent, c'est à dire l'utilisateur spécifié + par la directive du serveur User. Ceci implique que le + répertoire dans lequel se trouve le journal doit être accessible en + écriture pour cet utilisateur, ou bien que le fichier est créé + manuellement et accessible en écriture pour cet utilisateur. Si vous + placez le journal du script dans votre répertoire principal des + journaux, ne modifiez JAMAIS les permissions de ce + dernier afin de le le rendre accessible en écriture par + l'utilisateur sous lequel les processus enfants s'exécutent.

+ +

+ + + + +ScriptLogLength +Taille maximale du fichier journal des scripts +CGI +ScriptLogLength octets +ScriptLogLength 10385760 +server config +virtual host +mod_cgimod_cgid + + + +

La directive ScriptLogLength permet de + définir la taille maximale du fichier journal des scripts CGI. Comme + le fichier journal accumule une grande quantité d'informations par + erreur CGI (tous les en-têtes de la requête, toutes les sorties du + script), il peut vite atteindre une grande taille. En limitant la + taille du fichier, cette directive permet d'éviter les problèmes que + causerait sa croissance sans limites. Lorsque le fichier a atteint + cette taille maximale, plus aucune information n'y est + enregistrée.

+ + + + +ScriptLogBuffer +Taille maximale des requêtes PUT ou POST qui seront +enregistrées dans le journal du script +ScriptLogBuffer octets +ScriptLogBuffer 1024 +server config +virtual host +mod_cgimod_cgid + + + +

+ + + + diff --git a/docs/manual/mod/mod_cgi.xml.meta b/docs/manual/mod/mod_cgi.xml.meta index 25dc5c1c51..471e11f8df 100644 --- a/docs/manual/mod/mod_cgi.xml.meta +++ b/docs/manual/mod/mod_cgi.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko diff --git a/docs/manual/mod/mod_cgid.html b/docs/manual/mod/mod_cgid.html index 33fcb3495a..e6a8efa3a4 100644 --- a/docs/manual/mod/mod_cgid.html +++ b/docs/manual/mod/mod_cgid.html @@ -4,6 +4,10 @@ URI: mod_cgid.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_cgid.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_cgid.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_cgid.html.fr b/docs/manual/mod/mod_cgid.html.fr new file mode 100644 index 0000000000..6e9d76aa89 --- /dev/null +++ b/docs/manual/mod/mod_cgid.html.fr @@ -0,0 +1,141 @@ + + + +mod_cgid - Serveur Apache HTTP + + + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_cgid

Langues Disponibles: en | + fr | + ja | + ko

+ + + + +

Description:	Exécution des scripts CGI par l'intermédiaire d'un démon +CGI externe
Statut:	Base
Identificateur de Module:	cgid_module
Fichier Source:	mod_cgid.c
Compatibilité:	Uniquement compatible avec les MPMs Unix +threadés

Sommaire

+ +

Exceptées les optimisations et la directive additionnelle + ScriptSock décrite + ci-dessous, mod_cgid a un comportement similaire à + celui de mod_cgi. Voir le résumé de + mod_cgi pour plus de détails à propos d'Apache et + CGI.

+ +

Sur certains systèmes d'exploitation de type unix, le lancement + (forking) d'un processus depuis un serveur multi-threadé est une + opération très lourde car le nouveau processus va répliquer tous les + threads du processus parent. Pour éviter cette dépense de ressouces + pour chaque invocation d'un programme CGI, mod_cgid + crée un démon externe qui est responsable du branchement de + processus enfants destinés au lancement de scripts CGI. Le serveur + principal communique avec ce démon par l'intermédiaire d'une socket + de domaine unix.

+ +

Si un MPM multi-threadé a été sélectionné lors du processus de + compilation, c'est ce module qui est utilisé par défaut à la place + de mod_cgi. Du point de vue de l'utilisateur, ce + module est identique à mod_cgi quant à sa + configuration et son utilisation. La seule différence est la + directive additionnelle ScriptSock qui permet de + définir le nom du socket à utiliser pour la communication avec le + démon CGI.

Directives

Voir aussi

Commentaires

+ +

ScriptSock Directive

+ + + + + + + +

Description:	Le préfixe du nom de fichier du socket à utiliser pour +communiquer avec le démon CGI
Syntaxe:	`ScriptSock chemin fichier`
Défaut:	`ScriptSock cgisock`
Contexte:	configuration du serveur
Statut:	Base
Module:	mod_cgid

Cette directive permet de définir le préfixe du nom de fichier de la + socket à utiliser pour communiquer avec le démon CGI, préfixe auquel + sera ajouté une extension correspondant à l'identifiant processus du + serveur. La socket sera ouverte avec les permissions de l'utilisateur + qui a démarré Apache (en général root). Afin de préserver la + sécurité des communications avec les scripts CGI, il est impératif + de n'accorder à aucun autre utilisateur la permission d'écrire dans + le répertoire où se trouve la socket.

+ +

Si chemin fichier n'est pas un chemin absolu, il est + relatif au chemin défini par la directive DefaultRuntimeDir.

+ +

Exemple

+      ScriptSock /var/run/cgid.sock
+

+ + +

Langues Disponibles: en | + fr | + ja | + ko

Commentaires

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_cgid.xml.fr b/docs/manual/mod/mod_cgid.xml.fr new file mode 100644 index 0000000000..c37c8404e8 --- /dev/null +++ b/docs/manual/mod/mod_cgid.xml.fr @@ -0,0 +1,112 @@ + + + + + + + + + + + +mod_cgid +Exécution des scripts CGI par l'intermédiaire d'un démon +CGI externe +Base +mod_cgid.c +cgid_module +Uniquement compatible avec les MPMs Unix +threadés + +

Exceptées les optimisations et la directive additionnelle + ScriptSock décrite + ci-dessous, mod_cgid a un comportement similaire à + celui de mod_cgi. Voir le résumé de + mod_cgi pour plus de détails à propos d'Apache et + CGI.

+ +

Sur certains systèmes d'exploitation de type unix, le lancement + (forking) d'un processus depuis un serveur multi-threadé est une + opération très lourde car le nouveau processus va répliquer tous les + threads du processus parent. Pour éviter cette dépense de ressouces + pour chaque invocation d'un programme CGI, mod_cgid + crée un démon externe qui est responsable du branchement de + processus enfants destinés au lancement de scripts CGI. Le serveur + principal communique avec ce démon par l'intermédiaire d'une socket + de domaine unix.

+ +

Si un MPM multi-threadé a été sélectionné lors du processus de + compilation, c'est ce module qui est utilisé par défaut à la place + de mod_cgi. Du point de vue de l'utilisateur, ce + module est identique à mod_cgi quant à sa + configuration et son utilisation. La seule différence est la + directive additionnelle ScriptSock qui permet de + définir le nom du socket à utiliser pour la communication avec le + démon CGI.

+ +mod_cgi +Exécution de programmes CGI sous des +utilisateurs différents + + +ScriptLog + + + +ScriptLogLength + + + +ScriptLogBuffer + + + +ScriptSock +Le préfixe du nom de fichier du socket à utiliser pour +communiquer avec le démon CGI +ScriptSock chemin fichier +ScriptSock cgisock +server config + + +

+ +

Si chemin fichier n'est pas un chemin absolu, il est + relatif au chemin défini par la directive DefaultRuntimeDir.

+ + Exemple + + ScriptSock /var/run/cgid.sock + + + + + + + + diff --git a/docs/manual/mod/mod_cgid.xml.meta b/docs/manual/mod/mod_cgid.xml.meta index d460d8ef4a..edab4a7201 100644 --- a/docs/manual/mod/mod_cgid.xml.meta +++ b/docs/manual/mod/mod_cgid.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko diff --git a/docs/manual/mod/mod_charset_lite.html b/docs/manual/mod/mod_charset_lite.html index 626fcac8b9..2fbf3af75e 100644 --- a/docs/manual/mod/mod_charset_lite.html +++ b/docs/manual/mod/mod_charset_lite.html @@ -4,6 +4,10 @@ URI: mod_charset_lite.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_charset_lite.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_charset_lite.html.ko.euc-kr Content-Language: ko Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/mod/mod_charset_lite.html.fr b/docs/manual/mod/mod_charset_lite.html.fr new file mode 100644 index 0000000000..3aa1bf2ea5 --- /dev/null +++ b/docs/manual/mod/mod_charset_lite.html.fr @@ -0,0 +1,252 @@ + + + +mod_charset_lite - Serveur Apache HTTP + + + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_charset_lite

Langues Disponibles: en | + fr | + ko

+ + + +

Description:	Spécifie dans quel jeu de caractère doivent s'effectuer les +traductions ou les réencodages
Statut:	Extension
Identificateur de Module:	charset_lite_module
Fichier Source:	mod_charset_lite.c

Sommaire

+ +

Le module mod_charset_lite permet au serveur de + modifier le jeu de caractères des réponses avant de les envoyer aux + clients. Dans un environnement EBCDIC, Apache traduit toujours les + contenus au protocole HTTP (par exemples les en-têtes de réponses) + de la page de code de la locale du processus Apache vers ISO-8859-1, + mais pas le corps des réponses. Dans tous les environnements, on + peut utiliser mod_charset_lite pour spécifier que + les corps des réponses doivent être traduits. Par exemple, si les + fichiers sont stockés sous forme EBCDIC, + mod_charset_lite pourra les traduire en ISO-8859-1 + avant de les envoyer au client.

+ +

Ce module fournit quelques procédés de configuration implémentés + par Apache version russe, ainsi que son module + mod_charset associé.

Sujets

Problèmes courants

Commentaires

Problèmes courants

+ +

Noms de jeux de caractères non valides

+ +

Les noms des jeux de caractères passés en paramètres aux + directives CharsetSourceEnc et + CharsetDefault + doivent être reconnus par le mécanisme de traduction utilisé par + APR sur le système où + mod_charset_lite est utilisé. Ces noms de jeux de + caractères ne sont pas standardisés, et sont en général différents + des valeurs qui leur correspondent dans les en-têtes HTTP. + Actuellement, APR ne peut utiliser que iconv(3) ; vous pouvez donc + tester facilement vos noms de jeux de caractères en utilisant le + programme iconv(1), de la manière suivante :

+ +

+ iconv -f valeur-charsetsourceenc -t valeur-charsetdefault +

+ + +

Incompatibilité entre le jeu de caractères du + contenu et les règles de traduction

+ +

Si les règles de traduction ne peuvent s'appliquer au contenu, + la traduction peut échouer avec des conséquences diverses, comme + :

+ +

Le mécanisme de traduction peut renvoyer un mauvais code de + retour, et la connexion sera interrompue.
Le mécanisme de traduction peut insérer silencieusement des + caractères spéciaux (par exemple des points d'interrogation) dans + le tampon de sortie lorsqu'il n'est pas en mesure de traduire le + tampon d'entrée.

+ +

CharsetDefault Directive

+ + + + + + + +

Description:	Jeu de caractère vers lequel la traduction doit +s'effectuer
Syntaxe:	`CharsetDefault jeu de caractères`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
AllowOverride:	FileInfo
Statut:	Extension
Module:	mod_charset_lite

La directive CharsetDefault permet de + spécifier le jeu de caractères vers lequel le contenu situé dans le + conteneur associé devra être traduit.

+ +

La valeur de l'argument jeu de caractères doit être + un nom de jeu de caractères valide du point de vue du support des + jeux de caractères dans APR. En général, cela + implique qu'elle doit être reconnue par iconv.

+ +

Exemple

+<Directory /export/home/trawick/apacheinst/htdocs/convert>
+    CharsetSourceEnc  UTF-16BE
+    CharsetDefault    ISO-8859-1
+</Directory>
+

+ +

+ Spécifier le même jeu de caractères pour les deux directives + CharsetSourceEnc + et CharsetDefault + désactive la traduction. Le jeu de caractères ne doit pas forcément + correspondre au jeu de caractères de la réponse, mais il doit être + valide du point de vue du système. +

+ +

CharsetOptions Directive

+ + + + + + + + +

Description:	Précise les détails de la traduction du jeu de +caractères
Syntaxe:	`CharsetOptions option [option] ...`
Défaut:	`CharsetOptions ImplicitAdd`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
AllowOverride:	FileInfo
Statut:	Extension
Module:	mod_charset_lite

La directive CharsetOptions permet de + préciser certains détails du comportement du module + mod_charset_lite. Option accepte les + valeurs suivantes :

+ +

ImplicitAdd | NoImplicitAdd: Le mot-clé ImplicitAdd indique que + mod_charset_lite doit insérer son filtre de + manière implicite lorsque la configuration indique que le jeu de + caractère du contenu doit être traduit. Si la chaîne de filtrage + est configurée de manière explicite via la directive AddOutputFilter, l'option + NoImplicitAdd doit être utilisée afin que + mod_charset_lite n'ajoute pas son propre + filtre.
TranslateAllMimeTypes | NoTranslateAllMimeTypes: Normalement, mod_charset_lite n'effectuera + une traduction qu'en présence d'un petit nombre de types MIME + parmi tous les types possibles. Lorsque l'option + TranslateAllMimeTypes est utilisée pour une section + de configuration donnée, la traduction est effectuée sans se + préoccuper du type MIME.

+ +

CharsetSourceEnc Directive

+ + + + + + + +

Description:	Jeu de caractères source des fichiers
Syntaxe:	`CharsetSourceEnc jeu de caractères`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
AllowOverride:	FileInfo
Statut:	Extension
Module:	mod_charset_lite

La directive CharsetSourceEnc permet de + spécifier un jeu de caractères source pour les fichiers situés dans + le conteneur associé.

+ +

Exemple

+<Directory /export/home/trawick/apacheinst/htdocs/convert>
+    CharsetSourceEnc  UTF-16BE
+    CharsetDefault    ISO-8859-1
+</Directory>
+

+ +

Les noms de jeux de caractères de cet exemple sont reconnus par + le mécanisme de traduction d'iconv sous Solaris 8.

+ +

Langues Disponibles: en | + fr | + ko

Commentaires

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_charset_lite.xml.fr b/docs/manual/mod/mod_charset_lite.xml.fr new file mode 100644 index 0000000000..72bbd6c20a --- /dev/null +++ b/docs/manual/mod/mod_charset_lite.xml.fr @@ -0,0 +1,220 @@ + + + + + + + + + + + +mod_charset_lite +Spécifie dans quel jeu de caractère doivent s'effectuer les +traductions ou les réencodages +Extension +mod_charset_lite.c +charset_lite_module + +

Le module mod_charset_lite permet au serveur de + modifier le jeu de caractères des réponses avant de les envoyer aux + clients. Dans un environnement EBCDIC, Apache traduit toujours les + contenus au protocole HTTP (par exemples les en-têtes de réponses) + de la page de code de la locale du processus Apache vers ISO-8859-1, + mais pas le corps des réponses. Dans tous les environnements, on + peut utiliser mod_charset_lite pour spécifier que + les corps des réponses doivent être traduits. Par exemple, si les + fichiers sont stockés sous forme EBCDIC, + mod_charset_lite pourra les traduire en ISO-8859-1 + avant de les envoyer au client.

+ +

Ce module fournit quelques procédés de configuration implémentés + par Apache version russe, ainsi que son module + mod_charset associé.

+ +

Problèmes courants + +

Noms de jeux de caractères non valides + +

Les noms des jeux de caractères passés en paramètres aux + directives CharsetSourceEnc et + CharsetDefault + doivent être reconnus par le mécanisme de traduction utilisé par + APR sur le système où + mod_charset_lite est utilisé. Ces noms de jeux de + caractères ne sont pas standardisés, et sont en général différents + des valeurs qui leur correspondent dans les en-têtes HTTP. + Actuellement, APR ne peut utiliser que iconv(3) ; vous pouvez donc + tester facilement vos noms de jeux de caractères en utilisant le + programme iconv(1), de la manière suivante :

+ + + iconv -f valeur-charsetsourceenc -t valeur-charsetdefault + +

+ +

Incompatibilité entre le jeu de caractères du + contenu et les règles de traduction + +

Si les règles de traduction ne peuvent s'appliquer au contenu, + la traduction peut échouer avec des conséquences diverses, comme + :

+ +

Le mécanisme de traduction peut renvoyer un mauvais code de + retour, et la connexion sera interrompue.
Le mécanisme de traduction peut insérer silencieusement des + caractères spéciaux (par exemple des points d'interrogation) dans + le tampon de sortie lorsqu'il n'est pas en mesure de traduire le + tampon d'entrée.

+ + +CharsetSourceEnc +Jeu de caractères source des fichiers +CharsetSourceEnc jeu de caractères +server config +virtual hostdirectory +.htaccess + +FileInfo + + +

La directive CharsetSourceEnc permet de + spécifier un jeu de caractères source pour les fichiers situés dans + le conteneur associé.

+ +

+ + Exemple + +<Directory /export/home/trawick/apacheinst/htdocs/convert> + CharsetSourceEnc UTF-16BE + CharsetDefault ISO-8859-1 +</Directory> + + + +

Les noms de jeux de caractères de cet exemple sont reconnus par + le mécanisme de traduction d'iconv sous Solaris 8.

+ + + Spécifier le même jeu de caractères pour les deux directives + CharsetSourceEnc + et CharsetDefault + désactive la traduction. Le jeu de caractères ne doit pas forcément + correspondre au jeu de caractères de la réponse, mais il doit être + valide du point de vue du système. + + + + + +CharsetDefault +Jeu de caractère vers lequel la traduction doit +s'effectuer +CharsetDefault jeu de caractères +server config +virtual hostdirectory +.htaccess + +FileInfo + + +

La directive CharsetDefault permet de + spécifier le jeu de caractères vers lequel le contenu situé dans le + conteneur associé devra être traduit.

+ +

+ + Exemple + +<Directory /export/home/trawick/apacheinst/htdocs/convert> + CharsetSourceEnc UTF-16BE + CharsetDefault ISO-8859-1 +</Directory> + + + + + Spécifier le même jeu de caractères pour les deux directives + CharsetSourceEnc + et CharsetDefault + désactive la traduction. Le jeu de caractères ne doit pas forcément + correspondre au jeu de caractères de la réponse, mais il doit être + valide du point de vue du système. + + + + + +CharsetOptions +Précise les détails de la traduction du jeu de +caractères +CharsetOptions option [option] ... +CharsetOptions ImplicitAdd +server config +virtual hostdirectory +.htaccess + +FileInfo + + +

La directive CharsetOptions permet de + préciser certains détails du comportement du module + mod_charset_lite. Option accepte les + valeurs suivantes :

+ +

ImplicitAdd | NoImplicitAdd: Le mot-clé ImplicitAdd indique que + mod_charset_lite doit insérer son filtre de + manière implicite lorsque la configuration indique que le jeu de + caractère du contenu doit être traduit. Si la chaîne de filtrage + est configurée de manière explicite via la directive AddOutputFilter, l'option + NoImplicitAdd doit être utilisée afin que + mod_charset_lite n'ajoute pas son propre + filtre.
TranslateAllMimeTypes | NoTranslateAllMimeTypes: Normalement, mod_charset_lite n'effectuera + une traduction qu'en présence d'un petit nombre de types MIME + parmi tous les types possibles. Lorsque l'option + TranslateAllMimeTypes est utilisée pour une section + de configuration donnée, la traduction est effectuée sans se + préoccuper du type MIME.

+ + + + diff --git a/docs/manual/mod/mod_charset_lite.xml.meta b/docs/manual/mod/mod_charset_lite.xml.meta index 77029e882d..c206513897 100644 --- a/docs/manual/mod/mod_charset_lite.xml.meta +++ b/docs/manual/mod/mod_charset_lite.xml.meta @@ -8,6 +8,7 @@ en + fr ko diff --git a/docs/manual/mod/mod_data.html b/docs/manual/mod/mod_data.html index 6857a7393c..57601121be 100644 --- a/docs/manual/mod/mod_data.html +++ b/docs/manual/mod/mod_data.html @@ -3,3 +3,7 @@ URI: mod_data.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_data.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_data.html.fr b/docs/manual/mod/mod_data.html.fr new file mode 100644 index 0000000000..b5804bbb25 --- /dev/null +++ b/docs/manual/mod/mod_data.html.fr @@ -0,0 +1,105 @@ + + + +mod_data - Serveur Apache HTTP + + + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_data

Langues Disponibles: en | + fr

+ + + + +

Description:	Convertit un corps de réponse en URL de type données RFC2397
Statut:	Extension
Identificateur de Module:	data_module
Fichier Source:	mod_data.c
Compatibilité:	Disponible depuis la version 2.3 du serveur HTTP Apache

Sommaire

+ +

Ce module permet de convertir une réponse en URL de type données + RFC2397. +

+ +

Les URLs de type données peuvent être incluses en ligne dans les + pages web via le module mod_include par exemple, + afin d'éviter aux clients d'avoir à effectuer des connexions + séparées pour éventuellement extraire un grand nombre de petites + images. Les URLs de type données peuvent aussi être incluses dans + des pages générées par langages de scripting tels que PHP.

+ +

Un exemple d'URL de type données

+ data:image/gif;base64,R0lGODdhMAAwAPAAAAAAAP///ywAAAAAMAAw + AAAC8IyPqcvt3wCcDkiLc7C0qwyGHhSWpjQu5yqmCYsapyuvUUlvONmOZtfzgFz + ByTB10QgxOR0TqBQejhRNzOfkVJ+5YiUqrXF5Y5lKh/DeuNcP5yLWGsEbtLiOSp + a/TPg7JpJHxyendzWTBfX0cxOnKPjgBzi4diinWGdkF8kjdfnycQZXZeYGejmJl + ZeGl9i2icVqaNVailT6F5iJ90m6mvuTS4OK05M0vDk0Q4XUtwvKOzrcd3iq9uis + F81M1OIcR7lEewwcLp7tuNNkM3uNna3F2JQFo97Vriy/Xl4/f1cf5VWzXyym7PH + hhx4dbgYKAAA7 +

+ +

Le filtre n'accepte aucun paramètre, et peut être ajouté à la + pile des filtres via la directive SetOutputFilter, ou toute autre directive + supportée par le module mod_filter.

+ +

Configuration du filtre

+<Location /data/images>
+    SetOutputFilter DATA
+</Location>
+

+ +

Directives

Ce module ne fournit aucune directive.

Voir aussi

Les filtres

Commentaires

+ +

Langues Disponibles: en | + fr

Commentaires

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_data.xml.fr b/docs/manual/mod/mod_data.xml.fr new file mode 100644 index 0000000000..adeca2ff6c --- /dev/null +++ b/docs/manual/mod/mod_data.xml.fr @@ -0,0 +1,73 @@ + + + + + + + + + + + +mod_data +Convertit un corps de réponse en URL de type données RFC2397 +Extension +mod_data.c +data_module +Disponible depuis la version 2.3 du serveur HTTP Apache + +

Ce module permet de convertir une réponse en URL de type données + RFC2397. +

+ +

Les URLs de type données peuvent être incluses en ligne dans les + pages web via le module mod_include par exemple, + afin d'éviter aux clients d'avoir à effectuer des connexions + séparées pour éventuellement extraire un grand nombre de petites + images. Les URLs de type données peuvent aussi être incluses dans + des pages générées par langages de scripting tels que PHP.

+ + Un exemple d'URL de type données + data:image/gif;base64,R0lGODdhMAAwAPAAAAAAAP///ywAAAAAMAAw
+ AAAC8IyPqcvt3wCcDkiLc7C0qwyGHhSWpjQu5yqmCYsapyuvUUlvONmOZtfzgFz
+ ByTB10QgxOR0TqBQejhRNzOfkVJ+5YiUqrXF5Y5lKh/DeuNcP5yLWGsEbtLiOSp
+ a/TPg7JpJHxyendzWTBfX0cxOnKPjgBzi4diinWGdkF8kjdfnycQZXZeYGejmJl
+ ZeGl9i2icVqaNVailT6F5iJ90m6mvuTS4OK05M0vDk0Q4XUtwvKOzrcd3iq9uis
+ F81M1OIcR7lEewwcLp7tuNNkM3uNna3F2JQFo97Vriy/Xl4/f1cf5VWzXyym7PH
+ hhx4dbgYKAAA7
+ + +

Le filtre n'accepte aucun paramètre, et peut être ajouté à la + pile des filtres via la directive SetOutputFilter, ou toute autre directive + supportée par le module mod_filter.

+ + Configuration du filtre + +<Location /data/images> + SetOutputFilter DATA +</Location> + + + +

+Les filtres + + diff --git a/docs/manual/mod/mod_data.xml.meta b/docs/manual/mod/mod_data.xml.meta index fe4bf3f5ee..38248f4066 100644 --- a/docs/manual/mod/mod_data.xml.meta +++ b/docs/manual/mod/mod_data.xml.meta @@ -8,5 +8,6 @@ en + fr diff --git a/docs/manual/mod/mod_ext_filter.html b/docs/manual/mod/mod_ext_filter.html index a4474fe038..4d0b1e3e8d 100644 --- a/docs/manual/mod/mod_ext_filter.html +++ b/docs/manual/mod/mod_ext_filter.html @@ -4,6 +4,10 @@ URI: mod_ext_filter.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_ext_filter.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_ext_filter.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_ext_filter.html.fr b/docs/manual/mod/mod_ext_filter.html.fr new file mode 100644 index 0000000000..cb8abd9897 --- /dev/null +++ b/docs/manual/mod/mod_ext_filter.html.fr @@ -0,0 +1,387 @@ + + + +mod_ext_filter - Serveur Apache HTTP + + + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_ext_filter

Langues Disponibles: en | + fr | + ja | + ko

+ + + +

Description:	Fait traiter le corps de la réponse par un programme +externe avant de l'envoyer au client
Statut:	Extension
Identificateur de Module:	ext_filter_module
Fichier Source:	mod_ext_filter.c

Sommaire

+ +

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

+ +

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.
on peut utiliser des programmes existants comme filtres Apache + sans modification.

+ +

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.

+ +

Directives

ExtFilterDefine
ExtFilterOptions

Sujets

Exemples

Voir aussi

Filtres

Commentaires

Exemples

+ +

Générer du HTML à partir d'un autre type de + contenu

+ +

+# 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
+ExtFilterDefine c-to-html mode=output \
+    intype=text/c outtype=text/html \
+    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
+    AddType text/c .c
+</Directory>
+

+ + + +

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 + réaliste.

+ +

+# la directive de mod_ext_filter qui définit le filtre externe
+ExtFilterDefine gzip mode=output cmd=/bin/gzip
+
+<Location /gzipped>
+
+    # directive de base permettant de traiter la sortie avec le
+    # filtre gzip
+    SetOutputFilter gzip
+
+    # la directive de mod_header permettant d'ajouter le champ
+    # d'en-tête "Content-Encoding: gzip"
+    Header set Content-Encoding gzip
+</Location>
+

+ + + + +

Ralentissement du serveur

+# directive de mod_ext_filter définissant un filtre qui fait
+# passer tout 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
+ExtFilterDefine slowdown mode=output cmd=/bin/cat \
+    preservescontentlength
+
+<Location />
+    # directive de base permettant de traiter plusieurs fois la
+    # sortie avec le filtre slowdown
+    #
+    SetOutputFilter slowdown;slowdown;slowdown
+</Location>
+

+ + + +

Utilisation de sed pour remplacer 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"
+
+<Location />
+    # directive de base permettant de traiter la sortie avec le
+    # filtre fixtext
+    SetOutputFilter fixtext
+</Location>
+

+ + + + +

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
+# compression.
+# Ce premier filtre va tracer ce qui entre dans mod_deflate.
+ExtFilterDefine tracebefore \
+    cmd="/bin/tracefilter.pl /tmp/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 à
+# AP_FTYPE_CONTENT_SET permet de s'assurer que le filtre sera
+# placé après mod_deflate.
+ExtFilterDefine traceafter \
+    cmd="/bin/tracefilter.pl /tmp/traceafter" \
+    EnableEnv=trace_this_client ftype=21
+
+<Directory /usr/local/docs>
+    SetEnvIf Remote_Addr 192.168.1.31 trace_this_client
+    SetOutputFilter tracebefore;deflate;traceafter
+</Directory>
+

+ + +

Voici le filtre qui trace les données :

+#!/usr/local/bin/perl -w
+use strict;
+
+open(SAVE, ">$ARGV[0]")
+    or die "can't open $ARGV[0]: $?";
+
+while (<STDIN>) {
+    print SAVE $_;
+    print $_;
+}
+
+close(SAVE);
+

+ +

ExtFilterDefine Directive

+ + + + + + +

Description:	Définit un filtre externe
Syntaxe:	`ExtFilterDefine nom filtre paramètres`
Contexte:	configuration du serveur
Statut:	Extension
Module:	mod_ext_filter

La directive ExtFilterDefine permet de + définir 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 + 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 + 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 :

+ +

cmd=ligne de commande: Le mot-clé cmd= permet de spécifier 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 + d'environnement CGI standards, les variables DOCUMENT_URI, + DOCUMENT_PATH_INFO, et QUERY_STRING_UNESCAPED seront aussi + définies pour le programme.
mode=mode: 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 + 2.1 d'Apache.
intype=type MIME: Ce paramètre permet de spécifier 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. Tous les + documents possédant un type MIME autre que celui spécifié par + intype= ne seront pas filtrés.
outtype=type MIME: Ce paramètre permet de spécifier 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 + 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 + modifier la taille du contenu.
ftype=type de filtre: Ce paramètre permet de spécifier 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. Si le filtre doit opérer dans la chaîne + de filtrage à un autre point que les filtres de ressources, ce + paramètre est nécessaire. Voir les définitions de AP_FTYPE_... + dans util_filter.h pour trouver une valeur appropriée.
disableenv=env: Ce paramètre permet de spécifier le nom d'une variable + d'environnement qui, si elle est définie, va désactiver le + filtre.
enableenv=env: Ce paramètre permet de spécifier le nom d'une variable + d'environnement qui doit être définie pour que le filtre ne soit + pas désactivé.

+ +

ExtFilterOptions Directive

+ + + + + + + +

Description:	Configure les options de +`mod_ext_filter`
Syntaxe:	`ExtFilterOptions option [option] ...`
Défaut:	`ExtFilterOptions NoLogStderr`
Contexte:	répertoire
Statut:	Extension
Module:	mod_ext_filter

La directive ExtFilterOptions permet de + spécifier 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 + 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), la requête sera abandonnée. Avec remove, le + filtre est supprimé, et le traitement de la requête se poursuit + sans lui.

+ +

+      ExtFilterOptions LogStderr
+

+ + +

Les messages envoyés vers la sortie d'erreurs standard du filtre + seront enregistrés dans le journal des erreurs d'Apache..

+ +

Langues Disponibles: en | + fr | + ja | + ko

Commentaires

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_ext_filter.xml.fr b/docs/manual/mod/mod_ext_filter.xml.fr new file mode 100644 index 0000000000..168f972dfc --- /dev/null +++ b/docs/manual/mod/mod_ext_filter.xml.fr @@ -0,0 +1,337 @@ + + + + + + + + + + + +mod_ext_filter +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 + 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 + 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 :

+ +

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.
on peut utiliser des programmes existants comme filtres Apache + sans modification.

+ +

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.

+ +

+Filtres + +

Exemples + +

Générer du HTML à partir d'un autre type de + contenu + + +# 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 +ExtFilterDefine c-to-html mode=output \ + intype=text/c outtype=text/html \ + 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 + AddType text/c .c +</Directory> + +

+ +

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 + réaliste.

+ + +# la directive de mod_ext_filter qui définit le filtre externe +ExtFilterDefine gzip mode=output cmd=/bin/gzip + +<Location /gzipped> + + # directive de base permettant de traiter la sortie avec le + # filtre gzip + SetOutputFilter gzip + + # la directive de mod_header permettant d'ajouter le champ + # d'en-tête "Content-Encoding: gzip" + Header set Content-Encoding gzip +</Location> + + +

+ +

Ralentissement du serveur + +# directive de mod_ext_filter définissant un filtre qui fait +# passer tout 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 +ExtFilterDefine slowdown mode=output cmd=/bin/cat \ + preservescontentlength + +<Location /> + # directive de base permettant de traiter plusieurs fois la + # sortie avec le filtre slowdown + # + SetOutputFilter slowdown;slowdown;slowdown +</Location> + +

+ +

Utilisation de sed pour remplacer 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" + +<Location /> + # directive de base permettant de traiter la sortie avec le + # filtre fixtext + SetOutputFilter fixtext +</Location> + + +

+ +

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 +# compression. +# Ce premier filtre va tracer ce qui entre dans mod_deflate. +ExtFilterDefine tracebefore \ + cmd="/bin/tracefilter.pl /tmp/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 à +# AP_FTYPE_CONTENT_SET permet de s'assurer que le filtre sera +# placé après mod_deflate. +ExtFilterDefine traceafter \ + cmd="/bin/tracefilter.pl /tmp/traceafter" \ + EnableEnv=trace_this_client ftype=21 + +<Directory /usr/local/docs> + SetEnvIf Remote_Addr 192.168.1.31 trace_this_client + SetOutputFilter tracebefore;deflate;traceafter +</Directory> + + + Voici le filtre qui trace les données : + +#!/usr/local/bin/perl -w +use strict; + +open(SAVE, ">$ARGV[0]") + or die "can't open $ARGV[0]: $?"; + +while (<STDIN>) { + print SAVE $_; + print $_; +} + +close(SAVE); + + +

+ + +ExtFilterDefine +Définit un filtre externe +ExtFilterDefine nom filtre paramètres +server config + + +

La directive ExtFilterDefine permet de + définir 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 + 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 + l'utilisateur.

+ +

cmd=ligne de commande: Le mot-clé cmd= permet de spécifier 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 + d'environnement CGI standards, les variables DOCUMENT_URI, + DOCUMENT_PATH_INFO, et QUERY_STRING_UNESCAPED seront aussi + définies pour le programme.
mode=mode: 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 + 2.1 d'Apache.
intype=type MIME: Ce paramètre permet de spécifier 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. Tous les + documents possédant un type MIME autre que celui spécifié par + intype= ne seront pas filtrés.
outtype=type MIME: Ce paramètre permet de spécifier 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 + 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 + modifier la taille du contenu.
ftype=type de filtre: Ce paramètre permet de spécifier 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. Si le filtre doit opérer dans la chaîne + de filtrage à un autre point que les filtres de ressources, ce + paramètre est nécessaire. Voir les définitions de AP_FTYPE_... + dans util_filter.h pour trouver une valeur appropriée.
disableenv=env: Ce paramètre permet de spécifier le nom d'une variable + d'environnement qui, si elle est définie, va désactiver le + filtre.
enableenv=env: Ce paramètre permet de spécifier le nom d'une variable + d'environnement qui doit être définie pour que le filtre ne soit + pas désactivé.

+ + + + +ExtFilterOptions +Configure les options de +mod_ext_filter +ExtFilterOptions option [option] ... +ExtFilterOptions NoLogStderr +directory + + +

La directive ExtFilterOptions permet de + spécifier 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 + 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), la requête sera abandonnée. Avec remove, le + filtre est supprimé, et le traitement de la requête se poursuit + sans lui.

+ + + ExtFilterOptions LogStderr + + +

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_ext_filter.xml.meta b/docs/manual/mod/mod_ext_filter.xml.meta index 3ba11ff6bb..10bf3caeb0 100644 --- a/docs/manual/mod/mod_ext_filter.xml.meta +++ b/docs/manual/mod/mod_ext_filter.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko diff --git a/docs/manual/mod/mod_file_cache.html b/docs/manual/mod/mod_file_cache.html index e9da936ddc..5707262c77 100644 --- a/docs/manual/mod/mod_file_cache.html +++ b/docs/manual/mod/mod_file_cache.html @@ -4,6 +4,10 @@ URI: mod_file_cache.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_file_cache.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_file_cache.html.ko.euc-kr Content-Language: ko Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/mod/mod_file_cache.html.fr b/docs/manual/mod/mod_file_cache.html.fr new file mode 100644 index 0000000000..c94405a3f0 --- /dev/null +++ b/docs/manual/mod/mod_file_cache.html.fr @@ -0,0 +1,271 @@ + + + +mod_file_cache - Serveur Apache HTTP + + + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_file_cache

Langues Disponibles: en | + fr | + ko

+ + + +

Description:	Mise en cache mémoire d'une liste statique de +fichiers
Statut:	Expérimental
Identificateur de Module:	file_cache_module
Fichier Source:	mod_file_cache.c

Sommaire

+ + +

+ Ce module doit être utilisé avec précautions. Il est recommandé de + lire attentivement ce document, car l'utilisation de + mod_file_cache peut facilement conduire à la + création d'un site inopérant. +

+ +

La mise en cache de fichiers souvent demandés mais rarement + modifiés est une technique permettant de réduire la charge du + serveur. mod_file_cache met en oeuvre deux + techniques de mise en cache de fichiers statiques + fréquemment demandés. Des directives de configuration vous + permettent d'indiquer à mod_file_cache soit + d'ouvrir et de charger une image en mémoire d'un fichier avec + mmap(), soit de préouvrir un fichier et de maintenir en + service le gestionnaire du fichier. Les deux techniques + permettent de réduire la charge du serveur lors du traitement des + requêtes concernant ces fichiers, en accomplissant une partie du + travail nécessaire à la mise à disposition de ces fichiers (en + particulier les opérations d'entrées/sorties sur les fichiers) au + démarrage du serveur, plutôt qu'au cours de chaque requête.

+ +

Note : ces techniques sont inutilisables pour accélérer des + programmes CGI ou d'autres fichiers servis par des gestionnaires de + contenu spéciaux. Elles ne peuvent être utilisées que pour des + fichiers standards, normalement servis par le gestionnaire de contenu + de base d'Apache.

+ +

Ce module est une extension du module + d'Apache 1.3 mod_mmap_staticet s'en inspire + fortement .

Directives

CacheFile
MMapFile

Sujets

Utilisation de mod_file_cache

Commentaires

Utilisation de mod_file_cache

+ +

mod_file_cache gère la mise en cache d'une liste + de fichiers définie de manière statique via une des directives + MMapFile ou + CacheFile au niveau + de la configuration du serveur principal.

+ +

Les deux directives ne sont pas supportées par toutes les + plates-formes. Par exemple, Apache pour Windows ne supporte pas + actuellement la directive MMapFile, alors que d'autres + plates-formes, comme AIX, supportent les deux. Vous recevrez un + message d'erreur dans le journal des erreurs du serveur si vous + essayez d'utiliser une directive non supportée. si vous utilisez une + directive non supportée, le serveur démarrera, mais les fichiers ne + seront pas mis en cache. Sur les plates-formes qui supportent les + deux directives, vous devez faire des essais afin de déterminer + quelle directive vous convient le mieux.

+ +

Directive MMapFile

+ +

La directive MMapFile du module + mod_file_cache permet de transférer en mémoire + une liste statique de fichiers à l'aide de l'appel système + mmap(). Cet appel système est disponible sur la + plupart des plates-formes de style Unix, mais pas sur toutes. Il + existe parfois des limites spécifiques au système quant à la + taille et au nombre de fichiers qui peuvent être + mmap()és, et l'expérimentation est probablement la + méthode la plus simple pour déterminer ces limites.

+ +

Ce mmap()age n'est effectué qu'une seul fois au + démarrage ou redémarrage du serveur. Ainsi, chaque fois qu'un des + fichiers chargés en mémoire est modifié au niveau du système de + fichiers, vous devez redémarrer le serveur (voir la + documentation sur l'Arrêt et redémarrage). Pour bien + insister sur ce point, si des fichiers sont modifiés sur + disque, et si vous ne redémarrez pas le serveur, vous allez + finir par servir des contenus complètement obsolètes. Vous devez + mettre à jour les fichiers en renommant l'ancienne version et en + enregistrant la nouvelle sur disque. Pour y parvenir, on peut + utiliser des outils comme rdist et mv. + La raison pour laquelle ce module ne prend pas en compte les + modifications de fichiers réside dans le fait que cette + vérification nécessiterait un appel à stat() à chaque + accès, et en fin de compte, l'augmentation de la consommation de + ressources finirait par aller contre le but initial de + réduire les entrées/sorties.

+ + +

Directive CacheFile

+ +

La directive CacheFile du module + mod_file_cache permet d'associer un + gestionnaire ou descripteur de fichier à chaque + fichier énuméré dans la directive de configuration et place ces + gestionnaires de fichiers ouverts dans le cache. Lorsqu'un des + fichier est demandé, le serveur sélectionne son gestionnaire dans + le cache et le transmet à l'API sendfile() (ou + TransmitFile() sous Windows).

+ + + +

Cette mise en cache des gestionnaire n'est effectuée qu'une + seule fois au démarrage ou redémarrage du système. Ainsi, chaque + fois qu'un des fichiers chargés en mémoire est modifié au niveau + du système de fichiers, vous devez redémarrer le serveur + (voir la documentation sur l'Arrêt et redémarrage). + Pour bien + insister sur ce point, si des fichiers sont modifiés sur + disque, et si vous ne redémarrez pas le serveur, vous allez + finir par servir des contenus complètement obsolètes. Vous devez + mettre à jour les fichiers en renommant l'ancienne version et en + enregistrant la nouvelle sur disque. Pour y parvenir, on peut + utiliser des outils comme rdist et + mv.

+ + +

Note

Ne cherchez pas à trouver de directive qui met tous les + fichiers d'un répertoire en cache, de manière récursive. Pour y + parvenir, vous pouvez vous reporter à la directive Include directive, et considérer cette + commande :

+ +

+ find /www/htdocs -type f -print \ + | sed -e 's/.*/mmapfile &/' > /www/conf/mmap.conf +

CacheFile Directive

+ + + + + + +

Description:	Met en cache une liste de gestionnaires de fichiers au +démarrage
Syntaxe:	`CacheFile chemin fichier [chemin fichier] ...`
Contexte:	configuration du serveur
Statut:	Expérimental
Module:	mod_file_cache

La directive CacheFile permet d'associer + des gestionnaires à un ou plusieurs fichiers (séparés par des + espaces), et de placer ceux-ci dans le cache au démarrage du + serveur. Les gestionnaires des fichiers mis en cache sont + automatiquement fermés à l'arrêt du serveur. Lorsqu'un ou plusieurs + fichiers ont été modifiés sur disque, le serveur doit être redémarré + afin que les modifications soient prises en compte par le cache.

+ +

Soyez prudent avec les arguments chemin fichier : ils + doivent correspondre exactement au chemin du système de fichier que + créent les gestionnaires de traduction URL-vers-nom-fichier + d'Apache. On ne peut pas comparer des inodes ou autres identifiants + pour mettre en correspondance des chemins à l'aide de liens + symboliques (etc...), car là encore, ceci nécessiterait un + appel à stat() supplémentaire, ce qui n'est pas acceptable. + Il n'est pas garanti que ce module fonctionne avec des noms de + fichiers réécrits par mod_alias ou + mod_rewrite.

+ +

Exemple

+      CacheFile /usr/local/apache/htdocs/index.html
+

+ +

MMapFile Directive

+ + + + + + +

Description:	Charge au démarrage une liste de fichiers en mémoire
Syntaxe:	`MMapFile chemin fichier [chemin fichier] ...`
Contexte:	configuration du serveur
Statut:	Expérimental
Module:	mod_file_cache

La directive MMapFile permet de charger un + ou plusieurs fichiers (séparés par des espaces) en mémoire au + démarrage du serveur. Ceux-ci sont automatiquement déchargés de la + mémoire à l'arrêt du serveur. Lorsqu'un ou plusieurs fichiers ont + été modifiés sur disque, on doit au minimum envoyer un signal + HUP ou USR1 au serveur afin de les + remmap()er.

+ +

Soyez prudent avec les arguments chemin fichier : ils + doivent correspondre exactement au chemin du système de fichier que + créent les gestionnaires de traduction URL-vers-nom-fichier + d'Apache. On ne peut pas comparer des inodes ou autres identifiants + pour mettre en correspondance des chemins à l'aide de liens + symboliques (etc...), car là encore, ceci nécessiterait un + appel à stat() supplémentaire, ce qui n'est pas + acceptable. + Il n'est pas garanti que ce module fonctionne avec des noms de + fichiers réécrits par mod_alias ou + mod_rewrite.

+ +

Exemple

+      MMapFile /usr/local/apache/htdocs/index.html
+

+ +

Langues Disponibles: en | + fr | + ko

Commentaires

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_file_cache.xml.fr b/docs/manual/mod/mod_file_cache.xml.fr new file mode 100644 index 0000000000..31c233d8ce --- /dev/null +++ b/docs/manual/mod/mod_file_cache.xml.fr @@ -0,0 +1,238 @@ + + + + + + + + + + + +mod_file_cache +Mise en cache mémoire d'une liste statique de +fichiers +Experimental +mod_file_cache.c +file_cache_module + +

+ + + Ce module doit être utilisé avec précautions. Il est recommandé de + lire attentivement ce document, car l'utilisation de + mod_file_cache peut facilement conduire à la + création d'un site inopérant. + + +

La mise en cache de fichiers souvent demandés mais rarement + modifiés est une technique permettant de réduire la charge du + serveur. mod_file_cache met en oeuvre deux + techniques de mise en cache de fichiers statiques + fréquemment demandés. Des directives de configuration vous + permettent d'indiquer à mod_file_cache soit + d'ouvrir et de charger une image en mémoire d'un fichier avec + mmap(), soit de préouvrir un fichier et de maintenir en + service le gestionnaire du fichier. Les deux techniques + permettent de réduire la charge du serveur lors du traitement des + requêtes concernant ces fichiers, en accomplissant une partie du + travail nécessaire à la mise à disposition de ces fichiers (en + particulier les opérations d'entrées/sorties sur les fichiers) au + démarrage du serveur, plutôt qu'au cours de chaque requête.

+ +

Ce module est une extension du module + d'Apache 1.3 mod_mmap_staticet s'en inspire + fortement .

+ +

Utilisation de mod_file_cache + +

mod_file_cache gère la mise en cache d'une liste + de fichiers définie de manière statique via une des directives + MMapFile ou + CacheFile au niveau + de la configuration du serveur principal.

+ +

Les deux directives ne sont pas supportées par toutes les + plates-formes. Par exemple, Apache pour Windows ne supporte pas + actuellement la directive MMapFile, alors que d'autres + plates-formes, comme AIX, supportent les deux. Vous recevrez un + message d'erreur dans le journal des erreurs du serveur si vous + essayez d'utiliser une directive non supportée. si vous utilisez une + directive non supportée, le serveur démarrera, mais les fichiers ne + seront pas mis en cache. Sur les plates-formes qui supportent les + deux directives, vous devez faire des essais afin de déterminer + quelle directive vous convient le mieux.

+ +

Directive MMapFile + +

La directive MMapFile du module + mod_file_cache permet de transférer en mémoire + une liste statique de fichiers à l'aide de l'appel système + mmap(). Cet appel système est disponible sur la + plupart des plates-formes de style Unix, mais pas sur toutes. Il + existe parfois des limites spécifiques au système quant à la + taille et au nombre de fichiers qui peuvent être + mmap()és, et l'expérimentation est probablement la + méthode la plus simple pour déterminer ces limites.

+ +

Directive CacheFile + +

La directive CacheFile du module + mod_file_cache permet d'associer un + gestionnaire ou descripteur de fichier à chaque + fichier énuméré dans la directive de configuration et place ces + gestionnaires de fichiers ouverts dans le cache. Lorsqu'un des + fichier est demandé, le serveur sélectionne son gestionnaire dans + le cache et le transmet à l'API sendfile() (ou + TransmitFile() sous Windows).

+ + + +

+ + Note +

Ne cherchez pas à trouver de directive qui met tous les + fichiers d'un répertoire en cache, de manière récursive. Pour y + parvenir, vous pouvez vous reporter à la directive Include directive, et considérer cette + commande :

+ + + find /www/htdocs -type f -print \
+ | sed -e 's/.*/mmapfile &/' > /www/conf/mmap.conf + + +

+ + +MMapFile +Charge au démarrage une liste de fichiers en mémoire +MMapFile chemin fichier [chemin fichier] ... +server config + + +

La directive MMapFile permet de charger un + ou plusieurs fichiers (séparés par des espaces) en mémoire au + démarrage du serveur. Ceux-ci sont automatiquement déchargés de la + mémoire à l'arrêt du serveur. Lorsqu'un ou plusieurs fichiers ont + été modifiés sur disque, on doit au minimum envoyer un signal + HUP ou USR1 au serveur afin de les + remmap()er.

+ +

Soyez prudent avec les arguments chemin fichier : ils + doivent correspondre exactement au chemin du système de fichier que + créent les gestionnaires de traduction URL-vers-nom-fichier + d'Apache. On ne peut pas comparer des inodes ou autres identifiants + pour mettre en correspondance des chemins à l'aide de liens + symboliques (etc...), car là encore, ceci nécessiterait un + appel à stat() supplémentaire, ce qui n'est pas + acceptable. + Il n'est pas garanti que ce module fonctionne avec des noms de + fichiers réécrits par mod_alias ou + mod_rewrite.

+ + Exemple + + MMapFile /usr/local/apache/htdocs/index.html + + + + + + +CacheFile +Met en cache une liste de gestionnaires de fichiers au +démarrage +CacheFile chemin fichier [chemin fichier] ... +server config + + +

La directive CacheFile permet d'associer + des gestionnaires à un ou plusieurs fichiers (séparés par des + espaces), et de placer ceux-ci dans le cache au démarrage du + serveur. Les gestionnaires des fichiers mis en cache sont + automatiquement fermés à l'arrêt du serveur. Lorsqu'un ou plusieurs + fichiers ont été modifiés sur disque, le serveur doit être redémarré + afin que les modifications soient prises en compte par le cache.

+ +

+ + Exemple + + CacheFile /usr/local/apache/htdocs/index.html + + + + + + diff --git a/docs/manual/mod/mod_file_cache.xml.meta b/docs/manual/mod/mod_file_cache.xml.meta index c14e54b1ce..892b03e09f 100644 --- a/docs/manual/mod/mod_file_cache.xml.meta +++ b/docs/manual/mod/mod_file_cache.xml.meta @@ -8,6 +8,7 @@ en + fr ko