[APACHE DOCUMENTATION]

Apache HTTP Server Version 1.3

Module mod_mime

Ce module est implémenté dans le fichier mod_mime.c, et est compilé par défaut. Il permet à Apache de déterminer le type de contenu des fichiers à partir de leur nom.

Résumé

Ce module est utilisé pour déterminer un certain nombre de "métainformations" concernant les documents. Ces informations sont liées au contenu des documents et sont renvoyées vers le navigateur ou utilisée lors d'une négociation de contenu entre le client et le serveur. De plus, un gestionnaire ou "handler" peut être associé à un type de document particulier, lequel déterminera le traitement à effectuer par le serveur avant de servir le document.

Les directives AddEncoding, AddHandler, AddLanguage et AddType sont toutes utilisées pour associer des extensions de noms de fichiers aux meta-informations associées à ce fichier. Elles définissent respectivement le type d'encodage (content-encoding), le gestionnaire associé (handler), la langue du document (content-language) et le type MIME (content-type) des documents. La directive TypesConfig sert à définir un fichier qui contiendra également ces associations. Les directives ForceType et SetHandler sont utilisées pour associer tous les fichiers d'un espace particulier (ex. un certain répertoire) à un type MIME ou à un gestionnaire donnés.

Les fichiers peuvent avoir plus d'une extension, et l'ordre de ces extensions n'est en général pas significatif. Par exemple, si le fichier welcome.html.fr est associé à un type de contenu "text/html" et à la langue française, le fichier welcome.fr.html sera associé aux même métainformations. La seule exception à ceci est lorsqu'une extension, inscrite dans le nom du fichier, n'est pas connue d'Apache. Dans ce cas, Apache ignorera toutes les métainformations qu'il pourrait obtenir en analysant les extensions situées à gauche de l'extension inconnue. Ainsi, par exemple, si les extensions .fr et .html sont associées respectivement à la langue française et au type text/html, mais l'extension .xxx n'est pas assignée à quoi que ce soit, alors le fichier welcome.fr.xxx.html se verra bien attribuer une métainformation de type de contenu (text/html dans ce cas) mais pas de métainformation sur la langue.

Notez que lorsque le type ou l'encodage d'un fichier sont modifiés, la valeur du champ d'en-tête Last-Modified: n'est pas affectée. De ce fait, des versions précédemment cachées pourront encore être desservies à un client ou à un proxy, avec l'en-tête précédente.

Directives


Directive : AddEncoding

Syntaxe : AddEncoding mime-enc extension extension...
Contexte : configuration serveur, hôtes virtuels, répertoire, .htaccess
Surcharge : FileInfo
Statut : Base
Module : mod_mime

La directive AddEncoding ajoute une définition à la liste d'extensions de noms de fichiers en précisant comment un nom de fichier doit finir pour être considéré comme encodé par la méthode de codage spécifiée. Mime-enc est le code mime de l'encodage à utiliser pour les documents terminant par extension. Exemple :

AddEncoding x-gzip gz
AddEncoding x-compress Z
Les fichiers terminant en .gz seront marqués comme étant encodés par la méthode x-gzip, et les fichiers en .Z encodés selon la méthode x-compress.


Directive : AddHandler

Syntaxe : AddHandler nom-handler extension extension...
Contexte : configuration serveur, hôtes virtuels, répertoire, .htaccess
Statut : Base
Module : mod_mime
Compatibilité : AddHandler est disponible à partir de la version 1.1 d'Apache

La directive AddHandler associe aux fichiers d'extension extension, le gestionnaire nom-handler. Par exemple, pour activer des scripts CGI écrits dans des fichiers d'extension ".cgi", vous écrirez :

    AddHandler cgi-script cgi

Une fois que cette ligne a été écrite dans votre fichier srm.conf ou httpd.conf, tout fichier dont le nom termine par ".cgi" sera considéré comme un programme CGI.


Directive : AddLanguage

Syntaxe : AddLanguage mime-lang extension extension...
Contexte : configuration serveur, hôtes virtuels, répertoire, .htaccess
Surcharge : FileInfo
Statut : Base
Module : mod_mime

