Movatterモバイル変換


[0]ホーム

URL:


Modules |Directives |FAQ |Glossaire |Plan du site

Serveur HTTP Apache Version 2.4

<-
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'actiondé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. Voirmod_negotiation pour plus d'informations à propos de lanégociation de contenu.

Les directivesAddCharset,AddEncoding,AddLanguage etAddType 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 letype de médium (content-type) des documents. La directiveTypesConfig 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 legestionnaire et lesfiltres qui sont à l'origine du contenu et le traitent. Les directivesAddHandler,AddOutputFilter, etAddInputFilter permettent de contrôler les modules ou les scripts qui vont servir le document. La directiveMultiviewsMatch permet àmod_negotiation de déterminer les extensions de fichiers à inclure lors des tests de correspondances multivues.

Alors quemod_mime associe des métadonnées avec des extensions de fichiers, le serveur de basecore 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 trouveForceType,SetHandler,SetInputFilter, etSetOutputFilter. Les directives du serveur de base l'emportent sur toute directive d'association d'extensions de noms de fichiers définie parmod_mime.

Notez que la modification des métadonnées d'un fichier ne modifie pas la valeur de l'en-têteLast-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.

Support Apache!

Sujets

Directives

Traitement des bugs

Voir aussi

top

Fichiers avec extensionsmultiples

Les fichiers peuvent posséder plusieurs extensions dont l'ordre estnormalement sans importance. Par exemple, si le fichierwelcome.html.fr est associé au type de contenutext/html et à la langue française, le fichierwelcome.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é autype de médiumimage/gif, et.html au type de médiumtext/html, le fichierwelcome.gif.html sera associé au type de médiumtext/html.

LesLanguages et lescodages 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 fichierwelcome.html.en.de sera servi avec les en-têtesContent-Language: en, de etContent-Type: text/html.

Des précautions doivent être prises lorsqu'un fichier avec extensions multiples est associé à la fois à untype 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 gestionnaireimap-file (du modulemod_imagemap), et si l'extension.html est associée au type de médiumtext/html, le fichierworld.imap.html sera à la fois associé au gestionnaireimap-file et au type de médiumtext/html. Pour son traitement, c'est le gestionnaireimap-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 directivesAdd*. Par exemple, si vous souhaitez que le fichierfoo.html.cgi soit traité en tant que script CGI, mais pas le fichierbar.cgi.html, alors, au lieu d'utiliserAddHandler 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'untype 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, commegzip, il peut aussi s'agir de chiffrement, commepgp ou d'un codage comme UUencoding, qui est conçu pour transmettre un fichier binaire sous un format ASCII (texte).

LaRFC 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 lasection ci-dessus à propos des extensions de fichiers multiples), vous pouvez indiquer qu'un fichier est d'untype, particulier, et possède aussi uncodage 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 fichierResume.doc.zip sera identifié comme document Word compressé par pkzip.

