Serveur Apache HTTP Version 2.4
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 |
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�.
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
Si les r�gles de traduction ne peuvent s'appliquer au contenu, la traduction peut �chouer avec des cons�quences diverses, comme :
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.
<Directory /export/home/trawick/apacheinst/htdocs/convert> CharsetSourceEnc UTF-16BE CharsetDefault ISO-8859-1 </Directory>
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.
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
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
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.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�.
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.
<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.
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.