La directive AddLanguage ajoute une définition à la liste d'extensions de noms de fichiers en précisant comment un nom de fichier doit finir pour être considéré comme écrit dans la langue spécifiée. Mime-lang est le code mime de la langue associé aux fichier d'extension extension, une fois que toutes les extensions associées sémantiquement à un type d'encodage ont été supprimées. Exemple :

AddEncoding x-compress Z
AddLanguage en .en
AddLanguage fr .fr
Dans cet exemple, le document xxxx.en.Z est considéré et traité comme étant un fichier en anglais et compressé par la méthode x-compress. La langue du contenu sera reportée au client, bien que celui-ci n'utilise pas nécessairement cette information. La directive AddLanguage est plus utile dans le cadre de la négociation de contenu, par laquelle un serveur est capable de choisir entre plusieurs versions du même document sur la base des préférences de langue indiquées par le client.


AddType

Syntaxe : AddType mime-type extension extension...
Contexte : configuration serveur, hôtes virtuels, répertoire, .htaccess
Surcharge : FileInfo
Statut : Base
Module : mod_mime

La directive AddType ajoute une définition à la liste d'extensions de noms de fichiers en précisant comment un nom de fichier doit finir pour être considéré comme ayant le contenu spécifié. Mime-type est le code mime de type de média à prendre en compte pour les documents terminant par extension, une fois les extensions sémantiquement associées aux métainformations d'encodage et de langues supprimées. Exemple :

AddType image/gif GIF
Il est recommandé d'ajouter des nouveaux types MIME via la directive AddType plutôt qu'en modifiant le fichier TypesConfig.

Notez que, contrairement à httpd NCSA, cette directive ne peut pas être utilisée pour changer le type de fichiers individuels.


ForceType

Syntaxe : ForceType type-media
Contexte : répertoire, .htaccess
Statut : Base
Module : mod_mime
Compatibilité : ForceType est disponible à partir de la version 1.1 d'Apache.

Lorsqu'elle est inscrite dans une fichier .htaccess ou dans des sections <Directory> ou <Location>, cette directive force tous les fichiers qui correspondent à la description à être servis comme si ils étaient associés au type de contenu spécifié par type-media. Par exemple, si vous avez un répertoire rempli de fichiers GIF, pourlesquels vous ne souhaitez pas utiliser systématiquement l'extension ".gif", alors vous écririez :

    ForceType image/gif

Notez que cette affectation surchargera toute ancienne affectation faite sur les extensions de ces fichiers qui peuvent être sémantiquement associées à un type de media.

Directive : SetHandler

Syntaxe : SetHandler nom-handler
Contexte : répertoire, .htaccess
Statut : Base
Module : mod_mime
Compatibilité: SetHandler est disponible à partir de la version 1.1 d'Apache.

Lorsqu'elle est inscrite dans un fichier .htaccess ou à l'intérieur de sections <Directory> ou <Location>, cette directive force tous les fichiers qui correspondent à la description à être servis après traitement par le gestionnaire nommé nom-handler. Par exemple, si un répertoire ne contient que des fichiers de règles "imagemap", et pour lesquelles l'extension n'est pas significative, vous pourriez écrire ceci dans le fichier .htaccess de ce répertoire :

    SetHandler imap-file

Un autre exemple : Si vous souhaitez que le serveur affiche un rapport d'état lorsque l'URL http://votre.serveur.fr/status est requis, vous écririez ces lignes dans access.conf:

    <Location /status>
    SetHandler server-status
    </Location>

Directive : TypesConfig

Syntaxe : TypesConfig nomFichier
Défaut : TypesConfig conf/mime.types
Contexte : configuration serveur
Statut : Base
Module : mod_mime

La directive TypesConfig définit le fichier de déclaration des types mime. nomFichier est un chemin d'accès relativement à ServerRoot. Ce fichier établit la liste des assignations par défaut des extensions de noms de fichiers aux types de contenu ; modifier ce fichier n'est pas recommandé. Utilisez plutôt la directive AddType. Ce fichier contient des lignes du même format que la partie argument de la directive AddType :

type-mime extension extension ...
Les extensions doivent être en minuscules. Les lignes vides, ou celles commençant par une marque de commentaire (`#') sont ignorées.


Apache HTTP Server Version 1.3

Index Home