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

Directives

Sujets

top

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 :

top

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

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

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

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>
      

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.

Langues Disponibles:  en  |  fr  |  ko 

top

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.