Module Apache mod_mime

AddCharset Directive

La directive AddCharset permet d'associer les extensions de noms de fichiers sp�cifi�es au jeu de caract�res sp�cifi� (le nom enregistr� sur l'Internet d'un codage de caract�res donn�). jeu-car est le param�tre jeu de caract�res du type de m�dium pour les ressources dont le nom de fichier contient extension. Cette association est ajout�e � toutes les autres d�j� en vigueur, et �crase toute association pr�existante pour la m�me extension.

AddLanguage ja .ja
AddCharset EUC-JP .euc
AddCharset ISO-2022-JP .jis
AddCharset SHIFT_JIS .sjis

Avec cet exemple, le document xxxx.ja.jis sera trait� en tant que document japonais dont le jeu de caract�re est ISO-2022-JP (idem pour le document xxxx.jis.ja). La directive AddCharset sert � la fois � informer le client sur le codage des caract�res du document afin que ce dernier puisse �tre interpr�t� et affich� correctement, et � la n�gociation de contenu, au cours de laquelle le serveur d�cide lequel parmi plusieurs documents possibles il renvoie au client en fonction des pr�f�rences de ce dernier en mati�re de jeu de caract�res.

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial. Les noms de fichiers peuvent poss�der plusieurs extensions, et l'argument extension sera compar� � chacune d'entre elles.

Voir aussi

• mod_negotiation
• AddDefaultCharset

AddEncoding Directive

La directive AddEncoding permet d'associer les extensions de noms de fichiers donn�es au codage de contenu HTTP sp�cifi�. codage est le codage de contenu HTTP � ajouter � la valeur du champ d'en-t�te Content-Encoding pour les documents poss�dant l'extension sp�cifi�e. Cette association est ajout�e � toutes les autres d�j� en vigueur, et �crase toute association pr�existante pour la m�me extension.

AddEncoding x-gzip .gz
AddEncoding x-compress .Z

Avec cet exemple, les noms de fichiers poss�dant l'extension .gz seront marqu�s comme cod�s � l'aide du codage x-gzip, et les noms de fichiers poss�dant l'extension .Z comme cod�s avec x-compress.

Les clients anciens n'acceptent que x-gzip et x-compress, bien que les standards stipulent qu'ils sont respectivement �quivalents � gzip et compress. Apache effectue ses comparaisons de codages de contenu en ignorant tout pr�fixe x-. Lorsqu'il r�pond avec un codage, Apache utilise l'une ou l'autre forme (c'est � dire x-foo ou foo) selon les besoins du client. Si le client n'a pas besoin d'une forme particuli�re, Apache utilisera la forme employ�e par la directive AddEncoding. Pour r�sumer, vous devez toujours utiliser x-gzip et x-compress pour ces deux codages sp�cifiques. Certains codages plus r�cents, comme deflate, doivent �tre sp�cifi�s sans le pr�fixe x-.

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial. Les noms de fichiers peuvent poss�der plusieurs extensions, et l'argument extension sera compar� � chacune d'entre elles.

AddHandler Directive

Les fichiers dont le nom a pour extension extension seront servis par le nom-gestionnaire sp�cifi�. Cette association est ajout�e � toutes les autres d�j� en vigueur, et �crase toute association pr�existante pour la m�me extension. Par exemple, pour associer les scripts CGI avec l'extension de fichier .cgi, vous pouvez utiliser :

AddHandler cgi-script .cgi

Une fois cette ligne ins�r�e dans votre fichier apache2.conf, tout fichier poss�dant l'extension .cgi sera trait� en tant que programme CGI.

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial. Les noms de fichiers peuvent poss�der plusieurs extensions, et l'argument extension sera compar� � chacune d'entre elles.

Voir aussi

• SetHandler

AddInputFilter Directive

La directive AddInputFilter permet d'associer l'extension de nom de fichier extension aux filtres sp�cifi�s qui traiteront les requ�tes clients et les entr�es POST � leur r�ception par le serveur. Ceci s'ajoute � toute d�finition de filtre pr�existante, y compris la directive SetInputFilter. Cette association est ajout�e � toutes les autres d�j� en vigueur, et �crase toute association pr�existante pour la m�me extension.

Si plusieurs filtres sont sp�cifi�s, ils doivent �tre s�par�s par des points-virgules et inscrits dans l'ordre selon lequel ils devront traiter le contenu. L'argument filtre est insensible � la casse.

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial. Les noms de fichiers peuvent poss�der plusieurs extensions, et l'argument extension sera compar� � chacune d'entre elles.

Voir aussi

• RemoveInputFilter
• SetInputFilter

AddLanguage Directive