Apache joint un en-têteContent-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 (voirmod_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 directivesAddCharset,AddEncoding,AddLanguage etAddType (ainsi que les associations d'extensions listées dans le fichier défini par la directiveMimeMagicFile), participent à ce processus de sélection. Les extensions de noms de fichiers qui n'ont été associés que par des directivesAddHandler,AddInputFilter ouAddOutputFilter, peuvent être incluses ou exclues du processus de sélection en utilisant la directiveMultiviewsMatch.

Jeu de caractères

Pour transmettre cette information supplémentaire, Apache peut ajouter un en-têteContent-Language, afin de spécifier la langue dans laquelle le document est écrit, et peut ajouter des informations additionnelles à l'en-têteContent-Type pour indiquer le jeu de caractères particulier qui doit être utilisé pour restituer correctement le document.

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

La langue est spécifiée via son abréviation en deux lettres. Lejeu de caractères est le nom du jeu de caractères particulier qui doit être utilisé.

top

DirectiveAddCharset

Description:Associe les extensions de noms de fichiers spécifiées aujeu de caractères spécifié
Syntaxe:AddCharsetjeu-carextension[extension] ...
Contexte:configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveAddCharset 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 leparamètre jeu de caractères du type de médium pour les ressources dont le nom de fichier contientextension. Cette association est ajoutée à toutes les autres déjà en vigueur, et écrase toute association préexistante pour la mêmeextension.

Exemple

AddLanguage ja .jaAddCharset EUC-JP .eucAddCharset ISO-2022-JP .jisAddCharset SHIFT_JIS .sjis

Avec cet exemple, le documentxxxx.ja.jis sera traité en tant que document japonais dont le jeu de caractère estISO-2022-JP (idem pour le documentxxxx.jis.ja). La directiveAddCharset 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 à lané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'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséderplusieurs extensions, et l'argumentextension sera comparé à chacune d'entre elles.

Voir aussi

top

DirectiveAddEncoding

Description:Associe les extensions de noms de fichiers données au typede codage spécifié
Syntaxe:AddEncodingcodageextension[extension] ...
Contexte:configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveAddEncoding 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êmeextension.

Exemple

AddEncoding x-gzip .gzAddEncoding x-compress .Z

Avec cet exemple, les noms de fichiers possédant l'extension.gz seront marqués comme codés à l'aide du codagex-gzip, et les noms de fichiers possédant l'extension.Z comme codés avecx-compress.

Les clients anciens n'acceptent quex-gzip etx-compress, bien que les standards stipulent qu'ils sont respectivement équivalents àgzip etcompress. Apache effectue ses comparaisons de codages de contenu en ignorant tout préfixex-. Lorsqu'il répond avec un codage, Apache utilise l'une ou l'autre forme (c'est à direx-foo oufoo) 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 directiveAddEncoding. Pour résumer, vous devez toujours utiliserx-gzip etx-compress pour ces deux codages spécifiques. Certains codages plus récents, commedeflate, doivent être spécifiés sans le préfixex-.

L'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséderplusieurs extensions, et l'argumentextension sera comparé à chacune d'entre elles.

top

DirectiveAddHandler

Description:Associe les extensions de noms de fichiers données augestionnaire spécifié
Syntaxe:AddHandlernom-gestionnaireextension[extension] ...
Contexte:configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

Les fichiers dont le nom a pour extensionextension seront servis par lenom-gestionnaire spécifié. Cette association est ajoutée à toutes les autres déjà en vigueur, et écrase toute association préexistante pour la mêmeextension. 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 httpd.conf, tout fichier possédant l'extension.cgi sera traité en tant que programme CGI.

L'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséderplusieurs extensions, et l'argumentextension sera comparé à chacune d'entre elles.

Voir aussi

top

DirectiveAddInputFilter

Description:Associe les extensions de noms de fichiers auxfiltres spécifiés qui traiteront les requêtes clients
Syntaxe:AddInputFilterfiltre[;filtre...]extension [extension] ...
Contexte:configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveAddInputFilter permet d'associer l'extension de nom de fichierextension auxfiltres 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 directiveSetInputFilter. Cette association est ajoutée à toutes les autres déjà en vigueur, et écrase toute association préexistante pour la mêmeextension.

Si plusieursfiltres 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'argumentfiltre est insensible à la casse.

L'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséderplusieurs extensions, et l'argumentextension sera comparé à chacune d'entre elles.

Voir aussi

top

DirectiveAddLanguage

Description:Associe l'extension de nom de fichier donnée à la languespécifié
Syntaxe:AddLanguagesymbole-langueextension[extension] ...
Contexte:configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveAddLanguage 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'argumentextension se voient attribuer la valeur de l'argumentsymbole-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êmeextension.

Exemple

AddEncoding x-compress .ZAddLanguage en .enAddLanguage fr .fr

Avec cet exemple, le documentxxxx.en.Z sera traité en tant que document compressé de langue anglaise (idem pour le documentxxxx.Z.en). Bien que la langue soit fournie au client, le navigateur n'utilise habituellement pas cette information. La directiveAddLanguage est principalement utilisée au cours de lané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 .enAddLanguage en-gb .enAddLanguage en-us .en

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

L'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséderplusieurs extensions, et l'argumentextension sera comparé à chacune d'entre elles.

Voir aussi

top

DirectiveAddOutputFilter

Description:Associe les extensions de noms de fichiers auxfiltres spécifiés qui traiteront les réponses en provenance duserveur
Syntaxe:AddOutputFilterfiltre[;filtre...]extension [extension] ...
Contexte:configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveAddOutputFilter permet d'associer l'extension de nom de fichier définie par l'argumentextension auxfiltres 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 commeSetOutputFilter etAddOutputFilterByType. Cette association est fusionnée avec toute autre association en vigueur, et l'emporte sur toute association préexistante pour la mêmeextension.

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

AddOutputFilter INCLUDES;DEFLATE shtml

Si plusieursfiltres 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'argumentfiltre est insensible à la casse.

L'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséderplusieurs extensions, et l'argumentextension sera comparé à chacune d'entre elles.

Notez que toute définition de filtres via la directiveAddOutputFilter 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

DirectiveAddType

Description:Associe les extensions de noms de fichiers au type decontenu spécifié
Syntaxe:AddTypetype-médiumextension[extension] ...
Contexte:configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveAddType permet d'associer les extensions de noms de fichiers données au type de contenu spécifié.type-médium est leType MIME à utiliser pour les fichiers dont le nom possède l'extensionextension. Cette association s'ajoute à toute autre association en vigueur, et l'emporte sur toute association préexistante pour la mêmeextension.

Plutôt que d'éditer directement le fichierTypesConfig, il est recommandé d'utiliser la directiveAddType 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'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséderplusieurs extensions, et l'argumentextension sera comparé à chacune d'entre elles.

Il est possible d'obtenir un effet similaire à celui de la directiveLanguagePriority du modulemod_negotiation en qualifiant untype de média avecqs :

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êteAccept: */* à 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.

Note

Si aucun gestionnaire n'est explicitement défini pour une requête, le type de contenu spécifié sera aussi utilisé comme nom du gestionnaire.

Lorsqu'aucune directive commeSetHandler ouAddHandler ne s'applique à une requête, le nom de gestionnaire interne normalement défini par une de ces directives est en fait défini par le type de contenu spécifié par la présente directive.

Pour des raisons historiques, certains modules tiers comme mod_php peuvent adopter ce type de comportement pour prendre en compte 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 directivesSetHandler ouAddHandler doivent aussi limiter l'accès à la directive AddType.

Voir aussi

top

DirectiveDefaultLanguage

Description:Définit un symbole de langue par défaut à affecter au champd'en-tête Content-Language pour toutes les ressources dans le contextecourant auxquelles aucun symbole de langue n'a étéassocié.
Syntaxe:DefaultLanguagesymbole-langue
Contexte:configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveDefaultLanguage 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 directiveAddLanguage), verront leur en-tête HTTP Content-Language affecté de la languesymbole-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 directiveDefaultLanguage n'est en vigueur, et si un fichier ne possède pas d'extension configurée par la directiveAddLanguage, aucun champ d'en-tête Content-Language ne sera généré.

Exemple

DefaultLanguage en

Voir aussi

top

DirectiveModMimeUsePathInfo

Description:Indique àmod_mime de traiter les élémentsdepath_info en tant que parties du nom defichier
Syntaxe:ModMimeUsePathInfo On|Off
Défaut:ModMimeUsePathInfo Off
Contexte:répertoire
Statut:Base
Module:mod_mime

La directiveModMimeUsePathInfo permet de combiner le nom de fichier avec la partiepath_info de l'URL pour appliquer les directivesmod_mime à la requête. La valeur par défaut estOff - situation dans laquelle l'élémentpath_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 commeAddOutputFilter INCLUDES .shtml ajouteront le filtreINCLUDES à la requête. Si la directiveModMimeUsePathInfo n'est pas définie, le filtreINCLUDES 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

DirectiveMultiviewsMatch

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

La directiveMultiviewsMatch permet trois comportements différents pour la fonctionnalité Multiviews du modulemod_negotiation. Les vues multiples permettent d'associer une requête pour un fichier, par exempleindex.html, à toute extension négociée s'ajoutant à la requête de base, par exempleindex.html.en,index.html.fr, ouindex.html.gz.

L'optionNegotiatedOnly implique que toute extension s'ajoutant au nom de base doit correspondre à une extension demod_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 directiveMultiviewsMatch avec les mots-clésHandlers,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 entreindex.html.cgi de 500 octets etindex.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 gestionnaireasis-handler.

Vous pouvez enfin autoriser l'association de toute extension avec l'optionAny, même simod_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 directiveMultiviewsMatch dans une section<Location> ou<LocationMatch> n'est pas permise.

Voir aussi

top

DirectiveRemoveCharset

Description:Supprime toute association de jeu de caractères pour unensemble d'extensions de noms de fichiers
Syntaxe:RemoveCharsetextension [extension]...
Contexte:serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveRemoveCharset 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'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial.

Exemple

RemoveCharset .html .shtml
top

DirectiveRemoveEncoding

Description:Supprime toute association de codage de contenu pour unensemble d'extensions de noms de fichiers
Syntaxe:RemoveEncodingextension [extension]...
Contexte:serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveRemoveEncoding 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 .gzAddType text/plain .asc<Files "*.gz.asc">    RemoveEncoding .gz</Files>

Avec cette configuration, le fichierfoo.gz sera marqué comme codé avec gzip, maisfoo.gz.asc sera marqué comme fichier texte non codé.

Note

Les directivesRemoveEncoding étant traitéesaprès toute directiveAddEncoding, 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'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial.

top

DirectiveRemoveHandler

Description:Supprime toute association de gestionnaire à un ensembled'extensions de noms de fichiers
Syntaxe:RemoveHandlerextension [extension]...
Contexte:serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveRemoveHandler 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 modulemod_include module).

L'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial.

top

DirectiveRemoveInputFilter

Description:Supprime toute association de filtre en entrée à unensemble d'extensions de noms de fichiers
Syntaxe:RemoveInputFilterextension [extension]...
Contexte:serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveRemoveInputFilter permet de supprimer toute association defiltre 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'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial.

Voir aussi

top

DirectiveRemoveLanguage

Description:Supprime toute association de langue à un ensembled'extensions de noms de fichiers
Syntaxe:RemoveLanguageextension [extension]...
Contexte:serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveRemoveLanguage 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'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial.

top

DirectiveRemoveOutputFilter

Description:Supprime toute association de filtre en sortie à unensemble d'extensions de noms de fichiers
Syntaxe:RemoveOutputFilterextension [extension]...
Contexte:serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveRemoveOutputFilter permet de supprimer toute association defiltre 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'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial.

Exemple

RemoveOutputFilter shtml

Voir aussi

top

DirectiveRemoveType

Description:Supprime toute association de type de contenu à un ensembled'extensions de noms de fichiers
Syntaxe:RemoveTypeextension [extension]...
Contexte:serveur virtuel, répertoire, .htaccess
Surcharges autorisées:FileInfo
Statut:Base
Module:mod_mime

La directiveRemoveType permet de supprimer toute association detype 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 directivesRemoveType sont traitéesaprès toutes les directivesAddType, 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'argumentextension est insensible à la casse et peut être spécifié avec ou sans le point initial.

top

DirectiveTypesConfig

Description:Le chemin du fichiermime.types
Syntaxe:TypesConfigchemin-fichier
Défaut:TypesConfig conf/mime.types
Contexte:configuration globale
Statut:Base
Module:mod_mime

La directiveTypesConfig permet de définir le chemin du fichier de configuration destypes de média. L'argumentchemin-fichier est un chemin relatif au répertoire défini par la directiveServerRoot. 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 fichiermime.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 fichierhttpd.conf en fournissant la majorité des définitions de types de média, et ses définitions peuvent être écrasées par des directivesAddType, selon les besoins. Il est déconseillé de modifier le contenu du fichiermime.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 directiveAddType :

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

Merci dene pas soumettre de requêtes au Projet de Serveur HTTP Apache pour ajouter une entrée dans le fichiermime.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 typecaté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 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 Libera.chat, or sent to ourmailing lists.

Copyright 2025 The Apache Software Foundation.
Autorisé sousApache License, Version 2.0.

Modules |Directives |FAQ |Glossaire |Plan du site


[8]ページ先頭

©2009-2025 Movatter.jp