1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
4 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 This file is generated from xml source: DO NOT EDIT
8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
10 <title>mod_mime - Serveur Apache HTTP Version 2.4</title>
11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
13 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
19 <div id="page-header">
20 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
21 <p class="apache">Serveur Apache HTTP Version 2.4</p>
22 <img alt="" src="../images/feather.png" /></div>
23 <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
25 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Modules</a></div>
26 <div id="page-content">
27 <div id="preamble"><h1>Module Apache mod_mime</h1>
29 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_mime.html" hreflang="en" rel="alternate" title="English"> en </a> |
30 <a href="../fr/mod/mod_mime.html" title="Français"> fr </a> |
31 <a href="../ja/mod/mod_mime.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
33 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Associe les extensions des fichiers demandés avec l'action
34 déclenchée par ces fichiers et avec leur contenu (type MIME, langue,
35 jeu de caractère et codage)</td></tr>
36 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
37 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>mime_module</td></tr>
38 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_mime.c</td></tr></table>
41 <p>Ce module permet d'assigner des métadonnées aux contenus
42 sélectionnés pour une réponse HTTP, en associant des modèles d'URI
43 ou de noms de fichiers aux valeurs des métadonnées. Par exemple, les
44 extensions de noms de fichiers définissent souvent le type de médium
45 Internet, la langue, le jeu de caractères et le codage du contenu.
46 Ces informations sont relayées par les messages HTTP véhiculant ces
47 contenus, et utilisées au cours de la négociation de contenu lors de
48 la sélection des différentes possibilités, de manière à ce que les
49 préférences des utilisateurs soient respectées lors du choix d'un
50 contenu à servir parmi plusieurs autres contenus. Voir
51 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> pour plus d'informations à propos
52 de la <a href="../content-negotiation.html">négociation de
55 <p>Les directives <code class="directive"><a href="#addcharset">AddCharset</a></code>, <code class="directive"><a href="#addencoding">AddEncoding</a></code>, <code class="directive"><a href="#addlanguage">AddLanguage</a></code> et <code class="directive"><a href="#addtype">AddType</a></code> permettent d'associer des
56 extensions de fichiers aux métadonnées de ces fichiers. Elles
57 définissent respectivement le jeu de caractères, le codage du
58 contenu, la langue du contenu et le <a class="glossarylink" href="../glossary.html#type de médium" title="voir glossaire">type de
59 médium</a> (content-type) des documents. La directive
60 <code class="directive"><a href="#typesconfig">TypesConfig</a></code> permet de
61 spécifier un fichier qui contient lui-même des associations entre
62 extensions et types de media.</p>
64 <p>De plus, <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> peut définir le <a href="../handler.html">gestionnaire</a> et les <a href="../filter.html">filtres</a> qui sont à l'origine du contenu et
65 le traitent. Les directives <code class="directive"><a href="#addhandler">AddHandler</a></code>, <code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code>, et <code class="directive"><a href="#addinputfilter">AddInputFilter</a></code> permettent de contrôler
66 les modules ou les scripts qui vont servir le document. La directive
67 <code class="directive"><a href="#multiviewsmatch">MultiviewsMatch</a></code> permet à
68 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> de déterminer les extensions de
69 fichiers à inclure lors des tests de correspondances multivues.</p>
71 <p>Alors que <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> associe des métadonnées avec
72 des extensions de fichiers, le serveur de base <code class="module"><a href="../mod/core.html">core</a></code>
73 fournit des directives permettant d'associer tous les fichiers d'un
74 conteneur donné (par exemple <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, ou <code class="directive"><a href="../mod/core.html#files"><Files></a></code>) avec des métadonnées particulières.
75 Parmi ces directives, on trouve <code class="directive"><a href="../mod/core.html#forcetype">ForceType</a></code>, <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>, <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code>, et <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code>. Les directives du serveur
76 de base l'emportent sur toute directive d'association d'extensions
77 de noms de fichiers définie par <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code>.</p>
79 <p>Notez que la modification des métadonnées d'un fichier ne modifie
80 pas la valeur de l'en-tête <code>Last-Modified</code>. Ainsi,
81 certaines copies de documents préalablement mises en cache peuvent
82 encore être utilisées par un client ou un mandataire avec les
83 anciens en-têtes. Si vous modifiez les métadonnées (langue, type de
84 contenu, jeu de caractère ou codage), vous devez donc enregistrer
85 une modification du fichier concerné (afin de mettre à jour sa date
86 de dernière modification), pour être sûr que tous les visiteurs
87 recevront le documents avec les en-têtes corrects. </p>
89 <div id="quickview"><h3>Sujets</h3>
91 <li><img alt="" src="../images/down.gif" /> <a href="#multipleext">Fichiers avec extensions
93 <li><img alt="" src="../images/down.gif" /> <a href="#contentencoding">Codage du contenu</a></li>
94 <li><img alt="" src="../images/down.gif" /> <a href="#charset-lang">Jeux de caractères et langues</a></li>
95 </ul><h3 class="directives">Directives</h3>
97 <li><img alt="" src="../images/down.gif" /> <a href="#addcharset">AddCharset</a></li>
98 <li><img alt="" src="../images/down.gif" /> <a href="#addencoding">AddEncoding</a></li>
99 <li><img alt="" src="../images/down.gif" /> <a href="#addhandler">AddHandler</a></li>
100 <li><img alt="" src="../images/down.gif" /> <a href="#addinputfilter">AddInputFilter</a></li>
101 <li><img alt="" src="../images/down.gif" /> <a href="#addlanguage">AddLanguage</a></li>
102 <li><img alt="" src="../images/down.gif" /> <a href="#addoutputfilter">AddOutputFilter</a></li>
103 <li><img alt="" src="../images/down.gif" /> <a href="#addtype">AddType</a></li>
104 <li><img alt="" src="../images/down.gif" /> <a href="#defaultlanguage">DefaultLanguage</a></li>
105 <li><img alt="" src="../images/down.gif" /> <a href="#modmimeusepathinfo">ModMimeUsePathInfo</a></li>
106 <li><img alt="" src="../images/down.gif" /> <a href="#multiviewsmatch">MultiviewsMatch</a></li>
107 <li><img alt="" src="../images/down.gif" /> <a href="#removecharset">RemoveCharset</a></li>
108 <li><img alt="" src="../images/down.gif" /> <a href="#removeencoding">RemoveEncoding</a></li>
109 <li><img alt="" src="../images/down.gif" /> <a href="#removehandler">RemoveHandler</a></li>
110 <li><img alt="" src="../images/down.gif" /> <a href="#removeinputfilter">RemoveInputFilter</a></li>
111 <li><img alt="" src="../images/down.gif" /> <a href="#removelanguage">RemoveLanguage</a></li>
112 <li><img alt="" src="../images/down.gif" /> <a href="#removeoutputfilter">RemoveOutputFilter</a></li>
113 <li><img alt="" src="../images/down.gif" /> <a href="#removetype">RemoveType</a></li>
114 <li><img alt="" src="../images/down.gif" /> <a href="#typesconfig">TypesConfig</a></li>
116 <h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_mime">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_mime">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
118 <li><code class="directive"><a href="../mod/mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></code></li>
119 <li><code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code></li>
120 <li><code class="directive"><a href="../mod/core.html#forcetype">ForceType</a></code></li>
121 <li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li>
122 <li><code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code></li>
123 <li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li>
124 <li><a href="#comments_section">Commentaires</a></li></ul></div>
125 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
126 <div class="section">
127 <h2><a name="multipleext" id="multipleext">Fichiers avec extensions
129 <p>Les fichiers peuvent posséder plusieurs extensions dont l'ordre
130 est <em>normalement</em> sans importance. Par exemple, si
131 le fichier <code>welcome.html.fr</code> est associé au type de
132 contenu <code>text/html</code> et à la langue française, le fichier
133 <code>welcome.fr.html</code> possèdera exactement les même
134 métadonnées. Si le fichier possède plusieurs extensions associées
135 au même type de métadonnée, c'est celle de ces extensions la plus à
136 droite qui sera utilisée, excepté pour ce qui concerne les langues
137 et les codages de contenu. Par exemple, si <code>.gif</code> est
138 associé au <a class="glossarylink" href="../glossary.html#type de médium" title="voir glossaire">type de médium</a>
139 <code>image/gif</code>, et <code>.html</code> au type de médium
140 <code>text/html</code>, le fichier <code>welcome.gif.html</code>
141 sera associé au type de médium <code>text/html</code>.</p>
143 <p>Les <a href="#charset-lang">Languages</a> et les <a href="#contentencoding">codages de contenu</a> sont traités de
144 manière cumulative, car il est possible d'assigner plusieurs
145 langues ou codages à une ressource particulière. Par exemple, le
146 fichier <code>welcome.html.en.de</code> sera servi avec les en-têtes
147 <code>Content-Language: en, de</code> et <code>Content-Type:
148 text/html</code>.</p>
150 <p>Des précautions doivent être prises lorsqu'un fichier avec
151 extensions multiples est associé à la fois à un <a class="glossarylink" href="../glossary.html#type de médium" title="voir glossaire">type de
152 médium</a> et à un gestionnaire. En général, cela impliquera
153 la gestion de la requête par le module associé au gestionnaire. Par
154 exemple, si l'extension <code>.imap</code> est associée au
155 gestionnaire <code>imap-file</code> (du module
156 <code class="module"><a href="../mod/mod_imagemap.html">mod_imagemap</a></code>), et si l'extension <code>.html</code>
157 est associée au type de médium <code>text/html</code>, le fichier
158 <code>world.imap.html</code> sera à la fois associé au gestionnaire
159 <code>imap-file</code> et au type de médium <code>text/html</code>.
160 Pour son traitement, c'est le gestionnaire <code>imap-file</code>
161 qui sera utilisé, et il sera donc traité en tant que fichier
164 <p>Si vous préférez que seule la dernière partie d'un nom de fichier
165 séparée du reste du nom par un point soit associée à une métadonnée
166 particulière, n'utilisez pas les directives <code>Add*</code>. Par
167 exemple, si vous souhaitez que le fichier <code>foo.html.cgi</code>
168 soit traité en tant que script CGI, mais pas le fichier
169 <code>bar.cgi.html</code>, alors, au lieu d'utiliser
170 <code>AddHandler cgi-script .cgi</code>, utilisez plutôt :</p>
172 <div class="example"><h3>Configuration du gestionnaire en se basant seulement
173 sur la dernière extension</h3><pre class="prettyprint lang-config"><FilesMatch "[^.]+\.cgi$">
174 SetHandler cgi-script
175 </FilesMatch></pre>
178 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
179 <div class="section">
180 <h2><a name="contentencoding" id="contentencoding">Codage du contenu</a></h2>
181 <p>Un fichier d'un <a class="glossarylink" href="../glossary.html#type de médium" title="voir glossaire">type de médium</a> particulier
182 peut être également codé d'une certaine manière pour simplifier sa
183 transmission sur Internet. Alors que cela concerne en général la
184 compression, comme <code>gzip</code>, il peut aussi s'agir de
185 chiffrement, comme <code>pgp</code> ou d'un codage comme UUencoding,
186 qui est conçu pour transmettre un fichier binaire sous un format
189 <p>La <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC
190 HTTP/1.1</a>, section 14.11 stipule à ce titre :</p>
192 <blockquote cite="http://www.ietf.org/rfc/rfc2616.txt">
193 <p>Le champ d'en-tête Content-Encoding de l'entité est utilisé en
194 tant que modificateur du type de médium. Lorsqu'il est présent, sa
195 valeur indique quels codages de contenu additionnels ont été
196 appliqués au corps de l'entité, et ainsi quels mécanismes de
197 décodage doivent être appliqués afin de retrouver le type de
198 médium référencé par le champ d'en-tête Content-Type. Le codage de
199 contenu est principalement utilisé pour permettre la compression
200 d'un document sans perdre l'information concernant le type de
201 médium sous-jacent.</p>
204 <p>En utilisant plusieurs extensions (voir la <a href="#multipleext">section ci-dessus à propos des extensions de
205 fichiers multiples</a>), vous pouvez indiquer qu'un fichier est d'un
206 <em>type</em>, particulier, et possède aussi un <em>codage</em>
209 <p>Considérons par exemple un fichier contenant un document
210 Microsoft Word et compressé par pkzip pour réduire sa taille. Si
211 l'extension <code>.doc</code> est associée au type de fichier
212 Microsoft Word, et si l'extension <code>.zip</code> est associée au
213 codage de fichier pkzip, alors le fichier
214 <code>Resume.doc.zip</code> sera identifié comme document Word
215 compressé par pkzip.</p>
217 <p>Apache joint un en-tête <code>Content-encoding</code> à la
218 ressource afin d'informer le navigateur client à propos de la
219 méthode de codage.</p>
221 <pre class="prettyprint lang-config">Content-encoding: pkzip</pre>
223 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
224 <div class="section">
225 <h2><a name="charset-lang" id="charset-lang">Jeux de caractères et langues</a></h2>
226 <p>En plus du type de fichier et du codage, un autre élément
227 important d'information est la langue dans laquelle le document est
228 écrit, et avec quel jeu de caractères le contenu du fichier doit
229 être affiché. Par exemple, un document peut être écrit en alphabet
230 vietnamien ou cyrillique, et doit être affiché en conséquence. Cette
231 information est également transmise via des en-têtes HTTP.</p>
233 <p>Les jeu de caractères, langue, codage et type MIME sont tous
234 utilisés au cours du processus de négociation de contenu (voir
235 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>) afin de déterminer quel document
236 servir au client, lorsque plusieurs choix sont possibles en fonction
237 du jeu de caractères, de la langue, du codage ou du type MIME. Toutes
238 les associations d'extensions de noms de fichiers créées via les
239 directives <code class="directive"><a href="#addcharset">AddCharset</a></code>,
240 <code class="directive"><a href="#addencoding">AddEncoding</a></code>, <code class="directive"><a href="#addlanguage">AddLanguage</a></code> et <code class="directive"><a href="#addtype">AddType</a></code> (ainsi que les associations
241 d'extensions listées dans le fichier défini par la directive
242 <code class="directive"><a href="../mod/mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></code>),
243 participent à ce processus de sélection. Les extensions de noms de
244 fichiers qui n'ont été associés que par des directives <code class="directive"><a href="#addhandler">AddHandler</a></code>, <code class="directive"><a href="#addinputfilter">AddInputFilter</a></code> ou <code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code>, peuvent être incluses
245 ou exclues du processus de sélection en utilisant la directive
246 <code class="directive"><a href="#multiviewsmatch">MultiviewsMatch</a></code>.</p>
248 <h3><a name="charset" id="charset">Jeu de caractères</a></h3>
249 <p>Pour transmettre cette information supplémentaire, Apache peut
250 ajouter un en-tête <code>Content-Language</code>, afin de
251 spécifier la langue dans laquelle le document est écrit, et peut
252 ajouter des informations additionnelles à l'en-tête
253 <code>Content-Type</code> pour indiquer le jeu de caractères
254 particulier qui doit être utilisé pour restituer correctement le
257 <div class="example"><p><code>
258 Content-Language: en, fr
259 Content-Type: text/plain; charset=ISO-8859-1
262 <p>La langue est spécifiée via son abréviation en deux lettres. Le
263 <code>jeu de caractères</code> est le nom du jeu de caractères
264 particulier qui doit être utilisé.</p>
267 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
268 <div class="directive-section"><h2><a name="addcharset" id="addcharset">Directive</a> <a name="AddCharset" id="AddCharset">AddCharset</a></h2>
269 <table class="directive">
270 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe les extensions de noms de fichiers spécifiées au
271 jeu de caractères spécifié</td></tr>
272 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddCharset <var>jeu-car</var> <var>extension</var>
273 [<var>extension</var>] ...</code></td></tr>
274 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
275 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
276 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
277 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
279 <p>La directive <code class="directive">AddCharset</code> permet d'associer
280 les extensions de noms de fichiers spécifiées au jeu de caractères
281 spécifié (le nom enregistré sur l'Internet d'un codage de caractères
282 donné). <var>jeu-car</var> est le <a href="http://www.iana.org/assignments/character-sets">paramètre jeu
283 de caractères du type de médium</a> pour les ressources dont le nom
284 de fichier contient <var>extension</var>. Cette association est
285 ajoutée à toutes les autres déjà en vigueur, et écrase toute
286 association préexistante pour la même <var>extension</var>.</p>
288 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">AddLanguage ja .ja
289 AddCharset EUC-JP .euc
290 AddCharset ISO-2022-JP .jis
291 AddCharset SHIFT_JIS .sjis</pre>
294 <p>Avec cet exemple, le document <code>xxxx.ja.jis</code> sera
295 traité en tant que document japonais dont le jeu de caractère est
296 <code>ISO-2022-JP</code> (idem pour le document
297 <code>xxxx.jis.ja</code>). La directive
298 <code class="directive">AddCharset</code> sert à la fois à informer le
299 client sur le codage des caractères du document afin que ce dernier
300 puisse être interprété et affiché correctement, et à la <a href="../content-negotiation.html">négociation de contenu</a>, au
301 cours de laquelle le serveur décide lequel parmi plusieurs
302 documents possibles il renvoie au client en fonction des préférences
303 de ce dernier en matière de jeu de caractères.</p>
305 <p>L'argument <var>extension</var> est insensible à la casse et peut
306 être spécifié avec ou sans le point initial. Les noms de fichiers
307 peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
308 l'argument <var>extension</var> sera comparé à chacune d'entre
314 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
315 <li><code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code></li>
318 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
319 <div class="directive-section"><h2><a name="addencoding" id="addencoding">Directive</a> <a name="AddEncoding" id="AddEncoding">AddEncoding</a></h2>
320 <table class="directive">
321 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe les extensions de noms de fichiers données au type
322 de codage spécifié</td></tr>
323 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddEncoding <var>codage</var> <var>extension</var>
324 [<var>extension</var>] ...</code></td></tr>
325 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
326 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
327 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
328 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
330 <p>La directive <code class="directive">AddEncoding</code> permet d'associer
331 les extensions de noms de fichiers données au codage de contenu HTTP
332 spécifié. <var>codage</var> est le codage de contenu HTTP à ajouter
333 à la valeur du champ d'en-tête Content-Encoding pour les documents
334 possédant l'<var>extension</var> spécifiée. Cette association est
335 ajoutée à toutes les autres déjà en vigueur, et écrase toute
336 association préexistante pour la même <var>extension</var>.</p>
338 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">AddEncoding x-gzip .gz
339 AddEncoding x-compress .Z</pre>
342 <p>Avec cet exemple, les noms de fichiers possédant l'extension
343 <code>.gz</code> seront marqués comme codés à l'aide du codage
344 <code>x-gzip</code>, et les noms de fichiers possédant l'extension
345 <code>.Z</code> comme codés avec <code>x-compress</code>.</p>
347 <p>Les clients anciens n'acceptent que <code>x-gzip</code> et
348 <code>x-compress</code>, bien que les standards stipulent qu'ils
349 sont respectivement équivalents à <code>gzip</code> et
350 <code>compress</code>. Apache effectue ses comparaisons de codages
351 de contenu en ignorant tout préfixe <code>x-</code>. Lorsqu'il
352 répond avec un codage, Apache utilise l'une ou l'autre forme (c'est
353 à dire <code>x-foo</code> ou <code>foo</code>) selon les besoins du
354 client. Si le client n'a pas besoin d'une forme particulière, Apache
355 utilisera la forme employée par la directive
356 <code>AddEncoding</code>. Pour résumer, vous devez toujours utiliser
357 <code>x-gzip</code> et <code>x-compress</code> pour ces deux
358 codages spécifiques. Certains codages plus récents, comme
359 <code>deflate</code>, doivent être spécifiés sans le préfixe
362 <p>L'argument <var>extension</var> est insensible à la casse et peut
363 être spécifié avec ou sans le point initial. Les noms de fichiers
364 peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
365 l'argument <var>extension</var> sera comparé à chacune d'entre
369 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
370 <div class="directive-section"><h2><a name="addhandler" id="addhandler">Directive</a> <a name="AddHandler" id="AddHandler">AddHandler</a></h2>
371 <table class="directive">
372 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe les extensions de noms de fichiers données au
373 gestionnaire spécifié</td></tr>
374 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddHandler <var>nom-gestionnaire</var> <var>extension</var>
375 [<var>extension</var>] ...</code></td></tr>
376 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
377 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
378 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
379 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
381 <p>Les fichiers dont le nom a pour extension <var>extension</var>
382 seront servis par le <var><a href="../handler.html">nom-gestionnaire</a></var> spécifié. Cette
383 association est ajoutée à toutes les autres déjà en vigueur, et
384 écrase toute association préexistante pour la même
385 <var>extension</var>. Par exemple, pour associer les scripts CGI
386 avec l'extension de fichier <code>.cgi</code>, vous pouvez utiliser
389 <pre class="prettyprint lang-config">AddHandler cgi-script .cgi</pre>
392 <p>Une fois cette ligne insérée dans votre fichier httpd.conf, tout
393 fichier possédant l'extension <code>.cgi</code> sera traité en tant
394 que programme CGI.</p>
396 <p>L'argument <var>extension</var> est insensible à la casse et peut
397 être spécifié avec ou sans le point initial. Les noms de fichiers
398 peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
399 l'argument <var>extension</var> sera comparé à chacune d'entre
404 <li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li>
407 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
408 <div class="directive-section"><h2><a name="addinputfilter" id="addinputfilter">Directive</a> <a name="AddInputFilter" id="AddInputFilter">AddInputFilter</a></h2>
409 <table class="directive">
410 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe les extensions de noms de fichiers aux
411 filtres spécifiés qui traiteront les requêtes clients</td></tr>
412 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddInputFilter <var>filtre</var>[;<var>filtre</var>...]
413 <var>extension</var> [<var>extension</var>] ...</code></td></tr>
414 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
415 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
416 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
417 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
419 <p>La directive <code class="directive">AddInputFilter</code> permet
420 d'associer l'extension de nom de fichier <var>extension</var> aux <a href="../filter.html">filtres</a> spécifiés qui traiteront les
421 requêtes clients et les entrées POST à leur réception par le
422 serveur. Ceci s'ajoute à toute définition de filtre préexistante, y
423 compris la directive <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code>. Cette
424 association est ajoutée à toutes les autres déjà en vigueur, et
425 écrase toute association préexistante pour la même
426 <var>extension</var>.</p>
428 <p>Si plusieurs <var>filtres</var> sont spécifiés, ils doivent être
429 séparés par des points-virgules et inscrits dans l'ordre selon
430 lequel ils devront traiter le contenu. L'argument <var>filtre</var>
431 est insensible à la casse.</p>
433 <p>L'argument <var>extension</var> est insensible à la casse et peut
434 être spécifié avec ou sans le point initial. Les noms de fichiers
435 peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
436 l'argument <var>extension</var> sera comparé à chacune d'entre
442 <li><code class="directive"><a href="#removeinputfilter">RemoveInputFilter</a></code></li>
443 <li><code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code></li>
446 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
447 <div class="directive-section"><h2><a name="addlanguage" id="addlanguage">Directive</a> <a name="AddLanguage" id="AddLanguage">AddLanguage</a></h2>
448 <table class="directive">
449 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe l'extension de nom de fichier donnée à la langue
451 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddLanguage <var>symbole-langue</var> <var>extension</var>
452 [<var>extension</var>] ...</code></td></tr>
453 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
454 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
455 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
456 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
458 <p>La directive <code class="directive">AddLanguage</code> permet d'associer
459 l'extension de nom de fichier donnée à la langue spécifiée. Les
460 fichiers dont l'extension correspond à la valeur
461 de l'argument <var>extension</var> se voient attribuer la valeur de
462 l'argument <var>symbole-langue</var> comme en-tête HTTP
463 Content-Language en accord avec les identifiants de langues définis
464 par la RFC 3066. Cette directive l'emporte sur toute association
465 préexistante pour la même <var>extension</var>.</p>
467 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">AddEncoding x-compress .Z
469 AddLanguage fr .fr</pre>
472 <p>Avec cet exemple, le document <code>xxxx.en.Z</code> sera traité
473 en tant que document compressé de langue anglaise (idem pour le
474 document <code>xxxx.Z.en</code>). Bien que la langue soit fournie au
475 client, le navigateur n'utilise habituellement pas cette
476 information. La directive <code class="directive">AddLanguage</code> est
477 principalement utilisée au cours de la <a href="../content-negotiation.html">négociation de contenu</a>, où le
478 serveur choisit d'envoyer un document parmi plusieurs documents
479 possibles en fonction de la préférence du client en matière de
482 <p>Si une extension fait l'objet de plusieurs associations de
483 langues, c'est la dernière qui sera utilisée. Ainsi, dans le cas
486 <pre class="prettyprint lang-config">AddLanguage en .en
487 AddLanguage en-gb .en
488 AddLanguage en-us .en</pre>
491 <p>les documents possédant l'extension <code>.en</code> seront
492 traités en tant que documents de langue <code>en-us</code>.</p>
494 <p>L'argument <var>extension</var> est insensible à la casse et peut
495 être spécifié avec ou sans le point initial. Les noms de fichiers
496 peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
497 l'argument <var>extension</var> sera comparé à chacune d'entre
502 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
505 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
506 <div class="directive-section"><h2><a name="addoutputfilter" id="addoutputfilter">Directive</a> <a name="AddOutputFilter" id="AddOutputFilter">AddOutputFilter</a></h2>
507 <table class="directive">
508 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe les extensions de noms de fichiers aux
509 filtres spécifiés qui traiteront les réponses en provenance du
511 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddOutputFilter <var>filtre</var>[;<var>filtre</var>...]
512 <var>extension</var> [<var>extension</var>] ...</code></td></tr>
513 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
514 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
515 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
516 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
518 <p>La directive <code class="directive">AddOutputFilter</code> permet
519 d'associer l'extension de nom de fichier définie par l'argument
520 <var>extension</var> aux <a href="../filter.html">filtres</a> qui traiteront les réponses en
521 provenance du serveur avant de les envoyer au client. Ces filtres
522 s'ajoutent à tout filtre défini par d'autres directives comme
523 <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code> et <code class="directive"><a href="../mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code>. Cette association
524 est fusionnée avec toute autre association en vigueur, et l'emporte
525 sur toute association préexistante pour la même
526 <var>extension</var>.</p>
528 <p>Avec l'exemple suivant, tous les fichiers <code>.shtml</code>
529 seront traités en tant qu'inclusions côté serveur (SSI), et la
530 sortie sera compressée à l'aide du module
531 <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>.</p>
533 <pre class="prettyprint lang-config">AddOutputFilter INCLUDES;DEFLATE shtml</pre>
536 <p>Si plusieurs <var>filtres</var> sont spécifiés, ils doivent être
537 séparés par des points-virgules et inscrits dans l'ordre selon
538 lequel il devront traiter le contenu. L'argument <var>filtre</var>
539 est insensible à la casse.</p>
541 <p>L'argument <var>extension</var> est insensible à la casse et peut
542 être spécifié avec ou sans le point initial. Les noms de fichiers
543 peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
544 l'argument <var>extension</var> sera comparé à chacune d'entre
547 <p>Notez que toute définition de filtres via la directive <code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code> remplace toutes les
548 définitions précédentes effectuées via cette même directive.</p>
550 <pre class="prettyprint lang-config"># Filtre spécifié "DEFLATE"
551 AddOutputFilter DEFLATE shtml
552 <Location "/foo">
553 # Filtre spécifié "INCLUDES", remplace "DEFLATE"
554 AddOutputFilter INCLUDES shtml
556 <Location "/bar">
557 # Filtre spécifié "INCLUDES;DEFLATE", remplace "DEFLATE"
558 AddOutputFilter INCLUDES;DEFLATE shtml
560 <Location "/bar/baz">
561 # Filtre spécifié "BUFFER", remplace "INCLUDES;DEFLATE"
562 AddOutputFilter BUFFER shtml
564 <Location "/bar/baz/buz">
565 # Pas de filtre spécifié, suppression de "BUFFER"
566 RemoveOutputFilter shtml
567 </Location></pre>
572 <li><code class="directive"><a href="#removeoutputfilter">RemoveOutputFilter</a></code></li>
573 <li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li>
576 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
577 <div class="directive-section"><h2><a name="addtype" id="addtype">Directive</a> <a name="AddType" id="AddType">AddType</a></h2>
578 <table class="directive">
579 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Associe les extensions de noms de fichiers au type de
580 contenu spécifié</td></tr>
581 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddType <var>type-médium</var> <var>extension</var>
582 [<var>extension</var>] ...</code></td></tr>
583 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
584 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
585 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
586 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
588 <p>La directive <code class="directive">AddType</code> permet d'associer les
589 extensions de noms de fichiers données au type de contenu spécifié.
590 <var>type-médium</var> est le <a class="glossarylink" href="../glossary.html#media-type" title="voir glossaire">Type
591 MIME</a> à utiliser pour les fichiers dont le nom possède
592 l'extension <var>extension</var>. Cette association s'ajoute à toute
593 autre association en vigueur, et l'emporte sur toute association
594 préexistante pour la même <var>extension</var>.</p>
597 Plutôt que d'éditer directement le fichier <code class="directive"><a href="#typesconfig">TypesConfig</a></code>, il est recommandé
598 d'utiliser la directive <code class="directive">AddType</code> pour
599 ajouter de nouveaux types de médias.
602 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">AddType image/gif .gif</pre>
605 <p>Ou, pour spécifier plusieurs extensions dans une seule directive
608 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">AddType image/jpeg jpeg jpg jpe</pre>
611 <p>L'argument <var>extension</var> est insensible à la casse et peut
612 être spécifié avec ou sans le point initial. Les noms de fichiers
613 peuvent posséder <a href="#multipleext">plusieurs extensions</a>, et
614 l'argument <var>extension</var> sera comparé à chacune d'entre
617 <p>Il est possible d'obtenir un effet similaire à celui de la
618 directive <code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code> du module
619 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> en qualifiant un <var>type de
620 média</var> avec <code>qs</code> :</p>
622 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">AddType application/rss+xml;qs=0.8 .xml</pre>
625 <p>Ceci peut s'avérer utile dans certaines situations, par exemple
626 lorsqu'un client qui a ajouté un en-tête <code>Accept: */*</code> à
627 sa requête n'est pas en mesure de traiter le contenu renvoyé par le
630 <p>À la base, cette directive configure le type de contenu généré
631 pour les fichiers statiques servis à partir du système de fichiers.
632 Dans le cas des ressources autres que les fichiers statiques pour
633 lesquelles le générateur de la réponse spécifie en général un
634 Content-Type, cette directive n'a aucun effet.</p>
636 <div class="note"><h3>Note</h3>
637 <p>Si aucun gestionnaire n'est explicitement défini pour une
638 requête, le type de contenu spécifié sera aussi utilisé comme nom du
641 <p>Lorsqu'aucune directive comme <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code> ou
642 <code class="directive">module="mod_mime">AddHandler</code> ne s'applique à
643 une requête, le nom de gestionnaire interne normalement défini
644 par une de ces directives est en fait défini par le type de contenu
645 spécifié par la présente directive.</p>
647 Pour des raisons historiques, certains modules tiers comme mod_php
648 peuvent adopter ce type de comportement pour prendre en compte la
651 <p>Il est conseillé d'éviter les configurations qui reposent sur de
652 tels types "synthétiques". En outre, les configurations qui
653 limitent l'accès aux directives <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code> ou <code class="directive"><a href="#addhandler">AddHandler</a></code> doivent aussi limiter
654 l'accès à la directive AddType.</p>
660 <li><code class="directive"><a href="../mod/core.html#forcetype">ForceType</a></code></li>
661 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
664 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
665 <div class="directive-section"><h2><a name="defaultlanguage" id="defaultlanguage">Directive</a> <a name="DefaultLanguage" id="DefaultLanguage">DefaultLanguage</a></h2>
666 <table class="directive">
667 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit un symbole de langue par défaut à affecter au champ
668 d'en-tête Content-Language pour toutes les ressources dans le contexte
669 courant auxquelles aucun symbole de langue n'a été
671 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultLanguage <var>symbole-langue</var></code></td></tr>
672 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
673 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
674 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
675 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
677 <p>La directive <code class="directive">DefaultLanguage</code> permet
678 d'indiquer à Apache que toutes les ressources du contexte courant
679 (par exemple, toutes les ressources concernées par le conteneur
680 <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
681 courant) qui ne possèdent pas d'extension de langue explicite
682 (comme <code>.fr</code> ou <code>.de</code> tel que défini par la
683 directive <code class="directive"><a href="#addlanguage">AddLanguage</a></code>),
684 verront leur en-tête HTTP Content-Language affecté de la langue
685 <var>symbole-langue</var>. Ceci permet de marquer des arborescences
686 de répertoires entières comme contenant des documents en français,
687 par exemple, sans avoir à renommer chaque fichier. Notez qu'à la
688 différence de l'utilisation des extensions pour spécifier des
689 langues, <code class="directive">DefaultLanguage</code> ne permet de
690 spécifier qu'une seule langue.</p>
692 <p>Si aucune directive <code class="directive">DefaultLanguage</code> n'est
693 en vigueur, et si un fichier ne possède pas d'extension configurée
694 par la directive <code class="directive"><a href="#addlanguage">AddLanguage</a></code>, aucun champ d'en-tête
695 Content-Language ne sera généré.</p>
697 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">DefaultLanguage en</pre>
702 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
705 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
706 <div class="directive-section"><h2><a name="modmimeusepathinfo" id="modmimeusepathinfo">Directive</a> <a name="ModMimeUsePathInfo" id="ModMimeUsePathInfo">ModMimeUsePathInfo</a></h2>
707 <table class="directive">
708 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Indique à <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> de traiter les éléments
709 de <code>path_info</code> en tant que parties du nom de
711 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ModMimeUsePathInfo On|Off</code></td></tr>
712 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ModMimeUsePathInfo Off</code></td></tr>
713 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
714 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
715 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
717 <p>La directive <code class="directive">ModMimeUsePathInfo</code> permet de
718 combiner le nom de fichier avec la partie <code>path_info</code> de
719 l'URL pour appliquer les directives <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> à la
720 requête. La valeur par défaut est <code>Off</code> - situation dans
721 laquelle l'élément <code>path_info</code> est ignoré.</p>
723 <p>L'utilisation de cette directive est conseillée si vous utilisez
724 un système de fichiers virtuel.</p>
726 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ModMimeUsePathInfo On</pre>
729 <p>Considérons une requête pour <code>/index.php/foo.shtml</code>,
730 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> ne traitera pas la requête entrante comme
731 <code>/index.php/foo.shtml</code> et les directives comme
732 <code>AddOutputFilter INCLUDES .shtml</code> ajouteront le filtre
733 <code>INCLUDES</code> à la requête. Si la directive
734 <code class="directive">ModMimeUsePathInfo</code> n'est pas définie, le
735 filtre <code>INCLUDES</code> ne sera pas ajouté. Le fonctionnement
736 sera identique dans le cas des chemins virtuels, tels que ceux
737 définis par la directive <code class="directive"><Location></code></p>
741 <li><code class="directive"><a href="../mod/core.html#acceptpathinfo">AcceptPathInfo</a></code></li>
744 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
745 <div class="directive-section"><h2><a name="multiviewsmatch" id="multiviewsmatch">Directive</a> <a name="MultiviewsMatch" id="MultiviewsMatch">MultiviewsMatch</a></h2>
746 <table class="directive">
747 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les types de fichiers qui seront inclus lors d'une
748 recherche de correspondance de fichier avec les vues multiples
749 (MultiViews)</td></tr>
750 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers
751 [Handlers|Filters]</code></td></tr>
752 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MultiviewsMatch NegotiatedOnly</code></td></tr>
753 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
754 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
755 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
756 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
758 <p>La directive <code class="directive">MultiviewsMatch</code> permet trois
759 comportements différents pour la fonctionnalité Multiviews du module
760 <a href="mod_negotiation.html">mod_negotiation</a>. Les vues
761 multiples permettent d'associer une requête pour un fichier, par
762 exemple <code>index.html</code>, à toute extension négociée
763 s'ajoutant à la requête de base, par exemple
764 <code>index.html.en</code>, <code>index.html.fr</code>, ou
765 <code>index.html.gz</code>.</p>
767 <p>L'option <code>NegotiatedOnly</code> implique que toute extension
768 s'ajoutant au nom de base doit correspondre à une extension de
769 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> reconnue pour la négociation de contenu,
770 par exemple Charset, Content-Type, Language, ou Encoding. C'est la
771 valeur d'option par défaut, et la contrainte la plus stricte
772 dont les effets de bord inattendus sont les moins nombreux.</p>
774 <p>Pour inclure des extensions associées avec des gestionnaires
775 et/ou des filtres, définissez la directive
776 <code class="directive">MultiviewsMatch</code> avec les mots-clés
777 <code>Handlers</code>, <code>Filters</code>, ou les deux. Si tous
778 les autres facteurs sont égaux, c'est le fichier de plus petite
779 taille qui sera servi ; par exemple, si le choix doit s'opérer entre
780 <code>index.html.cgi</code> de 500 octets et
781 <code>index.html.pl</code> de 1000 octets, c'est le fichier
782 <code>.cgi</code> qui l'emportera dans cet exemple. Les utilisateurs
783 de fichiers <code>.asis</code> auront avantage à utiliser l'option
784 Handler, si les fichiers <code>.asis</code> sont associés au
785 gestionnaire <code>asis-handler</code>.</p>
787 <p>Vous pouvez enfin autoriser l'association de toute extension avec
788 l'option <code>Any</code>, même si <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> ne
789 reconnaît pas l'extension. Ceci
790 peut conduire à des résultats imprévisibles, comme l'envoi de
791 fichiers .old ou .bak contrairement aux souhaits du webmaster.</p>
793 <p>Par exemple, la configuration suivante va permettre l'inclusion
794 des extensions associées aux gestionnaires et aux filtres dans les
795 vues multiples, tout en excluant les fichiers de type inconnu :</p>
797 <pre class="prettyprint lang-config">MultiviewsMatch Handlers Filters</pre>
800 <p>L'utilisation de la directive
801 <code class="directive">MultiviewsMatch</code> dans une section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> ou <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code> n'est pas
807 <li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li>
808 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
811 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
812 <div class="directive-section"><h2><a name="removecharset" id="removecharset">Directive</a> <a name="RemoveCharset" id="RemoveCharset">RemoveCharset</a></h2>
813 <table class="directive">
814 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de jeu de caractères pour un
815 ensemble d'extensions de noms de fichiers</td></tr>
816 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveCharset <var>extension</var> [<var>extension</var>]
818 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
819 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
820 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
821 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
823 <p>La directive <code class="directive">RemoveCharset</code> permet de
824 supprimer toute association de jeu de caractères pour les fichiers
825 dont les noms possèdent les extensions spécifiées. Ceci permet, au
826 sein des fichiers <code>.htaccess</code>, d'annuler toute
827 association héritée du répertoire parent ou de la configuration du
828 serveur pour un répertoire particulier.</p>
830 <p>L'argument <var>extension</var> est insensible à la casse et peut
831 être spécifié avec ou sans le point initial.</p>
833 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">RemoveCharset .html .shtml</pre>
837 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
838 <div class="directive-section"><h2><a name="removeencoding" id="removeencoding">Directive</a> <a name="RemoveEncoding" id="RemoveEncoding">RemoveEncoding</a></h2>
839 <table class="directive">
840 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de codage de contenu pour un
841 ensemble d'extensions de noms de fichiers</td></tr>
842 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveEncoding <var>extension</var> [<var>extension</var>]
844 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
845 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
846 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
847 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
849 <p>La directive <code class="directive">RemoveEncoding</code> permet de
850 supprimer toute association de codage pour les fichiers dont les
851 noms possèdent les extensions spécifiées. Ceci permet, au
852 sein des fichiers <code>.htaccess</code>, d'annuler toute
853 association héritée du répertoire parent ou de la configuration du
854 serveur pour un répertoire particulier. Voici un exemple
855 d'utilisation de cette directive :</p>
857 <div class="example"><h3>/foo/.htaccess:</h3><pre class="prettyprint lang-config">AddEncoding x-gzip .gz
858 AddType text/plain .asc
859 <Files "*.gz.asc">
864 <p>Avec cette configuration, le fichier <code>foo.gz</code> sera
865 marqué comme codé avec gzip, mais <code>foo.gz.asc</code> sera
866 marqué comme fichier texte non codé.</p>
868 <div class="note"><h3>Note</h3>
869 <p>Les directives <code class="directive">RemoveEncoding</code> étant
870 traitées <em>après</em> toute directive <code class="directive"><a href="#addencoding">AddEncoding</a></code>, il est possible
871 qu'elles annulent les effets de ces dernières si les deux
872 apparaissent dans la configuration du même répertoire.</p>
875 <p>L'argument <var>extension</var> est insensible à la casse et peut
876 être spécifié avec ou sans le point initial.</p>
879 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
880 <div class="directive-section"><h2><a name="removehandler" id="removehandler">Directive</a> <a name="RemoveHandler" id="RemoveHandler">RemoveHandler</a></h2>
881 <table class="directive">
882 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de gestionnaire à un ensemble
883 d'extensions de noms de fichiers</td></tr>
884 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveHandler <var>extension</var> [<var>extension</var>]
886 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
887 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
888 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
889 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
891 <p>La directive <code class="directive">RemoveHandler</code> permet de
892 supprimer toute association de gestionnaire à des fichiers dont le
893 nom possède l'extension donnée. Ceci permet, au
894 sein des fichiers <code>.htaccess</code>, d'annuler toute
895 association héritée du répertoire parent ou de la configuration du
896 serveur pour un répertoire particulier. Voici un exemple
897 d'utilisation de cette directive :</p>
899 <div class="example"><h3>/foo/.htaccess:</h3><pre class="prettyprint lang-config">AddHandler server-parsed .html</pre>
902 <div class="example"><h3>/foo/bar/.htaccess:</h3><pre class="prettyprint lang-config">RemoveHandler .html</pre>
905 <p>Avec cette dernière ligne, les fichiers <code>.html</code> du
906 répertoire <code>/foo/bar</code> seront traités en tant que fichiers
907 normaux, au lieu d'être traités en tant que candidats à
908 l'interprétation (voir le module <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>
911 <p>L'argument <var>extension</var> est insensible à la casse et peut
912 être spécifié avec ou sans le point initial.</p>
915 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
916 <div class="directive-section"><h2><a name="removeinputfilter" id="removeinputfilter">Directive</a> <a name="RemoveInputFilter" id="RemoveInputFilter">RemoveInputFilter</a></h2>
917 <table class="directive">
918 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de filtre en entrée à un
919 ensemble d'extensions de noms de fichiers</td></tr>
920 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveInputFilter <var>extension</var> [<var>extension</var>]
922 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
923 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
924 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
925 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
927 <p>La directive <code class="directive">RemoveInputFilter</code> permet de
928 supprimer toute association de <a href="../filter.html">filtre</a>
929 en entrée à des fichiers dont le nom possède l'extension donnée.
931 sein des fichiers <code>.htaccess</code>, d'annuler toute
932 association héritée du répertoire parent ou de la configuration du
933 serveur pour un répertoire particulier.</p>
935 <p>L'argument <var>extension</var> est insensible à la casse et peut
936 être spécifié avec ou sans le point initial.</p>
940 <li><code class="directive"><a href="#addinputfilter">AddInputFilter</a></code></li>
941 <li><code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code></li>
944 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
945 <div class="directive-section"><h2><a name="removelanguage" id="removelanguage">Directive</a> <a name="RemoveLanguage" id="RemoveLanguage">RemoveLanguage</a></h2>
946 <table class="directive">
947 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de langue à un ensemble
948 d'extensions de noms de fichiers</td></tr>
949 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveLanguage <var>extension</var> [<var>extension</var>]
951 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
952 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
953 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
954 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
956 <p>La directive <code class="directive">RemoveLanguage</code> permet de
957 supprimer toute association de langue à des fichiers dont le nom
958 possède l'extension donnée. Ceci permet, au
959 sein des fichiers <code>.htaccess</code>, d'annuler toute
960 association héritée du répertoire parent ou de la configuration du
961 serveur pour un répertoire particulier.</p>
963 <p>L'argument <var>extension</var> est insensible à la casse et peut
964 être spécifié avec ou sans le point initial.</p>
967 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
968 <div class="directive-section"><h2><a name="removeoutputfilter" id="removeoutputfilter">Directive</a> <a name="RemoveOutputFilter" id="RemoveOutputFilter">RemoveOutputFilter</a></h2>
969 <table class="directive">
970 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de filtre en sortie à un
971 ensemble d'extensions de noms de fichiers</td></tr>
972 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveOutputFilter <var>extension</var> [<var>extension</var>]
974 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
975 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
976 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
977 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
979 <p>La directive <code class="directive">RemoveOutputFilter</code> permet de
980 supprimer toute association de <a href="../filter.html">filtre</a>
981 en sortie à des fichiers dont le nom possède l'extension donnée. Ceci permet, au
982 sein des fichiers <code>.htaccess</code>, d'annuler toute
983 association héritée du répertoire parent ou de la configuration du
984 serveur pour un répertoire particulier.</p>
986 <p>L'argument <var>extension</var> est insensible à la casse et peut
987 être spécifié avec ou sans le point initial.</p>
989 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">RemoveOutputFilter shtml</pre>
994 <li><code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code></li>
997 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
998 <div class="directive-section"><h2><a name="removetype" id="removetype">Directive</a> <a name="RemoveType" id="RemoveType">RemoveType</a></h2>
999 <table class="directive">
1000 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime toute association de type de contenu à un ensemble
1001 d'extensions de noms de fichiers</td></tr>
1002 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoveType <var>extension</var> [<var>extension</var>]
1003 ...</code></td></tr>
1004 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel, répertoire, .htaccess</td></tr>
1005 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
1006 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
1007 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
1009 <p>La directive <code class="directive">RemoveType</code> permet de
1010 supprimer toute association de <a class="glossarylink" href="../glossary.html#media-type" title="voir glossaire">type de
1011 médium</a> à des fichiers dont le nom possède l'extension
1012 donnée. Ceci permet, au
1013 sein des fichiers <code>.htaccess</code>, d'annuler toute
1014 association héritée du répertoire parent ou de la configuration du
1015 serveur pour un répertoire particulier. Voici un exemple
1016 d'utilisation de cette directive :</p>
1018 <div class="example"><h3>/foo/.htaccess:</h3><pre class="prettyprint lang-config">RemoveType .cgi</pre>
1021 <p>Cette ligne aura pour effet de supprimer tout traitement
1022 spécifique des fichiers <code>.cgi</code> dans le répertoire
1023 <code>/foo/</code> et ses sous-répertoires, et les réponses
1024 contenant ce type de fichier ne possèderont pas de champ d'en-tête
1025 HTTP Content-Type.</p>
1027 <div class="note"><h3>Note</h3>
1028 <p>Les directives <code class="directive">RemoveType</code> sont traitées
1029 <em>après</em> toutes les directives <code class="directive"><a href="#addtype">AddType</a></code>, et il est possible que les
1030 effets de ces dernières soient annulés si les deux types de
1031 directives sont présents au sein de la configuration du même
1035 <p>L'argument <var>extension</var> est insensible à la casse et peut
1036 être spécifié avec ou sans le point initial.</p>
1039 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1040 <div class="directive-section"><h2><a name="typesconfig" id="typesconfig">Directive</a> <a name="TypesConfig" id="TypesConfig">TypesConfig</a></h2>
1041 <table class="directive">
1042 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le chemin du fichier <code>mime.types</code></td></tr>
1043 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TypesConfig <var>chemin-fichier</var></code></td></tr>
1044 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>TypesConfig conf/mime.types</code></td></tr>
1045 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
1046 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
1047 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
1049 <p>La directive <code class="directive">TypesConfig</code> permet de définir
1050 le chemin du fichier de configuration des <a class="glossarylink" href="../glossary.html#media-type" title="voir glossaire">types de média</a>. L'argument
1051 <var>chemin-fichier</var> est un chemin relatif au répertoire défini
1052 par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. Ce
1053 fichier contient la liste des associations par défaut des extensions
1054 de noms de fichiers aux types de contenus. La plupart des
1055 administrateurs utilisent le fichier <code>mime.types</code> fourni
1056 par leur système d'exploitation,
1057 qui associe les extensions de noms de fichiers courantes à la liste
1058 officielle des types de média enregistrés par l'IANA et maintenue à
1059 <a href="http://www.iana.org/assignments/media-types/index.html">http://www.iana.org/assignments/media-types/index.html</a>, ainsi
1060 qu'un grand nombre de types non officiels. Ce fichier permet de
1061 simplifier le fichier <code>httpd.conf</code> en fournissant la
1062 majorité des définitions de types de média, et ses définitions
1063 peuvent être écrasées par des directives <code class="directive"><a href="#addtype">AddType</a></code>, selon les besoins. Il est
1064 déconseillé de modifier le contenu du fichier
1065 <code>mime.types</code> car il peut être remplacé lors d'une mise à
1066 jour du serveur.</p>
1068 <p>Le fichier contient des lignes dont le format est identique à
1069 celui des arguments d'une directive <code class="directive"><a href="#addtype">AddType</a></code> :</p>
1071 <div class="example"><p><code>
1072 <var>type-médium</var> [<var>extension</var>] ...
1075 <p>Les extensions sont insensibles à la casse. Les lignes vides et
1076 les lignes commençant par un dièse (<code>#</code>) sont
1077 ignorées. Les lignes vides servent à compléter le fichier
1078 mime.types. Apache httpd peut encore déterminer ces types via le
1079 module <code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code>.</p>
1082 Merci de <strong>ne pas</strong> soumettre de requêtes au Projet
1083 de Serveur HTTP Apache pour ajouter une entrée dans le fichier
1084 <code>mime.types</code> fourni, sauf si :
1085 1) le type de médium est déjà enregistré à l'IANA
1086 2) et si l'extension est largement acceptée et ne provoque pas de
1087 conflits d'extensions entre les différentes plate-formes. Les
1088 requêtes du type <code>catégorie/x-sous-type</code> seront
1089 systématiquement rejetées, ainsi que toute nouvelle extension de
1090 deux lettres, car elle ont de fortes chances d'entrer en conflit
1091 par la suite avec les inombrables langues préexistantes et les
1092 espaces de nommage des jeux de caractères.
1097 <li><code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code></li>
1101 <div class="bottomlang">
1102 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_mime.html" hreflang="en" rel="alternate" title="English"> en </a> |
1103 <a href="../fr/mod/mod_mime.html" title="Français"> fr </a> |
1104 <a href="../ja/mod/mod_mime.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
1105 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />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 <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
1106 <script type="text/javascript"><!--//--><![CDATA[//><!--
1107 var comments_shortname = 'httpd';
1108 var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_mime.html';
1110 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
1111 d.write('<div id="comments_thread"><\/div>');
1112 var s = d.createElement('script');
1113 s.type = 'text/javascript';
1115 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
1116 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
1119 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
1121 })(window, document);
1122 //--><!]]></script></div><div id="footer">
1123 <p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
1124 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
1125 if (typeof(prettyPrint) !== 'undefined') {