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/core.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>. This directive can be used to add mappings
541 not listed in the media types file (see the <code class="directive"><a href="#typesconfig">TypesConfig</a></code> directive).</p>
543 <div class="example"><h3>Example</h3><p><code>
544 AddType image/gif .gif
547 <p>Or, to specify multiple file extensions in one directive:</p>
549 <div class="example"><h3>Example</h3><p><code>
550 AddType image/jpeg jpeg jpg jpe
554 It is recommended that new media types be added using the
555 <code class="directive">AddType</code> directive rather than changing the
556 <code class="directive"><a href="#typesconfig">TypesConfig</a></code> file.
559 <p>The <var>extension</var> argument is case-insensitive and can
560 be specified with or without a leading dot. Filenames may have <a href="#multipleext">multiple extensions</a> and the
561 <var>extension</var> argument will be compared against each of
566 <li><code class="directive"><a href="../mod/core.html#forcetype">ForceType</a></code></li>
569 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
570 <div class="directive-section"><h2><a name="DefaultLanguage" id="DefaultLanguage">DefaultLanguage</a> <a name="defaultlanguage" id="defaultlanguage">Directive</a></h2>
571 <table class="directive">
572 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines a default language-tag to be sent in the Content-Language
573 header field for all resources in the current context that have not been
574 assigned a language-tag by some other means.</td></tr>
575 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultLanguage <var>language-tag</var></code></td></tr>
576 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
577 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
578 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
579 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
581 <p>The <code class="directive">DefaultLanguage</code> directive tells Apache
582 that all resources in the directive's scope (<em>e.g.</em>, all resources
583 covered by the current <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> container) that don't have an explicit language
584 extension (such as <code>.fr</code> or <code>.de</code> as configured
585 by <code class="directive"><a href="#addlanguage">AddLanguage</a></code>) should be
586 assigned a Content-Language of <var>language-tag</var>. This allows
587 entire directory trees to be marked as containing Dutch content, for
588 instance, without having to rename each file. Note that unlike using
589 extensions to specify languages, <code class="directive">DefaultLanguage</code>
590 can only specify a single language.</p>
592 <p>If no <code class="directive">DefaultLanguage</code> directive is in force
593 and a file does not have any language extensions as configured
594 by <code class="directive"><a href="#addlanguage">AddLanguage</a></code>, then no
595 Content-Language header field will be generated.</p>
597 <div class="example"><h3>Example</h3><p><code>
603 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
606 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
607 <div class="directive-section"><h2><a name="ModMimeUsePathInfo" id="ModMimeUsePathInfo">ModMimeUsePathInfo</a> <a name="modmimeusepathinfo" id="modmimeusepathinfo">Directive</a></h2>
608 <table class="directive">
609 <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>
610 components as part of the filename</td></tr>
611 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ModMimeUsePathInfo On|Off</code></td></tr>
612 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ModMimeUsePathInfo Off</code></td></tr>
613 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory</td></tr>
614 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
615 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
616 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.41 and later</td></tr>
618 <p>The <code class="directive">ModMimeUsePathInfo</code> directive is used to
619 combine the filename with the <code>path_info</code> URL component to
620 apply <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code>'s directives to the request. The default
621 value is <code>Off</code> - therefore, the <code>path_info</code>
622 component is ignored.</p>
624 <p>This directive is recommended when you have a virtual filesystem.</p>
626 <div class="example"><h3>Example</h3><p><code>
627 ModMimeUsePathInfo On
630 <p>If you have a request for <code>/bar/foo.shtml</code> where
631 <code>/bar</code> is a Location and <code class="directive">ModMimeUsePathInfo</code> is <code>On</code>,
632 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> will treat the incoming request as
633 <code>/bar/foo.shtml</code> and directives like <code>AddOutputFilter
634 INCLUDES .shtml</code> will add the <code>INCLUDES</code> filter to the
635 request. If <code class="directive">ModMimeUsePathInfo</code> is not set, the
636 <code>INCLUDES</code> filter will not be added.</p>
640 <li><code class="directive"><a href="../mod/core.html#acceptpathinfo">AcceptPathInfo</a></code></li>
643 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
644 <div class="directive-section"><h2><a name="MultiviewsMatch" id="MultiviewsMatch">MultiviewsMatch</a> <a name="multiviewsmatch" id="multiviewsmatch">Directive</a></h2>
645 <table class="directive">
646 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The types of files that will be included when searching for
647 a matching file with MultiViews</td></tr>
648 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers
649 [Handlers|Filters]</code></td></tr>
650 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MultiviewsMatch NegotiatedOnly</code></td></tr>
651 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
652 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
653 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
654 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
655 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.26 and later.</td></tr>
657 <p><code class="directive">MultiviewsMatch</code> permits three different
658 behaviors for <a href="mod_negotiation.html">mod_negotiation</a>'s
659 Multiviews feature. Multiviews allows a request for a file,
660 <em>e.g.</em> <code>index.html</code>, to match any negotiated
661 extensions following the base request, <em>e.g.</em>
662 <code>index.html.en</code>, <code>index.html.fr</code>, or
663 <code>index.html.gz</code>.</p>
665 <p>The <code>NegotiatedOnly</code> option provides that every extension
666 following the base name must correlate to a recognized
667 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> extension for content negotation, <em>e.g.</em>
668 Charset, Content-Type, Language, or Encoding. This is the strictest
669 implementation with the fewest unexpected side effects, and is the
670 default behavior.</p>
672 <p>To include extensions associated with Handlers and/or Filters,
673 set the <code class="directive">MultiviewsMatch</code> directive to either
674 <code>Handlers</code>, <code>Filters</code>, or both option keywords.
675 If all other factors are equal, the smallest file will be served,
676 <em>e.g.</em> in deciding between <code>index.html.cgi</code> of 500
677 bytes and <code>index.html.pl</code> of 1000 bytes, the <code>.cgi</code>
678 file would win in this example. Users of <code>.asis</code> files
679 might prefer to use the Handler option, if <code>.asis</code> files are
680 associated with the <code>asis-handler</code>.</p>
682 <p>You may finally allow <code>Any</code> extensions to match, even if
683 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> doesn't recognize the extension. This was the
684 behavior in Apache 1.3, and can cause unpredicatable results, such as
685 serving .old or .bak files the webmaster never expected to be served.</p>
687 <p>For example, the following configuration will allow handlers
688 and filters to participate in Multviews, but will exclude unknown
691 <div class="example"><p><code>
692 MultiviewsMatch Handlers Filters
697 <li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li>
698 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
701 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
702 <div class="directive-section"><h2><a name="RemoveCharset" id="RemoveCharset">RemoveCharset</a> <a name="removecharset" id="removecharset">Directive</a></h2>
703 <table class="directive">
704 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any character set associations for a set of file
706 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveCharset <var>extension</var> [<var>extension</var>]
708 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
709 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
710 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
711 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
712 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveCharset is only available in Apache 2.0.24 and
715 <p>The <code class="directive">RemoveCharset</code> directive removes any
716 character set associations for files with the given extensions.
717 This allows <code>.htaccess</code> files in subdirectories to
718 undo any associations inherited from parent directories or the
719 server config files.</p>
721 <p>The <var>extension</var> argument is case-insensitive and can
722 be specified with or without a leading dot.</p>
724 <div class="example"><h3>Example</h3><p><code>
725 RemoveCharset .html .shtml
729 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
730 <div class="directive-section"><h2><a name="RemoveEncoding" id="RemoveEncoding">RemoveEncoding</a> <a name="removeencoding" id="removeencoding">Directive</a></h2>
731 <table class="directive">
732 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any content encoding associations for a set of file
734 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveEncoding <var>extension</var> [<var>extension</var>]
736 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
737 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
738 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
739 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
741 <p>The <code class="directive">RemoveEncoding</code> directive removes any
742 encoding associations for files with the given extensions. This
743 allows <code>.htaccess</code> files in subdirectories to undo
744 any associations inherited from parent directories or the
745 server config files. An example of its use might be:</p>
747 <div class="example"><h3>/foo/.htaccess:</h3><p><code>
748 AddEncoding x-gzip .gz<br />
749 AddType text/plain .asc<br />
750 <Files *.gz.asc><br />
751 <span class="indent">
752 RemoveEncoding .gz<br />
757 <p>This will cause <code>foo.gz</code> to be marked as being
758 encoded with the gzip method, but <code>foo.gz.asc</code> as an
759 unencoded plaintext file.</p>
761 <div class="note"><h3>Note</h3>
762 <p><code class="directive">RemoveEncoding</code> directives are processed
763 <em>after</em> any <code class="directive"><a href="#addencoding">AddEncoding</a></code>
764 directives, so it is possible they may undo the effects of the latter
765 if both occur within the same directory configuration.</p>
768 <p>The <var>extension</var> argument is case-insensitive and can
769 be specified with or without a leading dot.</p>
772 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
773 <div class="directive-section"><h2><a name="RemoveHandler" id="RemoveHandler">RemoveHandler</a> <a name="removehandler" id="removehandler">Directive</a></h2>
774 <table class="directive">
775 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any handler associations for a set of file
777 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveHandler <var>extension</var> [<var>extension</var>]
779 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
780 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
781 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
782 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
784 <p>The <code class="directive">RemoveHandler</code> directive removes any
785 handler associations for files with the given extensions. This allows
786 <code>.htaccess</code> files in subdirectories to undo any
787 associations inherited from parent directories or the server
788 config files. An example of its use might be:</p>
790 <div class="example"><h3>/foo/.htaccess:</h3><p><code>
791 AddHandler server-parsed .html
794 <div class="example"><h3>/foo/bar/.htaccess:</h3><p><code>
798 <p>This has the effect of returning <code>.html</code> files in
799 the <code>/foo/bar</code> directory to being treated as normal
800 files, rather than as candidates for parsing (see the <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> module).</p>
802 <p>The <var>extension</var> argument is case-insensitive and can
803 be specified with or without a leading dot.</p>
806 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
807 <div class="directive-section"><h2><a name="RemoveInputFilter" id="RemoveInputFilter">RemoveInputFilter</a> <a name="removeinputfilter" id="removeinputfilter">Directive</a></h2>
808 <table class="directive">
809 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any input filter associations for a set of file
811 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveInputFilter <var>extension</var> [<var>extension</var>]
813 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
814 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
815 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
816 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
817 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveInputFilter is only available in Apache 2.0.26 and
820 <p>The <code class="directive">RemoveInputFilter</code> directive removes any
821 input <a href="../filter.html">filter</a> associations for files with
822 the given extensions.
823 This allows <code>.htaccess</code> files in subdirectories to
824 undo any associations inherited from parent directories or the
825 server config files.</p>
827 <p>The <var>extension</var> argument is case-insensitive and can
828 be specified with or without a leading dot.</p>
832 <li><code class="directive"><a href="#addinputfilter">AddInputFilter</a></code></li>
833 <li><code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code></li>
836 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
837 <div class="directive-section"><h2><a name="RemoveLanguage" id="RemoveLanguage">RemoveLanguage</a> <a name="removelanguage" id="removelanguage">Directive</a></h2>
838 <table class="directive">
839 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any language associations for a set of file
841 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveLanguage <var>extension</var> [<var>extension</var>]
843 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
844 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
845 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
846 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
847 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveLanguage is only available in Apache 2.0.24 and
850 <p>The <code class="directive">RemoveLanguage</code> directive removes any
851 language associations for files with the given extensions. This
852 allows <code>.htaccess</code> files in subdirectories to undo
853 any associations inherited from parent directories or the
854 server config files.</p>
856 <p>The <var>extension</var> argument is case-insensitive and can
857 be specified with or without a leading dot.</p>
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="RemoveOutputFilter" id="RemoveOutputFilter">RemoveOutputFilter</a> <a name="removeoutputfilter" id="removeoutputfilter">Directive</a></h2>
862 <table class="directive">
863 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any output filter associations for a set of file
865 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveOutputFilter <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>RemoveOutputFilter is only available in Apache 2.0.26 and
874 <p>The <code class="directive">RemoveOutputFilter</code> directive removes any
875 output <a href="../filter.html">filter</a> associations for files with
876 the given extensions.
877 This allows <code>.htaccess</code> files in subdirectories to
878 undo any associations inherited from parent directories or the
879 server config files.</p>
881 <p>The <var>extension</var> argument is case-insensitive and can
882 be specified with or without a leading dot.</p>
884 <div class="example"><h3>Example</h3><p><code>
885 RemoveOutputFilter shtml
890 <li><code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code></li>
893 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
894 <div class="directive-section"><h2><a name="RemoveType" id="RemoveType">RemoveType</a> <a name="removetype" id="removetype">Directive</a></h2>
895 <table class="directive">
896 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any content type associations for a set of file
898 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveType <var>extension</var> [<var>extension</var>]
900 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
901 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
902 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
903 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
905 <p>The <code class="directive">RemoveType</code> directive removes any
906 <a class="glossarylink" href="../glossary.html#media-type" title="see glossary">media type</a> associations for files with
907 the given extensions. This allows <code>.htaccess</code> files in
908 subdirectories to undo any associations inherited from parent
909 directories or the server config files. An example of its use
912 <div class="example"><h3>/foo/.htaccess:</h3><p><code>
916 <p>This will remove any special handling of <code>.cgi</code>
917 files in the <code>/foo/</code> directory and any beneath it,
918 causing responses containing those files to omit the HTTP
919 Content-Type header field.</p>
921 <div class="note"><h3>Note</h3>
922 <p><code class="directive">RemoveType</code> directives are processed
923 <em>after</em> any <code class="directive"><a href="#addtype">AddType</a></code>
924 directives, so it is possible they may undo the effects of the
925 latter if both occur within the same directory configuration.</p>
928 <p>The <var>extension</var> argument is case-insensitive and can
929 be specified with or without a leading dot.</p>
932 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
933 <div class="directive-section"><h2><a name="TypesConfig" id="TypesConfig">TypesConfig</a> <a name="typesconfig" id="typesconfig">Directive</a></h2>
934 <table class="directive">
935 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The location of the <code>mime.types</code> file</td></tr>
936 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TypesConfig <var>file-path</var></code></td></tr>
937 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>TypesConfig conf/mime.types</code></td></tr>
938 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
939 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
940 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
942 <p>The <code class="directive">TypesConfig</code> directive sets the
943 location of the <a class="glossarylink" href="../glossary.html#media-type" title="see glossary">media types</a>
944 configuration file. <var>File-path</var> is relative to the
945 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. This file sets
946 the default list of mappings from filename extensions to content
947 types. Most administrators use the provided
948 <code>mime.types</code> file, which associates common filename
949 extensions with the official list of IANA registered media types
950 maintained at <a href="http://www.iana.org/assignments/media-types/index.html">http://www.iana.org/assignments/media-types/index.html</a>
951 as well as a large number of unofficial types. This
952 simplifies the <code>httpd.conf</code> file by providing the
953 majority of media-type definitions, and may be overridden by
954 <code class="directive"><a href="#addtype">AddType</a></code> directives as
955 needed. You should not edit the <code>mime.types</code> file,
956 because it may be replaced when you upgrade your server.</p>
958 <p>The file contains lines in the format of the arguments to
959 an <code class="directive"><a href="#addtype">AddType</a></code> directive:</p>
961 <div class="example"><p><code>
962 <var>media-type</var> [<var>extension</var>] ...
965 <p>The case of the extension does not matter. Blank lines, and lines
966 beginning with a hash character (<code>#</code>) are ignored.</p>
969 Please do <strong>not</strong> send requests to the Apache HTTP
970 Server Project to add any new entries in the distributed
971 <code>mime.types</code> file unless (1) they are already
972 registered with IANA, and (2) they use widely accepted,
973 non-conflicting filename extensions across platforms.
974 <code>category/x-subtype</code> requests will be automatically
975 rejected, as will any new two-letter extensions as they will
976 likely conflict later with the already crowded language and
977 character set namespace.
982 <li><code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code></li>
986 <div class="bottomlang">
987 <p><span>Available Languages: </span><a href="../en/mod/mod_mime.html" title="English"> en </a> |
988 <a href="../ja/mod/mod_mime.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
989 </div><div id="footer">
990 <p class="apache">Copyright 2009 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>
991 <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>