granicus.if.org Git - apache/blob - docs/manual/mod/mod_mime.html.en

   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
   7       -->
   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>
  13 <body>
  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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <a href="./">Modules</a></div>
  21 <div id="page-content">
  22 <div id="preamble"><h1>Apache Module mod_mime</h1>
  23 <div class="toplang">
  24 <p><span>Available Languages: </span><a href="../en/mod/mod_mime.html" title="English">&nbsp;en&nbsp;</a> |
  25 <a href="../ja/mod/mod_mime.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
  26 </div>
  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
  30     encoding)</td></tr>
  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>
  34 <h3>Summary</h3>
  35
  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>
  47
  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>
  53
  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>
  59
  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">&lt;Location&gt;</a></code>, <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>, or <code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</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>
  67
  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>
  76 </div>
  77 <div id="quickview"><h3 class="directives">Directives</h3>
  78 <ul id="toc">
  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>
  97 </ul>
  98 <h3>Topics</h3>
  99 <ul id="topics">
 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>
 104 <ul class="seealso">
 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>
 111 </ul></div>
 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>
 128
 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>
 134
 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
 147     file.</p>
 148
 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>
 155
 156     <div class="example"><h3>Configure handler based on final extension only</h3><p><code>
 157     &lt;FilesMatch \.cgi$&gt;
 158     <span class="indent">
 159       SetHandler cgi-script
 160     </span>
 161     &lt;/FilesMatch&gt;
 162     </code></p></div>
 163
 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)
 173     format.</p>
 174
 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>
 177
 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>
 186     </blockquote>
 187
 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>
 192
 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
 199     document.</p>
 200
 201     <p>Apache sends a <code>Content-encoding</code> header with the
 202     resource, in order to tell the client browser about the
 203     encoding method.</p>
 204
 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
 215     HTTP headers.</p>
 216
 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>
 228
 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>
 236
 237       <div class="example"><p><code>
 238         Content-Language: en, fr<br />
 239         Content-Type: text/plain; charset=ISO-8859-1
 240       </code></p></div>
 241
 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>
 245
 246 </div>
 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
 251 charset</td></tr>
 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>
 258 </table>
 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>
 267
 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
 273     </code></p></div>
 274
 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>
 283
 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
 287     them.</p>
 288
 289
 290 <h3>See also</h3>
 291 <ul>
 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>
 294 </ul>
 295 </div>
 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
 300 type</td></tr>
 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>
 307 </table>
 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>
 315
 316     <div class="example"><h3>Example</h3><p><code>
 317       AddEncoding x-gzip .gz<br />
 318       AddEncoding x-compress .Z
 319     </code></p></div>
 320
 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>
 325
 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>
 339
 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
 343     them.</p>
 344
 345 </div>
 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
 350 handler</td></tr>
 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>
 357 </table>
 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
 363     might use:</p>
 364
 365     <div class="example"><p><code>
 366       AddHandler cgi-script .cgi
 367     </code></p></div>
 368
 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>
 371
 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
 375     them.</p>
 376
 377 <h3>See also</h3>
 378 <ul>
 379 <li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li>
 380 </ul>
 381 </div>
 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
 394 later.</td></tr>
 395 </table>
 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>
 403
 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>
 407
 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
 411     them.</p>
 412
 413
 414 <h3>See also</h3>
 415 <ul>
 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>
 418 </ul>
 419 </div>
 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
 424 language</td></tr>
 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>
 431 </table>
 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>
 439
 440     <div class="example"><h3>Example</h3><p><code>
 441       AddEncoding x-compress .Z<br />
 442       AddLanguage en .en<br />
 443       AddLanguage fr .fr
 444     </code></p></div>
 445
 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>
 454
 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>
 458
 459     <div class="example"><p><code>
 460       AddLanguage en .en<br />
 461       AddLanguage en-gb .en<br />
 462       AddLanguage en-us .en
 463     </code></p></div>
 464
 465     <p>documents with the extension <code>.en</code> would be treated as
 466     being <code>en-us</code>.</p>
 467
 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
 471     them.</p>
 472
 473 <h3>See also</h3>
 474 <ul>
 475 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
 476 </ul>
 477 </div>
 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
 490 later.</td></tr>
 491 </table>
 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>
 498
 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>
 502
 503     <div class="example"><p><code>
 504       AddOutputFilter INCLUDES;DEFLATE shtml
 505     </code></p></div>
 506
 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>
 510
 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
 514     them.</p>
 515
 516 <h3>See also</h3>
 517 <ul>
 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>
 520 </ul>
 521 </div>
 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
 526 type</td></tr>
 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>
 533 </table>
 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>
 541
 542     <div class="note">
 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.
 546     </div>
 547
 548     <div class="example"><h3>Example</h3><p><code>
 549       AddType image/gif .gif
 550     </code></p></div>
 551
 552     <p>Or, to specify multiple file extensions in one directive:</p>
 553
 554     <div class="example"><h3>Example</h3><p><code>
 555       AddType image/jpeg jpeg jpg jpe
 556     </code></p></div>
 557
 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
 561     them.</p>
 562
 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
 566     <code>qs</code>:</p>
 567
 568     <div class="example"><h3>Example</h3><p><code>
 569       Addtype application/rss+xml;qs=0.8 .xml
 570     </code></p></div>
 571
 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>
 575
 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>
 580
 581
 582 <h3>See also</h3>
 583 <ul>
 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>
 586 </ul>
 587 </div>
 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>
 599 </table>
 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">&lt;Directory&gt;</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>
 610
 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>
 615
 616     <div class="example"><h3>Example</h3><p><code>
 617       DefaultLanguage en
 618     </code></p></div>
 619
 620 <h3>See also</h3>
 621 <ul>
 622 <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
 623 </ul>
 624 </div>
 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>
 636 </table>
 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>
 642
 643     <p>This directive is recommended when you have a virtual filesystem.</p>
 644
 645     <div class="example"><h3>Example</h3><p><code>
 646       ModMimeUsePathInfo On
 647     </code></p></div>
 648
 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">&lt;Location&gt;</code></p>
 657
 658 <h3>See also</h3>
 659 <ul>
 660 <li><code class="directive"><a href="../mod/core.html#acceptpathinfo">AcceptPathInfo</a></code></li>
 661 </ul>
 662 </div>
 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>
 676 </table>
 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>
 684
 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>
 691
 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>
 701
 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>
 706
 707     <p>For example, the following configuration will allow handlers
 708     and filters to participate in Multviews, but will exclude unknown
 709     files:</p>
 710
 711     <div class="example"><p><code>
 712       MultiviewsMatch Handlers Filters
 713     </code></p></div>
 714
 715     <p><code class="directive">MultiviewsMatch</code> is not allowed in a
 716     <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> or <code class="directive"><a href="../mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code> section.</p>
 717
 718
 719 <h3>See also</h3>
 720 <ul>
 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>
 723 </ul>
 724 </div>
 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
 729 extensions</td></tr>
 730 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveCharset <var>extension</var> [<var>extension</var>]
 731 ...</code></td></tr>
 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
 737 later.</td></tr>
 738 </table>
 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>
 744
 745     <p>The <var>extension</var> argument is case-insensitive and can
 746     be specified with or without a leading dot.</p>
 747
 748     <div class="example"><h3>Example</h3><p><code>
 749       RemoveCharset .html .shtml
 750     </code></p></div>
 751
 752 </div>
 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
 757 extensions</td></tr>
 758 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveEncoding <var>extension</var> [<var>extension</var>]
 759 ...</code></td></tr>
 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>
 764 </table>
 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>
 770
 771     <div class="example"><h3>/foo/.htaccess:</h3><p><code>
 772       AddEncoding x-gzip .gz<br />
 773       AddType text/plain .asc<br />
 774       &lt;Files *.gz.asc&gt;<br />
 775       <span class="indent">
 776         RemoveEncoding .gz<br />
 777       </span>
 778       &lt;/Files&gt;
 779     </code></p></div>
 780
 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>
 784
 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>
 790     </div>
 791
 792     <p>The <var>extension</var> argument is case-insensitive and can
 793     be specified with or without a leading dot.</p>
 794
 795 </div>
 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
 800 extensions</td></tr>
 801 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveHandler <var>extension</var> [<var>extension</var>]
 802 ...</code></td></tr>
 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>
 807 </table>
 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>
 813
 814     <div class="example"><h3>/foo/.htaccess:</h3><p><code>
 815       AddHandler server-parsed .html
 816     </code></p></div>
 817
 818     <div class="example"><h3>/foo/bar/.htaccess:</h3><p><code>
 819       RemoveHandler .html
 820     </code></p></div>
 821
 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>
 825
 826     <p>The <var>extension</var> argument is case-insensitive and can
 827     be specified with or without a leading dot.</p>
 828
 829 </div>
 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
 834 extensions</td></tr>
 835 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveInputFilter <var>extension</var> [<var>extension</var>]
 836 ...</code></td></tr>
 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
 842 later.</td></tr>
 843 </table>
 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>
 850
 851     <p>The <var>extension</var> argument is case-insensitive and can
 852     be specified with or without a leading dot.</p>
 853
 854 <h3>See also</h3>
 855 <ul>
 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>
 858 </ul>
 859 </div>
 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
 864 extensions</td></tr>
 865 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveLanguage <var>extension</var> [<var>extension</var>]
 866 ...</code></td></tr>
 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
 872 later.</td></tr>
 873 </table>
 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>
 879
 880     <p>The <var>extension</var> argument is case-insensitive and can
 881     be specified with or without a leading dot.</p>
 882
 883 </div>
 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
 888 extensions</td></tr>
 889 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveOutputFilter <var>extension</var> [<var>extension</var>]
 890 ...</code></td></tr>
 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
 896 later.</td></tr>
 897 </table>
 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>
 904
 905     <p>The <var>extension</var> argument is case-insensitive and can
 906     be specified with or without a leading dot.</p>
 907
 908     <div class="example"><h3>Example</h3><p><code>
 909       RemoveOutputFilter shtml
 910     </code></p></div>
 911
 912 <h3>See also</h3>
 913 <ul>
 914 <li><code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code></li>
 915 </ul>
 916 </div>
 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
 921 extensions</td></tr>
 922 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveType <var>extension</var> [<var>extension</var>]
 923 ...</code></td></tr>
 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>
 928 </table>
 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
 934     might be:</p>
 935
 936     <div class="example"><h3>/foo/.htaccess:</h3><p><code>
 937       RemoveType .cgi
 938     </code></p></div>
 939
 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>
 944
 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>
 950     </div>
 951
 952     <p>The <var>extension</var> argument is case-insensitive and can
 953     be specified with or without a leading dot.</p>
 954
 955 </div>
 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>
 965 </table>
 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>
 981
 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>
 984
 985     <div class="example"><p><code>
 986       <var>media-type</var> [<var>extension</var>] ...
 987     </code></p></div>
 988
 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>.
 993     </p>
 994
 995     <div class="note">
 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.
1005     </div>
1006
1007 <h3>See also</h3>
1008 <ul>
1009 <li><code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code></li>
1010 </ul>
1011 </div>
1012 </div>
1013 <div class="bottomlang">
1014 <p><span>Available Languages: </span><a href="../en/mod/mod_mime.html" title="English">&nbsp;en&nbsp;</a> |
1015 <a href="../ja/mod/mod_mime.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</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>
1019 </body></html>