La directive AddLanguage permet d'associer l'extension de nom de fichier donn�e � la langue sp�cifi�e. Les fichiers dont l'extension correspond � la valeur de l'argument extension se voient attribuer la valeur de l'argument symbole-langue comme en-t�te HTTP Content-Language en accord avec les identifiants de langues d�finis par la RFC 3066. Cette directive l'emporte sur toute association pr�existante pour la m�me extension.

AddEncoding x-compress .Z
AddLanguage en .en
AddLanguage fr .fr

Avec cet exemple, le document xxxx.en.Z sera trait� en tant que document compress� de langue anglaise (idem pour le document xxxx.Z.en). Bien que la langue soit fournie au client, le navigateur n'utilise habituellement pas cette information. La directive AddLanguage est principalement utilis�e au cours de la n�gociation de contenu, o� le serveur choisit d'envoyer un document parmi plusieurs documents possibles en fonction de la pr�f�rence du client en mati�re de langue.

Si une extension fait l'objet de plusieurs associations de langues, c'est la derni�re qui sera utilis�e. Ainsi, dans le cas suivant,

AddLanguage en .en
AddLanguage en-gb .en
AddLanguage en-us .en

les documents poss�dant l'extension .en seront trait�s en tant que documents de langue en-us.

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial. Les noms de fichiers peuvent poss�der plusieurs extensions, et l'argument extension sera compar� � chacune d'entre elles.

Voir aussi

• mod_negotiation

AddOutputFilter Directive

La directive AddOutputFilter permet d'associer l'extension de nom de fichier d�finie par l'argument extension aux filtres qui traiteront les r�ponses en provenance du serveur avant de les envoyer au client. Ces filtres s'ajoutent � tout filtre d�fini par d'autres directives comme SetOutputFilter et AddOutputFilterByType. Cette association est fusionn�e avec toute autre association en vigueur, et l'emporte sur toute association pr�existante pour la m�me extension.

Avec l'exemple suivant, tous les fichiers .shtml seront trait�s en tant qu'inclusions c�t� serveur (SSI), et la sortie sera compress�e � l'aide du module mod_deflate.

AddOutputFilter INCLUDES;DEFLATE shtml

Si plusieurs filtres sont sp�cifi�s, ils doivent �tre s�par�s par des points-virgules et inscrits dans l'ordre selon lequel il devront traiter le contenu. L'argument filtre est insensible � la casse.

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial. Les noms de fichiers peuvent poss�der plusieurs extensions, et l'argument extension sera compar� � chacune d'entre elles.

Notez que toute d�finition de filtres via la directive AddOutputFilter remplace toutes les d�finitions pr�c�dentes effectu�es via cette m�me directive.

# Filtre sp�cifi� "DEFLATE"
AddOutputFilter DEFLATE shtml
<Location /foo>
  # Filtre sp�cifi� "INCLUDES", remplace "DEFLATE"
  AddOutputFilter INCLUDES shtml
</Location>
<Location /bar>
  # Filtre sp�cifi� "INCLUDES;DEFLATE", remplace "DEFLATE"
  AddOutputFilter INCLUDES;DEFLATE shtml
</Location>
<Location /bar/baz>
  # Filtre sp�cifi� "BUFFER", remplace "INCLUDES;DEFLATE"
  AddOutputFilter BUFFER shtml
</Location>
<Location /bar/baz/buz>
  # Pas de filtre sp�cifi�, suppression de "BUFFER"
  RemoveOutputFilter shtml
</Location>

Voir aussi

• RemoveOutputFilter
• SetOutputFilter

AddType Directive

La directive AddType permet d'associer les extensions de noms de fichiers donn�es au type de contenu sp�cifi�. type-m�dium est le Type MIME � utiliser pour les fichiers dont le nom poss�de l'extension extension. Cette association s'ajoute � toute autre association en vigueur, et l'emporte sur toute association pr�existante pour la m�me extension.

AddType image/gif .gif

Ou, pour sp�cifier plusieurs extensions dans une seule directive :

AddType image/jpeg jpeg jpg jpe

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial. Les noms de fichiers peuvent poss�der plusieurs extensions, et l'argument extension sera compar� � chacune d'entre elles.

Il est possible d'obtenir un effet similaire � celui de la directive LanguagePriority du module mod_negotiation en qualifiant un type de m�dia avec qs :

AddType application/rss+xml;qs=0.8 .xml

