Ce module permet d'assigner des métadonnées aux contenus
sélectionnés pour une réponse HTTP, en associant des modèles d'URI
ou de noms de fichiers aux valeurs des métadonnées. Par exemple, les
extensions de noms de fichiers définissent souvent le type de médium
Internet, le langage, le jeu de caractères et le codage du contenu.
Ces informations sont relayées par les messages HTTP véhiculant ces
contenus, et utilisées au cours de la négociation de contenu lors de
la sélection des différentes possibilités, de manière à ce que les
préférences des utilisateurs soient respectées lors du choix d'un
contenu à servir parmi plusieurs autres contenus. Voir
Les directives
De plus,
Alors que
Notez que la modification des métadonnées d'un fichier ne modifie
pas la valeur de l'en-tête Last-Modified
. Ainsi,
certaines copies de documents préalablement mises en cache peuvent
encore être utilisées par un client ou un mandataire avec les
anciens en-têtes. Si vous modifiez les métadonnées (langage, type de
contenu, jeu de caractère ou codage), vous devez donc enregistrer
une modification du fichier concerné (afin de mettre à jour sa date
de dernière modification), pour être sûr que tous les visiteurs
recevront le documents avec les en-têtes corrects.
Les fichiers peuvent posséder plusieurs extensions dont l'ordre
est normalement sans importance. Par exemple, si
le fichier welcome.html.fr
est associé au type de
contenu text/html
et au langage Français, le fichier
welcome.fr.html
possèdera exactement les même
métadonnées. Si le fichier possède plusieurs extensions associées
au même type de métadonnée, c'est celle de ces extensions la plus à
droite qui sera utilisée, excepté pour ce qui concerne les langages
et les codages de contenu. Par exemple, si .gif
est
associé au image/gif
, et .html
au type de médium
text/html
, le fichier welcome.gif.html
sera associé au type de médium text/html
.
Les Languages et les codages de contenu sont traités de
manière cumulative, car il est possible d'assigner plusieurs
langages ou codages à une ressource particulière. Par exemple, le
fichier welcome.html.en.de
sera servi avec les en-têtes
Content-Language: en, de
et Content-Type:
text/html
.
Des précautions doivent être prises lorsqu'un fichier avec
extensions multiples est associé à la fois à un .imap
est associée au
gestionnaire imap-file
(du module
.html
est associée au type de médium text/html
, le fichier
world.imap.html
sera à la fois associé au gestionnaire
imap-file
et au type de médium text/html
.
Pour son traitement, c'est le gestionnaire imap-file
qui sera utilisé, et il sera donc traité en tant que fichier
imagemap.
Si vous préférez que seule la dernière partie d'un nom de fichier
séparée du reste du nom par un point soit associée à une métadonnée
particulière, n'utilisez pas les directives Add*
. Par
exemple, si vous souhaitez que le fichier foo.html.cgi
soit traité en tant que script CGI, mais pas le fichier
bar.cgi.html
, alors, au lieu d'utiliser
AddHandler cgi-script .cgi
, utilisez plutôt :
Un fichier d'un gzip
, il peut aussi s'agir de
chiffrement, comme pgp
ou d'un codage comme UUencoding,
qui est conçu pour transmettre un fichier binaire sous un format
ASCII (texte).
La RFC HTTP/1.1, section 14.11 stipule à ce titre :
Le champ d'en-tête Content-Encoding de l'entité est utilisé en tant que modificateur du type de médium. Lorsqu'il est présent, sa valeur indique quels codages de contenu additionnels ont été appliqués au corps de l'entité, et ainsi quels mécanismes de décodage doivent être appliqués afin de retrouver le type de médium référencé par le champ d'en-tête Content-Type. Le codage de contenu est principalement utilisé pour permettre la compression d'un document sans perdre l'information concernant le type de médium sous-jacent.
En utilisant plusieurs extensions (voir la section ci-dessus à propos des extensions de fichiers multiples), vous pouvez indiquer qu'un fichier est d'un type, particulier, et possède aussi un codage particulier.
Considérons par exemple un fichier contenant un document
Microsoft Word et compressé par pkzip pour réduire sa taille. Si
l'extension .doc
est associée au type de fichier
Microsoft Word, et si l'extension .zip
est associée au
codage de fichier pkzip, alors le fichier
Resume.doc.zip
sera identifié comme document Word
compressé par pkzip.
Apache joint un en-tête Content-encoding
à la
ressource afin d'informer le navigateur client à propos de la
méthode de codage.
En plus du type de fichier et du codage, un autre élément important d'information est le langage dans lequel le document est écrit, et avec quel jeu de caractères le contenu du fichier doit être affiché. Par exemple, un document peut être écrit en alphabet vietnamien ou cyrillique, et doit être affiché en conséquence. Cette information est aussi transmise via des en-têtes HTTP.
Les jeu de caractères, langage, codage et type MIME sont tous
utilisés au cours du processus de négociation de contenu (voir
Pour transmettre cette information supplémentaire, Apache peut
ajouter un en-tête Content-Language
, afin de
spécifier le langage dans lequel le document est écrit, et peut
ajouter des informations additionnelles à l'en-tête
Content-Type
pour indiquer le jeu de caractères
particulier qui doit être utilisé pour restituer correctement le
document.
Le langage est spécifié via son abréviation en deux lettres. Le
jeu de caractères
est le nom du jeu de caractères
particulier qui doit être utilisé.
La directive
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
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.
La directive
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.
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
:
Une fois cette ligne insérée dans votre fichier httpd.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.
La directive
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.
La directive
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 le langage soit fourni au
client, le navigateur n'utilise habituellement pas cette
information. La directive
Si une extension fait l'objet de plusieurs associations de langages, c'est la dernière qui sera utilisée. Ainsi, dans le cas suivant,
les documents possédant l'extension .en
seront
traités en tant que documents de langage 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.
La directive
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
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
La directive
Ou, pour spécifier plusieurs extensions dans une seule directive :
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 qs
:
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.
A 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.
Si aucun gestionnaire n'a été explicitement défini pour une requête, c'est le type de contenu spécifié qui sera utilisé comme nom de gestionnaire.
Lorsqu'aucune directive comme
Pour des raisons historiques, certains modules tiers comme mod_php peuvent adopter ce comportement pour forcer la prise en compte de la requête concernée.
Il est conseillé d'éviter les configurations qui reposent sur de
tels types "synthétiques". En outre, les configurations qui
limitent l'accès aux directives
La directive index.html
, à toute extension négotié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
Pour inclure des extensions associées avec des gestionnaires
et/ou des filtres, définissez la directive
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
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 :
L'utilisation de la directive
La directive .fr
ou .de
tel que défini par la
directive
Si aucune directive
path_info
en tant que parties du nom de
fichierLa directive path_info
de
l'URL pour appliquer les directives 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.
Considérons une requête pour /index.php/foo.shtml
,
/index.php/foo.shtml
et les directives comme
AddOutputFilter INCLUDES .shtml
ajouteront le filtre
INCLUDES
à la requête. Si la directive
INCLUDES
ne sera pas ajouté. Le fonctionnement
sera identique dans le cas des chemins virtuels, tels que ceux
définis par la directive
La directive .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.
La directive .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 :
Avec cette configuration, le fichier foo.gz
sera
marqué comme codé avec gzip, mais foo.gz.asc
sera
marqué comme fichier texte non codé.
Les directives
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial.
La directive .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 :
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
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial.
La directive .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.
La directive .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.
La directive .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.
La directive .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 :
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.
Les directives
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial.
mime.types
La directive mime.types
fourni
par leur OS,
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 httpd.conf
en fournissant la
majorité des définitions de types de média, et ses définitions
peuvent être écrasées par des directives 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
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
mime.types
fourni, sauf si :
1) le type de médium est déjà enregistré à l'IANA
2) et si l'extension est largement acceptée et ne provoque pas de
conflits d'extensions entre les différentes plate-formes. Les
requêtes du type catégorie/x-sous-type
seront
systématiquement rejetées, ainsi que toute nouvelle extension de
deux lettres, car elle ont de fortes chances d'entrer en conflit
par la suite avec les innombrables langages préexistants et les
espaces de nommage des jeux de caractères.