Module Apache mod_mime

Directive AddCharset

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

Directive AddEncoding

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.

Directive AddHandler

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

Directive AddInputFilter

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

Directive AddLanguage

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

Directive AddOutputFilter

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

Directive AddType

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

Directive DefaultLanguage

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

Directive ModMimeUsePathInfo

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

Directive MultiviewsMatch

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

Directive RemoveCharset

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

Directive RemoveEncoding

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.

Directive RemoveHandler

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.

Directive RemoveInputFilter

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

Directive RemoveLanguage

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.

Directive RemoveOutputFilter

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

Directive RemoveType

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.

Directive TypesConfig

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 à https://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