Ceci peut s'av�rer utile dans certaines situations, par exemple lorsqu'un client qui a ajout� un en-t�te Accept: */* � sa requ�te n'est pas en mesure de traiter le contenu renvoy� par le serveur.

� la base, cette directive configure le type de contenu g�n�r� pour les fichiers statiques servis � partir du syst�me de fichiers. Dans le cas des ressources autres que les fichiers statiques pour lesquelles le g�n�rateur de la r�ponse sp�cifie en g�n�ral un Content-Type, cette directive n'a aucun effet.

Voir aussi

• ForceType
• mod_negotiation

DefaultLanguage Directive

La directive DefaultLanguage permet d'indiquer � Apache que toutes les ressources du contexte courant (par exemple, toutes les ressources concern�es par le conteneur <Directory> courant) qui ne poss�dent pas d'extension de langue explicite (comme .fr ou .de tel que d�fini par la directive AddLanguage), verront leur en-t�te HTTP Content-Language affect� de la langue symbole-langue. Ceci permet de marquer des arborescences de r�pertoires enti�res comme contenant des documents en fran�ais, par exemple, sans avoir � renommer chaque fichier. Notez qu'� la diff�rence de l'utilisation des extensions pour sp�cifier des langues, DefaultLanguage ne permet de sp�cifier qu'une seule langue.

Si aucune directive DefaultLanguage n'est en vigueur, et si un fichier ne poss�de pas d'extension configur�e par la directive AddLanguage, aucun champ d'en-t�te Content-Language ne sera g�n�r�.

DefaultLanguage en

Voir aussi

• mod_negotiation

ModMimeUsePathInfo Directive

La directive ModMimeUsePathInfo permet de combiner le nom de fichier avec la partie path_info de l'URL pour appliquer les directives mod_mime � la requ�te. La valeur par d�faut est Off - situation dans laquelle l'�l�ment path_info est ignor�.

L'utilisation de cette directive est conseill�e si vous utilisez un syst�me de fichiers virtuel.

ModMimeUsePathInfo On

Consid�rons une requ�te pour /index.php/foo.shtml, mod_mime ne traitera pas la requ�te entrante comme /index.php/foo.shtml et les directives comme AddOutputFilter INCLUDES .shtml ajouteront le filtre INCLUDES � la requ�te. Si la directive ModMimeUsePathInfo n'est pas d�finie, le filtre INCLUDES ne sera pas ajout�. Le fonctionnement sera identique dans le cas des chemins virtuels, tels que ceux d�finis par la directive <Location>

Voir aussi

• AcceptPathInfo

MultiviewsMatch Directive

La directive MultiviewsMatch permet trois comportements diff�rents pour la fonctionnalit� Multiviews du module mod_negotiation. Les vues multiples permettent d'associer une requ�te pour un fichier, par exemple index.html, � toute extension n�goci�e s'ajoutant � la requ�te de base, par exemple index.html.en, index.html.fr, ou index.html.gz.

L'option NegotiatedOnly implique que toute extension s'ajoutant au nom de base doit correspondre � une extension de mod_mime reconnue pour la n�gociation de contenu, par exemple Charset, Content-Type, Language, ou Encoding. C'est la valeur d'option par d�faut, et la contrainte la plus stricte dont les effets de bord inattendus sont les moins nombreux.

Pour inclure des extensions associ�es avec des gestionnaires et/ou des filtres, d�finissez la directive MultiviewsMatch avec les mots-cl�s Handlers, Filters, ou les deux. Si tous les autres facteurs sont �gaux, c'est le fichier de plus petite taille qui sera servi ; par exemple, si le choix doit s'op�rer entre index.html.cgi de 500 octets et index.html.pl de 1000 octets, c'est le fichier .cgi qui l'emportera dans cet exemple. Les utilisateurs de fichiers .asis auront avantage � utiliser l'option Handler, si les fichiers .asis sont associ�s au gestionnaire asis-handler.

Vous pouvez enfin autoriser l'association de toute extension avec l'option Any, m�me si mod_mime ne reconna�t pas l'extension. Ceci peut conduire � des r�sultats impr�visibles, comme l'envoi de fichiers .old ou .bak contrairement aux souhaits du webmaster.

Par exemple, la configuration suivante va permettre l'inclusion des extensions associ�es aux gestionnaires et aux filtres dans les vues multiples, tout en excluant les fichiers de type inconnu :

MultiviewsMatch Handlers Filters

L'utilisation de la directive MultiviewsMatch dans une section <Location> ou <LocationMatch> n'est pas permise.

Voir aussi

• Options
• mod_negotiation

RemoveCharset Directive

La directive RemoveCharset permet de supprimer toute association de jeu de caract�res pour les fichiers dont les noms poss�dent les extensions sp�cifi�es. Ceci permet, au sein des fichiers .htaccess, d'annuler toute association h�rit�e du r�pertoire parent ou de la configuration du serveur pour un r�pertoire particulier.

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial.

RemoveCharset .html .shtml

RemoveEncoding Directive

La directive RemoveEncoding permet de supprimer toute association de codage pour les fichiers dont les noms poss�dent les extensions sp�cifi�es. Ceci permet, au sein des fichiers .htaccess, d'annuler toute association h�rit�e du r�pertoire parent ou de la configuration du serveur pour un r�pertoire particulier. Voici un exemple d'utilisation de cette directive :

AddEncoding x-gzip .gz
AddType text/plain .asc
<Files *.gz.asc>
    RemoveEncoding .gz
</Files>

Avec cette configuration, le fichier foo.gz sera marqu� comme cod� avec gzip, mais foo.gz.asc sera marqu� comme fichier texte non cod�.

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial.

RemoveHandler Directive

La directive RemoveHandler permet de supprimer toute association de gestionnaire � des fichiers dont le nom poss�de l'extension donn�e. Ceci permet, au sein des fichiers .htaccess, d'annuler toute association h�rit�e du r�pertoire parent ou de la configuration du serveur pour un r�pertoire particulier. Voici un exemple d'utilisation de cette directive :

AddHandler server-parsed .html

RemoveHandler .html

Avec cette derni�re ligne, les fichiers .html du r�pertoire /foo/bar seront trait�s en tant que fichiers normaux, au lieu d'�tre trait�s en tant que candidats � l'interpr�tation (voir le module mod_include module).

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial.

RemoveInputFilter Directive

La directive RemoveInputFilter permet de supprimer toute association de filtre en entr�e � des fichiers dont le nom poss�de l'extension donn�e. Ceci permet, au sein des fichiers .htaccess, d'annuler toute association h�rit�e du r�pertoire parent ou de la configuration du serveur pour un r�pertoire particulier.

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial.

Voir aussi

• AddInputFilter
• SetInputFilter

RemoveLanguage Directive

La directive RemoveLanguage permet de supprimer toute association de langue � des fichiers dont le nom poss�de l'extension donn�e. Ceci permet, au sein des fichiers .htaccess, d'annuler toute association h�rit�e du r�pertoire parent ou de la configuration du serveur pour un r�pertoire particulier.

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial.

RemoveOutputFilter Directive

La directive RemoveOutputFilter permet de supprimer toute association de filtre en sortie � des fichiers dont le nom poss�de l'extension donn�e. Ceci permet, au sein des fichiers .htaccess, d'annuler toute association h�rit�e du r�pertoire parent ou de la configuration du serveur pour un r�pertoire particulier.

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial.

RemoveOutputFilter shtml

Voir aussi

• AddOutputFilter

RemoveType Directive

La directive RemoveType permet de supprimer toute association de type de m�dium � des fichiers dont le nom poss�de l'extension donn�e. Ceci permet, au sein des fichiers .htaccess, d'annuler toute association h�rit�e du r�pertoire parent ou de la configuration du serveur pour un r�pertoire particulier. Voici un exemple d'utilisation de cette directive :

RemoveType .cgi

Cette ligne aura pour effet de supprimer tout traitement sp�cifique des fichiers .cgi dans le r�pertoire /foo/ et ses sous-r�pertoires, et les r�ponses contenant ce type de fichier ne poss�deront pas de champ d'en-t�te HTTP Content-Type.

L'argument extension est insensible � la casse et peut �tre sp�cifi� avec ou sans le point initial.

TypesConfig Directive

La directive TypesConfig permet de d�finir le chemin du fichier de configuration des types de m�dia. L'argument chemin-fichier est un chemin relatif au r�pertoire d�fini par la directive ServerRoot. Ce fichier contient la liste des associations par d�faut des extensions de noms de fichiers aux types de contenus. La plupart des administrateurs utilisent le fichier mime.types fourni par leur syst�me d'exploitation, qui associe les extensions de noms de fichiers courantes � la liste officielle des types de m�dia enregistr�s par l'IANA et maintenue � http://www.iana.org/assignments/media-types/index.html, ainsi qu'un grand nombre de types non officiels. Ce fichier permet de simplifier le fichier apache2.conf en fournissant la majorit� des d�finitions de types de m�dia, et ses d�finitions peuvent �tre �cras�es par des directives AddType, selon les besoins. Il est d�conseill� de modifier le contenu du fichier mime.types car il peut �tre remplac� lors d'une mise � jour du serveur.

Le fichier contient des lignes dont le format est identique � celui des arguments d'une directive AddType :

Les extensions sont insensibles � la casse. Les lignes vides et les lignes commen�ant par un di�se (#) sont ignor�es. Les lignes vides servent � compl�ter le fichier mime.types. Apache httpd peut encore d�terminer ces types via le module mod_mime_magic.

Voir aussi

• mod_mime_magic