<-
Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_mime

Langues Disponibles:  en  |  fr  |  ja 

Description:Associe les extensions des fichiers demand�s avec l'action d�clench�e par ces fichiers et avec leur contenu (type MIME, langue, jeu de caract�re et codage)
Statut:Base
Identificateur�de�Module:mime_module
Fichier�Source:mod_mime.c

Sommaire

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, la langue, 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 mod_negotiation pour plus d'informations � propos de la n�gociation de contenu.

Les directives AddCharset, AddEncoding, AddLanguage et AddType permettent d'associer des extensions de fichiers aux m�tadonn�es de ces fichiers. Elles d�finissent respectivement le jeu de caract�res, le codage du contenu, la langue du contenu et le type de m�dium (content-type) des documents. La directive TypesConfig permet de sp�cifier un fichier qui contient lui-m�me des associations entre extensions et types de media.

De plus, mod_mime peut d�finir le gestionnaire et les filtres qui sont � l'origine du contenu et le traitent. Les directives AddHandler, AddOutputFilter, et AddInputFilter permettent de contr�ler les modules ou les scripts qui vont servir le document. La directive MultiviewsMatch permet � mod_negotiation de d�terminer les extensions de fichiers � inclure lors des tests de correspondances multivues.

Alors que mod_mime associe des m�tadonn�es avec des extensions de fichiers, le serveur de base core fournit des directives permettant d'associer tous les fichiers d'un conteneur donn� (par exemple <Location>, <Directory>, ou <Files>) avec des m�tadonn�es particuli�res. Parmi ces directives, on trouve ForceType, SetHandler, SetInputFilter, et SetOutputFilter. Les directives du serveur de base l'emportent sur toute directive d'association d'extensions de noms de fichiers d�finie par mod_mime.

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 (langue, 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.

Directives

Sujets

Voir aussi

top

Fichiers avec extensions multiples

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 � la langue fran�aise, 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 langues et les codages de contenu. Par exemple, si .gif est associ� au type de m�dium 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 langues 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 type de m�dium et � un gestionnaire. En g�n�ral, cela impliquera la gestion de la requ�te par le module associ� au gestionnaire. Par exemple, si l'extension .imap est associ�e au gestionnaire imap-file (du module mod_imagemap), et si l'extension .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 :

Configuration du gestionnaire en se basant seulement sur la derni�re extension

<FilesMatch \.cgi$>
  SetHandler cgi-script
</FilesMatch>
top

Codage du contenu

Un fichier d'un type de m�dium particulier peut �tre �galement cod� d'une certaine mani�re pour simplifier sa transmission sur Internet. Alors que cela concerne en g�n�ral la compression, comme 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.

Content-encoding: pkzip
top

Jeux de caract�res et langues

En plus du type de fichier et du codage, un autre �l�ment important d'information est la langue dans laquelle 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 �galement transmise via des en-t�tes HTTP.

Les jeu de caract�res, langue, codage et type MIME sont tous utilis�s au cours du processus de n�gociation de contenu (voir mod_negotiation) afin de d�terminer quel document servir au client, lorsque plusieurs choix sont possibles en fonction du jeu de caract�res, de la langue, du codage ou du type MIME. Toutes les associations d'extensions de noms de fichiers cr��es via les directives AddCharset, AddEncoding, AddLanguage et AddType (ainsi que les associations d'extensions list�es dans le fichier d�fini par la directive MimeMagicFile), participent � ce processus de s�lection. Les extensions de noms de fichiers qui n'ont �t� associ�s que par des directives AddHandler, AddInputFilter ou AddOutputFilter, peuvent �tre incluses ou exclues du processus de s�lection en utilisant la directive MultiviewsMatch.

Jeu de caract�res

Pour transmettre cette information suppl�mentaire, Apache peut ajouter un en-t�te Content-Language, afin de sp�cifier la langue dans laquelle 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.

Content-Language: en, fr Content-Type: text/plain; charset=ISO-8859-1

La langue est sp�cifi�e 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�.

top

AddCharset Directive

Description:Associe les extensions de noms de fichiers sp�cifi�es au jeu de caract�res sp�cifi�
Syntaxe:AddCharset jeu-car extension [extension] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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.

Exemple

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

top

AddEncoding Directive

Description:Associe les extensions de noms de fichiers donn�es au type de codage sp�cifi�
Syntaxe:AddEncoding codage extension [extension] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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.

Exemple

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.

top

AddHandler Directive

Description:Associe les extensions de noms de fichiers donn�es au gestionnaire sp�cifi�
Syntaxe:AddHandler nom-gestionnaire extension [extension] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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

top

AddInputFilter Directive

Description:Associe les extensions de noms de fichiers aux filtres sp�cifi�s qui traiteront les requ�tes clients
Syntaxe:AddInputFilter filtre[;filtre...] extension [extension] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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

