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="en" xml:lang="en"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
8 <title>mod_mime - Apache HTTP Server</title>
9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
14 <div id="page-header">
15 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
16 <p class="apache">Apache HTTP Server Version 2.3</p>
17 <img alt="" src="../images/feather.gif" /></div>
18 <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
20 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div>
21 <div id="page-content">
22 <div id="preamble"><h1>Apache Module mod_mime</h1>
24 <p><span>Available Languages: </span><a href="../en/mod/mod_mime.html" title="English"> en </a> |
25 <a href="../ja/mod/mod_mime.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
27 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Associates the requested filename's extensions
28 with the file's behavior (handlers and filters)
29 and content (mime-type, language, character set and
31 <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Base</td></tr>
32 <tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:</a></th><td>mime_module</td></tr>
33 <tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>mod_mime.c</td></tr></table>
36 <p>This module is used to assign content metadata to the content
37 selected for an HTTP response by mapping patterns in the
38 URI or filenames to the metadata values. For example, the filename
39 extensions of content files often define the content's Internet
40 media type, language, character set, and content-encoding. This
41 information is sent in HTTP messages containing that content and
42 used in content negotiation when selecting alternatives, such that
43 the user's preferences are respected when choosing one of several
44 possible contents to serve. See
45 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> for more information
46 about <a href="../content-negotiation.html">content negotiation</a>.</p>
48 <p>The 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> and <code class="directive"><a href="#addtype">AddType</a></code> are all used to map file
49 extensions onto the metadata for that file. Respectively
50 they set the character set, content-encoding, content-language,
51 and <a class="glossarylink" href="../glossary.html#media-type" title="see glossary">media-type</a> (content-type) of documents. The directive <code class="directive"><a href="#typesconfig">TypesConfig</a></code> is used to specify a
52 file which also maps extensions onto media types. </p>
54 <p>In addition, <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> may define the <a href="../handler.html">handler</a> and <a href="../filter.html">filters</a> that originate and process
55 content. The directives <code class="directive"><a href="#addhandler">AddHandler</a></code>, <code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code>, and <code class="directive"><a href="#addinputfilter">AddInputFilter</a></code> control the modules
56 or scripts that serve the document. The <code class="directive"><a href="#multiviewsmatch">MultiviewsMatch</a></code> directive allows
57 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> to consider these file extensions
58 to be included when testing Multiviews matches.</p>
60 <p>While <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> associates metadata
61 with filename extensions, the <code class="module"><a href="../mod/core.html">core</a></code> server
62 provides directives that are used to associate all the files in a
63 given container (<em>e.g.</em>, <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, or <code class="directive"><a href="../mod/core.html#files"><Files></a></code>) with particular
64 metadata. These directives include <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>, and <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code>. The core directives
65 override any filename extension mappings defined in
66 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code>.</p>
68 <p>Note that changing the metadata for a file does not
69 change the value of the <code>Last-Modified</code> header.
70 Thus, previously cached copies may still be used by a client or
71 proxy, with the previous headers. If you change the
72 metadata (language, content type, character set or
73 encoding) you may need to 'touch' affected files (updating
74 their last modified date) to ensure that all visitors are
75 receive the corrected content headers.</p>
77 <div id="quickview"><h3 class="directives">Directives</h3>
79 <li><img alt="" src="../images/down.gif" /> <a href="#addcharset">AddCharset</a></li>
80 <li><img alt="" src="../images/down.gif" /> <a href="#addencoding">AddEncoding</a></li>
81 <li><img alt="" src="../images/down.gif" /> <a href="#addhandler">AddHandler</a></li>
82 <li><img alt="" src="../images/down.gif" /> <a href="#addinputfilter">AddInputFilter</a></li>
83 <li><img alt="" src="../images/down.gif" /> <a href="#addlanguage">AddLanguage</a></li>
84 <li><img alt="" src="../images/down.gif" /> <a href="#addoutputfilter">AddOutputFilter</a></li>
85 <li><img alt="" src="../images/down.gif" /> <a href="#addtype">AddType</a></li>
86 <li><img alt="" src="../images/down.gif" /> <a href="#defaultlanguage">DefaultLanguage</a></li>
87 <li><img alt="" src="../images/down.gif" /> <a href="#modmimeusepathinfo">ModMimeUsePathInfo</a></li>
88 <li><img alt="" src="../images/down.gif" /> <a href="#multiviewsmatch">MultiviewsMatch</a></li>
89 <li><img alt="" src="../images/down.gif" /> <a href="#removecharset">RemoveCharset</a></li>
90 <li><img alt="" src="../images/down.gif" /> <a href="#removeencoding">RemoveEncoding</a></li>
91 <li><img alt="" src="../images/down.gif" /> <a href="#removehandler">RemoveHandler</a></li>
92 <li><img alt="" src="../images/down.gif" /> <a href="#removeinputfilter">RemoveInputFilter</a></li>
93 <li><img alt="" src="../images/down.gif" /> <a href="#removelanguage">RemoveLanguage</a></li>
94 <li><img alt="" src="../images/down.gif" /> <a href="#removeoutputfilter">RemoveOutputFilter</a></li>
95 <li><img alt="" src="../images/down.gif" /> <a href="#removetype">RemoveType</a></li>
96 <li><img alt="" src="../images/down.gif" /> <a href="#typesconfig">TypesConfig</a></li>
100 <li><img alt="" src="../images/down.gif" /> <a href="#multipleext">Files with Multiple Extensions</a></li>
101 <li><img alt="" src="../images/down.gif" /> <a href="#contentencoding">Content encoding</a></li>
102 <li><img alt="" src="../images/down.gif" /> <a href="#charset-lang">Character sets and languages</a></li>
103 </ul><h3>See also</h3>
105 <li><code class="directive"><a href="../mod/mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></code></li>
106 <li><code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code></li>
107 <li><code class="directive"><a href="../mod/core.html#forcetype">ForceType</a></code></li>
108 <li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li>
109 <li><code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code></li>
110 <li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li>
112 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
113 <div class="section">
114 <h2><a name="multipleext" id="multipleext">Files with Multiple Extensions</a></h2>
115 <p>Files can have more than one extension; the order of the
116 extensions is <em>normally</em> irrelevant. For example, if the
117 file <code>welcome.html.fr</code> maps onto content type
118 <code>text/html</code> and language French then the file
119 <code>welcome.fr.html</code> will map onto exactly the same
120 information. If more than one extension is given that maps onto
121 the same type of metadata, then the one to the right will
122 be used, except for languages and content encodings. For example,
123 if <code>.gif</code> maps to the <a class="glossarylink" href="../glossary.html#media-type" title="see glossary">media-type</a>
124 <code>image/gif</code> and <code>.html</code> maps to the
125 media-type <code>text/html</code>, then the file
126 <code>welcome.gif.html</code> will be associated with the
127 media-type <code>text/html</code>.</p>
129 <p><a href="#charset-lang">Languages</a> and <a href="#contentencoding">content encodings</a> are treated accumulative, because one can assign
130 more than one language or encoding to a particular resource. For example,
131 the file <code>welcome.html.en.de</code> will be delivered with
132 <code>Content-Language: en, de</code> and <code>Content-Type:
133 text/html</code>.</p>
135 <p>Care should be taken when a file with multiple extensions
136 gets associated with both a <a class="glossarylink" href="../glossary.html#media-type" title="see glossary">media-type</a>
137 and a handler. This will
138 usually result in the request being handled by the module associated
139 with the handler. For example, if the <code>.imap</code>
140 extension is mapped to the handler <code>imap-file</code> (from
141 <code class="module"><a href="../mod/mod_imagemap.html">mod_imagemap</a></code>) and the <code>.html</code> extension is
142 mapped to the media-type <code>text/html</code>, then the file
143 <code>world.imap.html</code> will be associated with both the
144 <code>imap-file</code> handler and <code>text/html</code> media-type.
145 When it is processed, the <code>imap-file</code> handler will be used,
146 and so it will be treated as a <code class="module"><a href="../mod/mod_imagemap.html">mod_imagemap</a></code> imagemap
149 <p>If you would prefer only the last dot-separated part of the
150 filename to be mapped to a particular piece of meta-data, then do
151 not use the <code>Add*</code> directives. For example, if you wish
152 to have the file <code>foo.html.cgi</code> processed as a CGI
153 script, but not the file <code>bar.cgi.html</code>, then instead
154 of using <code>AddHandler cgi-script .cgi</code>, use</p>
156 <div class="example"><h3>Configure handler based on final extension only</h3><p><code>
157 <FilesMatch \.cgi$>
158 <span class="indent">
159 SetHandler cgi-script
164 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
165 <div class="section">
166 <h2><a name="contentencoding" id="contentencoding">Content encoding</a></h2>
167 <p>A file of a particular <a class="glossarylink" href="../glossary.html#media-type" title="see glossary">media-type</a> can additionally be encoded a
168 particular way to simplify transmission over the Internet.
169 While this usually will refer to compression, such as
170 <code>gzip</code>, it can also refer to encryption, such a
171 <code>pgp</code> or to an encoding such as UUencoding, which is
172 designed for transmitting a binary file in an ASCII (text)
175 <p>The <a href="http://www.ietf.org/rfc/rfc2616.txt">HTTP/1.1
176 RFC</a>, section 14.11 puts it this way:</p>
178 <blockquote cite="http://www.ietf.org/rfc/rfc2616.txt">
179 <p>The Content-Encoding entity-header field is used as a modifier to
180 the media-type. When present, its value indicates what additional
181 content codings have been applied to the entity-body, and thus what
182 decoding mechanisms must be applied in order to obtain the media-type
183 referenced by the Content-Type header field. Content-Encoding is
184 primarily used to allow a document to be compressed without losing
185 the identity of its underlying media type.</p>
188 <p>By using more than one file extension (see <a href="#multipleext">section above about multiple file
189 extensions</a>), you can indicate that a file is of a
190 particular <em>type</em>, and also has a particular
191 <em>encoding</em>. </p>
193 <p>For example, you may have a file which is a Microsoft Word
194 document, which is pkzipped to reduce its size. If the
195 <code>.doc</code> extension is associated with the Microsoft
196 Word file type, and the <code>.zip</code> extension is
197 associated with the pkzip file encoding, then the file
198 <code>Resume.doc.zip</code> would be known to be a pkzip'ed Word
201 <p>Apache sends a <code>Content-encoding</code> header with the
202 resource, in order to tell the client browser about the
205 <div class="example"><p><code>Content-encoding: pkzip</code></p></div>
206 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
207 <div class="section">
208 <h2><a name="charset-lang" id="charset-lang">Character sets and languages</a></h2>
209 <p>In addition to file type and the file encoding,
210 another important piece of information is what language a
211 particular document is in, and in what character set the file
212 should be displayed. For example, the document might be written
213 in the Vietnamese alphabet, or in Cyrillic, and should be
214 displayed as such. This information, also, is transmitted in
217 <p>The character set, language, encoding and mime type are all
218 used in the process of content negotiation (See
219 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>) to determine
220 which document to give to the client, when there are
221 alternative documents in more than one character set, language,
222 encoding or mime type. All filename extensions associations
223 created with <code class="directive"><a href="#addcharset">AddCharset</a></code>,
224 <code class="directive"><a href="#addencoding">AddEncoding</a></code>, <code class="directive"><a href="#addlanguage">AddLanguage</a></code> and <code class="directive"><a href="#addtype">AddType</a></code> directives
225 (and extensions listed in the <code class="directive"><a href="../mod/mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></code>) participate in this select process.
226 Filename extensions that are only associated using the <code class="directive"><a href="#addhandler">AddHandler</a></code>, <code class="directive"><a href="#addinputfilter">AddInputFilter</a></code> or <code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code> directives may be included or excluded
227 from matching by using the <code class="directive"><a href="#multiviewsmatch">MultiviewsMatch</a></code> directive.</p>
229 <h3><a name="charset" id="charset">Charset</a></h3>
230 <p>To convey this further information, Apache optionally sends
231 a <code>Content-Language</code> header, to specify the language
232 that the document is in, and can append additional information
233 onto the <code>Content-Type</code> header to indicate the
234 particular character set that should be used to correctly
235 render the information.</p>
237 <div class="example"><p><code>
238 Content-Language: en, fr<br />
239 Content-Type: text/plain; charset=ISO-8859-1
242 <p>The language specification is the two-letter abbreviation
243 for the language. The <code>charset</code> is the name of the
244 particular character set which should be used.</p>
247 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
248 <div class="directive-section"><h2><a name="AddCharset" id="AddCharset">AddCharset</a> <a name="addcharset" id="addcharset">Directive</a></h2>
249 <table class="directive">
250 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions to the specified content
252 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddCharset <var>charset</var> <var>extension</var>
253 [<var>extension</var>] ...</code></td></tr>
254 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
255 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
256 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
257 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
259 <p>The <code class="directive">AddCharset</code> directive maps the given
260 filename extensions to the specified content charset (the Internet
261 registered name for a given character encoding). <var>charset</var>
262 is the <a href="http://www.iana.org/assignments/character-sets">media
263 type's charset parameter</a> for resources with filenames containing
264 <var>extension</var>. This mapping is added to any already in force,
265 overriding any mappings that already exist for the same
266 <var>extension</var>.</p>
268 <div class="example"><h3>Example</h3><p><code>
269 AddLanguage ja .ja<br />
270 AddCharset EUC-JP .euc<br />
271 AddCharset ISO-2022-JP .jis<br />
272 AddCharset SHIFT_JIS .sjis
275 <p>Then the document <code>xxxx.ja.jis</code> will be treated
276 as being a Japanese document whose charset is <code>ISO-2022-JP</code>
277 (as will the document <code>xxxx.jis.ja</code>). The
278 <code class="directive">AddCharset</code> directive is useful for both to
279 inform the client about the character encoding of the document so that
280 the document can be interpreted and displayed appropriately, and for <a href="../content-negotiation.html">content negotiation</a>,
281 where the server returns one from several documents based on
282 the client's charset preference.</p>
284 <p>The <var>extension</var> argument is case-insensitive and can
285 be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
286 <var>extension</var> argument will be compared against each of
292 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
293 <li><code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code></li>
296 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
297 <div class="directive-section"><h2><a name="AddEncoding" id="AddEncoding">AddEncoding</a> <a name="addencoding" id="addencoding">Directive</a></h2>
298 <table class="directive">
299 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions to the specified encoding
301 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddEncoding <var>encoding</var> <var>extension</var>
302 [<var>extension</var>] ...</code></td></tr>
303 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
304 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
305 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
306 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
308 <p>The <code class="directive">AddEncoding</code> directive maps the given
309 filename extensions to the specified HTTP content-encoding.
310 <var>encoding</var> is the HTTP content coding to append to the
311 value of the Content-Encoding header field for documents named with the
312 <var>extension</var>. This mapping is added to any already in force,
313 overriding any mappings that already exist for the same
314 <var>extension</var>.</p>
316 <div class="example"><h3>Example</h3><p><code>
317 AddEncoding x-gzip .gz<br />
318 AddEncoding x-compress .Z
321 <p>This will cause filenames containing the <code>.gz</code> extension
322 to be marked as encoded using the <code>x-gzip</code> encoding, and
323 filenames containing the <code>.Z</code> extension to be marked as
324 encoded with <code>x-compress</code>.</p>
326 <p>Old clients expect <code>x-gzip</code> and <code>x-compress</code>,
327 however the standard dictates that they're equivalent to
328 <code>gzip</code> and <code>compress</code> respectively. Apache does
329 content encoding comparisons by ignoring any leading <code>x-</code>.
330 When responding with an encoding Apache will use whatever form
331 (<em>i.e.</em>, <code>x-foo</code> or <code>foo</code>) the
332 client requested. If the client didn't specifically request a
333 particular form Apache will use the form given by the
334 <code>AddEncoding</code> directive. To make this long story
335 short, you should always use <code>x-gzip</code> and
336 <code>x-compress</code> for these two specific encodings. More
337 recent encodings, such as <code>deflate</code>, should be
338 specified without the <code>x-</code>.</p>
340 <p>The <var>extension</var> argument is case-insensitive and can
341 be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
342 <var>extension</var> argument will be compared against each of
346 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
347 <div class="directive-section"><h2><a name="AddHandler" id="AddHandler">AddHandler</a> <a name="addhandler" id="addhandler">Directive</a></h2>
348 <table class="directive">
349 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the filename extensions to the specified
351 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddHandler <var>handler-name</var> <var>extension</var>
352 [<var>extension</var>] ...</code></td></tr>
353 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
354 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
355 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
356 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
358 <p>Files having the name <var>extension</var> will be served by the
359 specified <var><a href="../handler.html">handler-name</a></var>. This
360 mapping is added to any already in force, overriding any mappings that
361 already exist for the same <var>extension</var>. For example, to
362 activate CGI scripts with the file extension <code>.cgi</code>, you
365 <div class="example"><p><code>
366 AddHandler cgi-script .cgi
369 <p>Once that has been put into your httpd.conf file, any file containing
370 the <code>.cgi</code> extension will be treated as a CGI program.</p>
372 <p>The <var>extension</var> argument is case-insensitive and can
373 be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
374 <var>extension</var> argument will be compared against each of
379 <li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li>
382 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
383 <div class="directive-section"><h2><a name="AddInputFilter" id="AddInputFilter">AddInputFilter</a> <a name="addinputfilter" id="addinputfilter">Directive</a></h2>
384 <table class="directive">
385 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps filename extensions to the filters that will process
386 client requests</td></tr>
387 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddInputFilter <var>filter</var>[;<var>filter</var>...]
388 <var>extension</var> [<var>extension</var>] ...</code></td></tr>
389 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
390 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
391 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
392 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
393 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>AddInputFilter is only available in Apache 2.0.26 and
396 <p><code class="directive">AddInputFilter</code> maps the filename extension
397 <var>extension</var> to the <a href="../filter.html">filters</a> which
398 will process client requests and POST input when they are received by
399 the server. This is in addition to any filters defined elsewhere,
400 including the <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code>
401 directive. This mapping is merged over any already in force, overriding
402 any mappings that already exist for the same <var>extension</var>.</p>
404 <p>If more than one <var>filter</var> is specified, they must be separated
405 by semicolons in the order in which they should process the
406 content. The <var>filter</var> is case-insensitive.</p>
408 <p>The <var>extension</var> argument is case-insensitive and can
409 be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
410 <var>extension</var> argument will be compared against each of
416 <li><code class="directive"><a href="#removeinputfilter">RemoveInputFilter</a></code></li>
417 <li><code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code></li>
420 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
421 <div class="directive-section"><h2><a name="AddLanguage" id="AddLanguage">AddLanguage</a> <a name="addlanguage" id="addlanguage">Directive</a></h2>
422 <table class="directive">
423 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extension to the specified content
425 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddLanguage <var>language-tag</var> <var>extension</var>
426 [<var>extension</var>] ...</code></td></tr>
427 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
428 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
429 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
430 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
432 <p>The <code class="directive">AddLanguage</code> directive maps the given
433 filename extension to the specified content language. Files with the
434 filename <var>extension</var> are assigned an HTTP Content-Language
435 value of <var>language-tag</var> corresponding to the language
436 identifiers defined by RFC 3066.
437 This directive overrides any mappings that already exist for the same
438 <var>extension</var>.</p>
440 <div class="example"><h3>Example</h3><p><code>
441 AddEncoding x-compress .Z<br />
442 AddLanguage en .en<br />
446 <p>Then the document <code>xxxx.en.Z</code> will be treated as
447 being a compressed English document (as will the document
448 <code>xxxx.Z.en</code>). Although the content language is
449 reported to the client, the browser is unlikely to use this
450 information. The <code class="directive">AddLanguage</code> directive is
451 more useful for <a href="../content-negotiation.html">content
452 negotiation</a>, where the server returns one from several documents
453 based on the client's language preference.</p>
455 <p>If multiple language assignments are made for the same
456 extension, the last one encountered is the one that is used.
457 That is, for the case of:</p>
459 <div class="example"><p><code>
460 AddLanguage en .en<br />
461 AddLanguage en-gb .en<br />
462 AddLanguage en-us .en
465 <p>documents with the extension <code>.en</code> would be treated as
466 being <code>en-us</code>.</p>
468 <p>The <var>extension</var> argument is case-insensitive and can
469 be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
470 <var>extension</var> argument will be compared against each of
475 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
478 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
479 <div class="directive-section"><h2><a name="AddOutputFilter" id="AddOutputFilter">AddOutputFilter</a> <a name="addoutputfilter" id="addoutputfilter">Directive</a></h2>
480 <table class="directive">
481 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps filename extensions to the filters that will process
482 responses from the server</td></tr>
483 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddOutputFilter <var>filter</var>[;<var>filter</var>...]
484 <var>extension</var> [<var>extension</var>] ...</code></td></tr>
485 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
486 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
487 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
488 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
489 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>AddOutputFilter is only available in Apache 2.0.26 and
492 <p>The <code class="directive">AddOutputFilter</code> directive maps the
493 filename extension <var>extension</var> to the <a href="../filter.html">filters</a> which will process responses
494 from the server before they are sent to the client. This is in
495 addition to any filters defined elsewhere, including <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code> and <code class="directive"><a href="../mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code> directive. This mapping is merged
496 over any already in force, overriding any mappings that already exist
497 for the same <var>extension</var>.</p>
499 <p>For example, the following configuration will process all
500 <code>.shtml</code> files for server-side includes and will then
501 compress the output using <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>.</p>
503 <div class="example"><p><code>
504 AddOutputFilter INCLUDES;DEFLATE shtml
507 <p>If more than one filter is specified, they must be separated
508 by semicolons in the order in which they should process the
509 content. The <var>filter</var> argument is case-insensitive.</p>
511 <p>The <var>extension</var> argument is case-insensitive and can
512 be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
513 <var>extension</var> argument will be compared against each of
518 <li><code class="directive"><a href="#removeoutputfilter">RemoveOutputFilter</a></code></li>
519 <li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li>
522 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
523 <div class="directive-section"><h2><a name="AddType" id="AddType">AddType</a> <a name="addtype" id="addtype">Directive</a></h2>
524 <table class="directive">
525 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions onto the specified content
527 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddType <var>media-type</var> <var>extension</var>
528 [<var>extension</var>] ...</code></td></tr>
529 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
530 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
531 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
532 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
534 <p>The <code class="directive">AddType</code> directive maps the given
535 filename extensions onto the specified content
536 type. <var>media-type</var> is the <a class="glossarylink" href="../glossary.html#media-type" title="see glossary">media
537 type</a> to use for filenames containing
538 <var>extension</var>. This mapping is added to any already in
539 force, overriding any mappings that already exist for the same
540 <var>extension</var>.</p>
543 It is recommended that new media types be added using the
544 <code class="directive">AddType</code> directive rather than changing the
545 <code class="directive"><a href="#typesconfig">TypesConfig</a></code> file.
548 <div class="example"><h3>Example</h3><p><code>
549 AddType image/gif .gif
552 <p>Or, to specify multiple file extensions in one directive:</p>
554 <div class="example"><h3>Example</h3><p><code>
555 AddType image/jpeg jpeg jpg jpe
558 <p>The <var>extension</var> argument is case-insensitive and can
559 be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
560 <var>extension</var> argument will be compared against each of
563 <p>A simmilar effect to <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>'s
564 <code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>
565 can be achieved by qualifying a <var>media-type</var> with
568 <div class="example"><h3>Example</h3><p><code>
569 Addtype application/rss+xml;qs=0.8 .xml
572 <p>This is useful in situations, <em>e.g.</em> when a client
573 requesting <code>Accept: */*</code> can not actually processes
574 the content returned by the server.</p>
576 <p>This directive primarily configures the content types generated for
577 static files served out of the filesystem. For resources other than
578 static files, where the generator of the response typically specifies
579 a Content-Type, this directive has no effect.</p>
584 <li><code class="directive"><a href="../mod/core.html#forcetype">ForceType</a></code></li>
585 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
588 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
589 <div class="directive-section"><h2><a name="DefaultLanguage" id="DefaultLanguage">DefaultLanguage</a> <a name="defaultlanguage" id="defaultlanguage">Directive</a></h2>
590 <table class="directive">
591 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines a default language-tag to be sent in the Content-Language
592 header field for all resources in the current context that have not been
593 assigned a language-tag by some other means.</td></tr>
594 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultLanguage <var>language-tag</var></code></td></tr>
595 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
596 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
597 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
598 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
600 <p>The <code class="directive">DefaultLanguage</code> directive tells Apache
601 that all resources in the directive's scope (<em>e.g.</em>, all resources
602 covered by the current <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> container) that don't have an explicit language
603 extension (such as <code>.fr</code> or <code>.de</code> as configured
604 by <code class="directive"><a href="#addlanguage">AddLanguage</a></code>) should be
605 assigned a Content-Language of <var>language-tag</var>. This allows
606 entire directory trees to be marked as containing Dutch content, for
607 instance, without having to rename each file. Note that unlike using
608 extensions to specify languages, <code class="directive">DefaultLanguage</code>
609 can only specify a single language.</p>
611 <p>If no <code class="directive">DefaultLanguage</code> directive is in force
612 and a file does not have any language extensions as configured
613 by <code class="directive"><a href="#addlanguage">AddLanguage</a></code>, then no
614 Content-Language header field will be generated.</p>
616 <div class="example"><h3>Example</h3><p><code>
622 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
625 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
626 <div class="directive-section"><h2><a name="ModMimeUsePathInfo" id="ModMimeUsePathInfo">ModMimeUsePathInfo</a> <a name="modmimeusepathinfo" id="modmimeusepathinfo">Directive</a></h2>
627 <table class="directive">
628 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tells <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> to treat <code>path_info</code>
629 components as part of the filename</td></tr>
630 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ModMimeUsePathInfo On|Off</code></td></tr>
631 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ModMimeUsePathInfo Off</code></td></tr>
632 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory</td></tr>
633 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
634 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
635 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.41 and later</td></tr>
637 <p>The <code class="directive">ModMimeUsePathInfo</code> directive is used to
638 combine the filename with the <code>path_info</code> URL component to
639 apply <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code>'s directives to the request. The default
640 value is <code>Off</code> - therefore, the <code>path_info</code>
641 component is ignored.</p>
643 <p>This directive is recommended when you have a virtual filesystem.</p>
645 <div class="example"><h3>Example</h3><p><code>
646 ModMimeUsePathInfo On
649 <p>If you have a request for <code>/index.php/foo.shtml</code>
650 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> will now treat the
651 incoming request as <code>/index.php/foo.shtml</code> and directives
652 like <code>AddOutputFilter INCLUDES .shtml</code> will add the
653 <code>INCLUDES</code> filter to the request. If <code class="directive">ModMimeUsePathInfo</code> is not set, the
654 <code>INCLUDES</code> filter will not be added. This will work
655 analogously for virtual paths, such as those defined by
656 <code class="directive"><Location></code></p>
660 <li><code class="directive"><a href="../mod/core.html#acceptpathinfo">AcceptPathInfo</a></code></li>
663 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
664 <div class="directive-section"><h2><a name="MultiviewsMatch" id="MultiviewsMatch">MultiviewsMatch</a> <a name="multiviewsmatch" id="multiviewsmatch">Directive</a></h2>
665 <table class="directive">
666 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The types of files that will be included when searching for
667 a matching file with MultiViews</td></tr>
668 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers
669 [Handlers|Filters]</code></td></tr>
670 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MultiviewsMatch NegotiatedOnly</code></td></tr>
671 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
672 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
673 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
674 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
675 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.26 and later.</td></tr>
677 <p><code class="directive">MultiviewsMatch</code> permits three different
678 behaviors for <a href="mod_negotiation.html">mod_negotiation</a>'s
679 Multiviews feature. Multiviews allows a request for a file,
680 <em>e.g.</em> <code>index.html</code>, to match any negotiated
681 extensions following the base request, <em>e.g.</em>
682 <code>index.html.en</code>, <code>index.html.fr</code>, or
683 <code>index.html.gz</code>.</p>
685 <p>The <code>NegotiatedOnly</code> option provides that every extension
686 following the base name must correlate to a recognized
687 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> extension for content negotiation, <em>e.g.</em>
688 Charset, Content-Type, Language, or Encoding. This is the strictest
689 implementation with the fewest unexpected side effects, and is the
690 default behavior.</p>
692 <p>To include extensions associated with Handlers and/or Filters,
693 set the <code class="directive">MultiviewsMatch</code> directive to either
694 <code>Handlers</code>, <code>Filters</code>, or both option keywords.
695 If all other factors are equal, the smallest file will be served,
696 <em>e.g.</em> in deciding between <code>index.html.cgi</code> of 500
697 bytes and <code>index.html.pl</code> of 1000 bytes, the <code>.cgi</code>
698 file would win in this example. Users of <code>.asis</code> files
699 might prefer to use the Handler option, if <code>.asis</code> files are
700 associated with the <code>asis-handler</code>.</p>
702 <p>You may finally allow <code>Any</code> extensions to match, even if
703 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> doesn't recognize the extension. This can cause
704 unpredicatable results, such as serving .old or .bak files the webmaster
705 never expected to be served.</p>
707 <p>For example, the following configuration will allow handlers
708 and filters to participate in Multviews, but will exclude unknown
711 <div class="example"><p><code>
712 MultiviewsMatch Handlers Filters
715 <p><code class="directive">MultiviewsMatch</code> is not allowed in a
716 <code class="directive"><a href="../mod/core.html#location"><Location></a></code> or <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code> section.</p>
721 <li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li>
722 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
725 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
726 <div class="directive-section"><h2><a name="RemoveCharset" id="RemoveCharset">RemoveCharset</a> <a name="removecharset" id="removecharset">Directive</a></h2>
727 <table class="directive">
728 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any character set associations for a set of file
730 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveCharset <var>extension</var> [<var>extension</var>]
732 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
733 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
734 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
735 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
736 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveCharset is only available in Apache 2.0.24 and
739 <p>The <code class="directive">RemoveCharset</code> directive removes any
740 character set associations for files with the given extensions.
741 This allows <code>.htaccess</code> files in subdirectories to
742 undo any associations inherited from parent directories or the
743 server config files.</p>
745 <p>The <var>extension</var> argument is case-insensitive and can
746 be specified with or without a leading dot.</p>
748 <div class="example"><h3>Example</h3><p><code>
749 RemoveCharset .html .shtml
753 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
754 <div class="directive-section"><h2><a name="RemoveEncoding" id="RemoveEncoding">RemoveEncoding</a> <a name="removeencoding" id="removeencoding">Directive</a></h2>
755 <table class="directive">
756 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any content encoding associations for a set of file
758 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveEncoding <var>extension</var> [<var>extension</var>]
760 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
761 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
762 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
763 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
765 <p>The <code class="directive">RemoveEncoding</code> directive removes any
766 encoding associations for files with the given extensions. This
767 allows <code>.htaccess</code> files in subdirectories to undo
768 any associations inherited from parent directories or the
769 server config files. An example of its use might be:</p>
771 <div class="example"><h3>/foo/.htaccess:</h3><p><code>
772 AddEncoding x-gzip .gz<br />
773 AddType text/plain .asc<br />
774 <Files *.gz.asc><br />
775 <span class="indent">
776 RemoveEncoding .gz<br />
781 <p>This will cause <code>foo.gz</code> to be marked as being
782 encoded with the gzip method, but <code>foo.gz.asc</code> as an
783 unencoded plaintext file.</p>
785 <div class="note"><h3>Note</h3>
786 <p><code class="directive">RemoveEncoding</code> directives are processed
787 <em>after</em> any <code class="directive"><a href="#addencoding">AddEncoding</a></code>
788 directives, so it is possible they may undo the effects of the latter
789 if both occur within the same directory configuration.</p>
792 <p>The <var>extension</var> argument is case-insensitive and can
793 be specified with or without a leading dot.</p>
796 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
797 <div class="directive-section"><h2><a name="RemoveHandler" id="RemoveHandler">RemoveHandler</a> <a name="removehandler" id="removehandler">Directive</a></h2>
798 <table class="directive">
799 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any handler associations for a set of file
801 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveHandler <var>extension</var> [<var>extension</var>]
803 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
804 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
805 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
806 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
808 <p>The <code class="directive">RemoveHandler</code> directive removes any
809 handler associations for files with the given extensions. This allows
810 <code>.htaccess</code> files in subdirectories to undo any
811 associations inherited from parent directories or the server
812 config files. An example of its use might be:</p>
814 <div class="example"><h3>/foo/.htaccess:</h3><p><code>
815 AddHandler server-parsed .html
818 <div class="example"><h3>/foo/bar/.htaccess:</h3><p><code>
822 <p>This has the effect of returning <code>.html</code> files in
823 the <code>/foo/bar</code> directory to being treated as normal
824 files, rather than as candidates for parsing (see the <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> module).</p>
826 <p>The <var>extension</var> argument is case-insensitive and can
827 be specified with or without a leading dot.</p>
830 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
831 <div class="directive-section"><h2><a name="RemoveInputFilter" id="RemoveInputFilter">RemoveInputFilter</a> <a name="removeinputfilter" id="removeinputfilter">Directive</a></h2>
832 <table class="directive">
833 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any input filter associations for a set of file
835 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveInputFilter <var>extension</var> [<var>extension</var>]
837 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
838 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
839 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
840 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
841 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveInputFilter is only available in Apache 2.0.26 and
844 <p>The <code class="directive">RemoveInputFilter</code> directive removes any
845 input <a href="../filter.html">filter</a> associations for files with
846 the given extensions.
847 This allows <code>.htaccess</code> files in subdirectories to
848 undo any associations inherited from parent directories or the
849 server config files.</p>
851 <p>The <var>extension</var> argument is case-insensitive and can
852 be specified with or without a leading dot.</p>
856 <li><code class="directive"><a href="#addinputfilter">AddInputFilter</a></code></li>
857 <li><code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code></li>
860 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
861 <div class="directive-section"><h2><a name="RemoveLanguage" id="RemoveLanguage">RemoveLanguage</a> <a name="removelanguage" id="removelanguage">Directive</a></h2>
862 <table class="directive">
863 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any language associations for a set of file
865 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveLanguage <var>extension</var> [<var>extension</var>]
867 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
868 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
869 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
870 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
871 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveLanguage is only available in Apache 2.0.24 and
874 <p>The <code class="directive">RemoveLanguage</code> directive removes any
875 language associations for files with the given extensions. This
876 allows <code>.htaccess</code> files in subdirectories to undo
877 any associations inherited from parent directories or the
878 server config files.</p>
880 <p>The <var>extension</var> argument is case-insensitive and can
881 be specified with or without a leading dot.</p>
884 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
885 <div class="directive-section"><h2><a name="RemoveOutputFilter" id="RemoveOutputFilter">RemoveOutputFilter</a> <a name="removeoutputfilter" id="removeoutputfilter">Directive</a></h2>
886 <table class="directive">
887 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any output filter associations for a set of file
889 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveOutputFilter <var>extension</var> [<var>extension</var>]
891 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
892 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
893 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
894 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
895 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveOutputFilter is only available in Apache 2.0.26 and
898 <p>The <code class="directive">RemoveOutputFilter</code> directive removes any
899 output <a href="../filter.html">filter</a> associations for files with
900 the given extensions.
901 This allows <code>.htaccess</code> files in subdirectories to
902 undo any associations inherited from parent directories or the
903 server config files.</p>
905 <p>The <var>extension</var> argument is case-insensitive and can
906 be specified with or without a leading dot.</p>
908 <div class="example"><h3>Example</h3><p><code>
909 RemoveOutputFilter shtml
914 <li><code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code></li>
917 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
918 <div class="directive-section"><h2><a name="RemoveType" id="RemoveType">RemoveType</a> <a name="removetype" id="removetype">Directive</a></h2>
919 <table class="directive">
920 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any content type associations for a set of file
922 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveType <var>extension</var> [<var>extension</var>]
924 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
925 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
926 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
927 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
929 <p>The <code class="directive">RemoveType</code> directive removes any
930 <a class="glossarylink" href="../glossary.html#media-type" title="see glossary">media type</a> associations for files with
931 the given extensions. This allows <code>.htaccess</code> files in
932 subdirectories to undo any associations inherited from parent
933 directories or the server config files. An example of its use
936 <div class="example"><h3>/foo/.htaccess:</h3><p><code>
940 <p>This will remove any special handling of <code>.cgi</code>
941 files in the <code>/foo/</code> directory and any beneath it,
942 causing responses containing those files to omit the HTTP
943 Content-Type header field.</p>
945 <div class="note"><h3>Note</h3>
946 <p><code class="directive">RemoveType</code> directives are processed
947 <em>after</em> any <code class="directive"><a href="#addtype">AddType</a></code>
948 directives, so it is possible they may undo the effects of the
949 latter if both occur within the same directory configuration.</p>
952 <p>The <var>extension</var> argument is case-insensitive and can
953 be specified with or without a leading dot.</p>
956 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
957 <div class="directive-section"><h2><a name="TypesConfig" id="TypesConfig">TypesConfig</a> <a name="typesconfig" id="typesconfig">Directive</a></h2>
958 <table class="directive">
959 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The location of the <code>mime.types</code> file</td></tr>
960 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TypesConfig <var>file-path</var></code></td></tr>
961 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>TypesConfig conf/mime.types</code></td></tr>
962 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
963 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
964 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
966 <p>The <code class="directive">TypesConfig</code> directive sets the
967 location of the <a class="glossarylink" href="../glossary.html#media-type" title="see glossary">media types</a>
968 configuration file. <var>File-path</var> is relative to the
969 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. This file sets
970 the default list of mappings from filename extensions to content
971 types. Most administrators use the <code>mime.types</code> file
972 provided by their OS, which associates common filename
973 extensions with the official list of IANA registered media types
974 maintained at <a href="http://www.iana.org/assignments/media-types/index.html">http://www.iana.org/assignments/media-types/index.html</a>
975 as well as a large number of unofficial types. This
976 simplifies the <code>httpd.conf</code> file by providing the
977 majority of media-type definitions, and may be overridden by
978 <code class="directive"><a href="#addtype">AddType</a></code> directives as
979 needed. You should not edit the <code>mime.types</code> file,
980 because it may be replaced when you upgrade your server.</p>
982 <p>The file contains lines in the format of the arguments to
983 an <code class="directive"><a href="#addtype">AddType</a></code> directive:</p>
985 <div class="example"><p><code>
986 <var>media-type</var> [<var>extension</var>] ...
989 <p>The case of the extension does not matter. Blank lines, and lines
990 beginning with a hash character (<code>#</code>) are ignored.
991 Empty lines are there for completeness (of the mime.types file).
992 Apache httpd can still determine these types with <code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code>.
996 Please do <strong>not</strong> send requests to the Apache HTTP
997 Server Project to add any new entries in the distributed
998 <code>mime.types</code> file unless (1) they are already
999 registered with IANA, and (2) they use widely accepted,
1000 non-conflicting filename extensions across platforms.
1001 <code>category/x-subtype</code> requests will be automatically
1002 rejected, as will any new two-letter extensions as they will
1003 likely conflict later with the already crowded language and
1004 character set namespace.
1009 <li><code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code></li>
1013 <div class="bottomlang">
1014 <p><span>Available Languages: </span><a href="../en/mod/mod_mime.html" title="English"> en </a> |
1015 <a href="../ja/mod/mod_mime.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
1016 </div><div id="footer">
1017 <p class="apache">Copyright 2011 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
1018 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>