top

AddLanguage Directive

Description:Associe l'extension de nom de fichier donn�e � la langue sp�cifi�
Syntaxe:AddLanguage symbole-langue extension [extension] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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.

Exemple

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

top

AddOutputFilter Directive

Description:Associe les extensions de noms de fichiers aux filtres sp�cifi�s qui traiteront les r�ponses en provenance du serveur
Syntaxe:AddOutputFilter filtre[;filtre...] extension [extension] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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

top

AddType Directive

Description:Associe les extensions de noms de fichiers au type de contenu sp�cifi�
Syntaxe:AddType type-m�dium extension [extension] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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.

Plut�t que d'�diter directement le fichier TypesConfig, il est recommand� d'utiliser la directive AddType pour ajouter de nouveaux types de m�dias.

Exemple

AddType image/gif .gif

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

Exemple

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 :

Exemple

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

top

DefaultLanguage Directive

Description:D�finit un symbole de langue par d�faut � affecter au champ d'en-t�te Content-Language pour toutes les ressources dans le contexte courant auxquelles aucun symbole de langue n'a �t� associ�.
Syntaxe:DefaultLanguage symbole-langue
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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

Exemple

DefaultLanguage en

Voir aussi

top

ModMimeUsePathInfo Directive

Description:Indique � mod_mime de traiter les �l�ments de path_info en tant que parties du nom de fichier
Syntaxe:ModMimeUsePathInfo On|Off
D�faut:ModMimeUsePathInfo Off
Contexte:r�pertoire
Statut:Base
Module:mod_mime

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.

Exemple

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

top

MultiviewsMatch Directive

Description:Les types de fichiers qui seront inclus lors d'une recherche de correspondance de fichier avec les vues multiples (MultiViews)
Syntaxe:MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers [Handlers|Filters]
D�faut:MultiviewsMatch NegotiatedOnly
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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

top

RemoveCharset Directive

Description:Supprime toute association de jeu de caract�res pour un ensemble d'extensions de noms de fichiers
Syntaxe:RemoveCharset extension [extension] ...
Contexte:serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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.

Exemple

RemoveCharset .html .shtml
top

RemoveEncoding Directive

Description:Supprime toute association de codage de contenu pour un ensemble d'extensions de noms de fichiers
Syntaxe:RemoveEncoding extension [extension] ...
Contexte:serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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 :

/foo/.htaccess:

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

Note

Les directives RemoveEncoding �tant trait�es apr�s toute directive AddEncoding, il est possible qu'elles annulent les effets de ces derni�res si les deux apparaissent dans la configuration du m�me r�pertoire.

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

top

RemoveHandler Directive

Description:Supprime toute association de gestionnaire � un ensemble d'extensions de noms de fichiers
Syntaxe:RemoveHandler extension [extension] ...
Contexte:serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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 :

/foo/.htaccess:

AddHandler server-parsed .html

/foo/bar/.htaccess:

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.

top

RemoveInputFilter Directive

Description:Supprime toute association de filtre en entr�e � un ensemble d'extensions de noms de fichiers
Syntaxe:RemoveInputFilter extension [extension] ...
Contexte:serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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

top

RemoveLanguage Directive

Description:Supprime toute association de langue � un ensemble d'extensions de noms de fichiers
Syntaxe:RemoveLanguage extension [extension] ...
Contexte:serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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.

top

RemoveOutputFilter Directive

Description:Supprime toute association de filtre en sortie � un ensemble d'extensions de noms de fichiers
Syntaxe:RemoveOutputFilter extension [extension] ...
Contexte:serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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.

Exemple

RemoveOutputFilter shtml

Voir aussi

top

RemoveType Directive

Description:Supprime toute association de type de contenu � un ensemble d'extensions de noms de fichiers
Syntaxe:RemoveType extension [extension] ...
Contexte:serveur virtuel, r�pertoire, .htaccess
AllowOverride:FileInfo
Statut:Base
Module:mod_mime

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 :

/foo/.htaccess:

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.

Note

Les directives RemoveType sont trait�es apr�s toutes les directives AddType, et il est possible que les effets de ces derni�res soient annul�s si les deux types de directives sont pr�sents au sein de la configuration du m�me r�pertoire.

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

top

TypesConfig Directive

Description:Le chemin du fichier mime.types
Syntaxe:TypesConfig chemin-fichier
D�faut:TypesConfig conf/mime.types
Contexte:configuration du serveur
Statut:Base
Module:mod_mime

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 :

type-m�dium [extension] ...

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.

Merci de ne pas soumettre de requ�tes au Projet de Serveur HTTP Apache pour ajouter une entr�e dans le fichier 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 inombrables langues pr�existantes et les espaces de nommage des jeux de caract�res.

Voir aussi

Langues Disponibles:  en  |  fr  |  ja 

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.