mod_mime.html.en revision 3ead9a2285de14ddd10f9d28bef96c37a7c52ba8
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff<?xml version="1.0" encoding="ISO-8859-1"?>
499b34cea04a46823d003d4c0520c8b03e8513cbBrian Wellington<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff This file is generated from xml source: DO NOT EDIT
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence -->
15a44745412679c30a6d022733925af70a38b715David Lawrence<title>mod_mime - Apache HTTP Server</title>
15a44745412679c30a6d022733925af70a38b715David Lawrence<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
15a44745412679c30a6d022733925af70a38b715David Lawrence<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
15a44745412679c30a6d022733925af70a38b715David Lawrence<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
15a44745412679c30a6d022733925af70a38b715David Lawrence<link href="/images/favicon.ico" rel="shortcut icon" /></head>
15a44745412679c30a6d022733925af70a38b715David Lawrence<body>
15a44745412679c30a6d022733925af70a38b715David Lawrence<div id="page-header">
15a44745412679c30a6d022733925af70a38b715David Lawrence<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>
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff<p class="apache">Apache HTTP Server Version 2.1</p>
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff<img alt="" src="/images/feather.gif" /></div>
7b5172166d816efabcdb22519b136ba124bb2619Brian Wellington<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
9c3531d72aeaad6c5f01efe6a1c82023e1379e4dDavid Lawrence<div id="path">
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff<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-project/">Documentation</a> &gt; <a href="../">Version 2.1</a> &gt; <a href="./">Modules</a></div>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff<div id="page-content">
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff<div id="preamble"><h1>Apache Module mod_mime</h1>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff<div class="toplang">
c803787146cadcb2d7e10cbf4491f3be513dfa1aMichael Graff<p><span>Available Languages: </span><a href="/en/mod/mod_mime.html" hreflang="en" title="English">&nbsp;en&nbsp;</a> | <a href="/ja/mod/mod_mime.html" hreflang="ja" title="Japanese">&nbsp;ja&nbsp;</a></p>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff</div>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Associates the requested filename's extensions
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff with the file's behavior (handlers and filters)
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff and content (mime-type, language, character set and
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff encoding)</td></tr>
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Base</td></tr>
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff<tr><th><a href="module-dict.html#ModuleIdentifier">Module�Identifier:</a></th><td>mime_module</td></tr>
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff<tr><th><a href="module-dict.html#SourceFile">Source�File:</a></th><td>mod_mime.c</td></tr></table>
9282e3c21a20f354e22ad3f092aea4956abaea5cMichael Graff<h3>Summary</h3>
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff
9282e3c21a20f354e22ad3f092aea4956abaea5cMichael Graff <p>This module is used to associate various bits of "meta
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff information" with files by their filename extensions. This
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff information relates the filename of the document to it's
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff mime-type, language, character set and encoding. This
058eeac2105c39e7cb31fb75ee0b473717ec3bbcMark Andrews information is sent to the browser, and participates in content
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence negotiation, so the user's preferences are respected when
3024dbecbac365171bc6de0f3fa04951d6558be3Michael Graff choosing one of several possible files to serve. See
5fca48054b5e791a2fa0c5015bc3b6fef4fcdce1Andreas Gustafsson <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code> for more information
f181f94ec8da8b1dbcc6353e8be965ea4a5ea282Michael Graff about <a href="/content-negotiation.html">content negotiation</a>.</p>
6028d1ce0380d0ba7f6c6ecd1ad20b31ddd1becbDavid Lawrence
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence <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
3ac63b472022ff92691d1fe69ac715a729671965Michael Graff extensions onto the meta-information for that file. Respectively
440be4c866f6935ac069db79a414304507a664c2Michael Graff they set the character set, content-encoding, content-language,
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff and MIME-type (content-type) of documents. The directive <code class="directive"><a href="#typesconfig">TypesConfig</a></code> is used to specify a
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley file which also maps extensions onto MIME types. </p>
e45d323a2a0f4ca08d4b139546e60a5fa7bd3f0cMichael Graff
29f28fe573d4b3b318b3b026d567c1eb86738015Michael Graff <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
86944a4c8002e80ae9b6eb5a5e29b797879be45fMichael Graff 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
21e7034ec046105c00a0dab86c83732e2e77ad99Michael Graff or scripts that serve the document. The <code class="directive"><a href="#multiviewsmatch">MultiviewsMatch</a></code> directive allows
e51511aa3281f8dc384eb1283115c7f8d5c402aeMichael Graff <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code> to consider these file extensions
e51511aa3281f8dc384eb1283115c7f8d5c402aeMichael Graff to be included when testing Multiviews matches.</p>
d1cbf714097e900ed1703529584d3e1a50e8a4a8Brian Wellington
11efdeb076d65fa9f0c5fc067dc040e7c99dfba6Michael Graff <p>While <code class="module"><a href="/mod/mod_mime.html">mod_mime</a></code> associates meta-information
09f22ac5b09e70bc526015f37168ba33e21ea91fDavid Lawrence with filename extensions, the <code class="module"><a href="/mod/core.html">core</a></code> server
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff provides directives that are used to associate all the files in a
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff 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
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff meta-information. 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
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff override any filename extension mappings defined in
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff <code class="module"><a href="/mod/mod_mime.html">mod_mime</a></code>.</p>
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff <p>Note that changing the meta-information for a file does not
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff change the value of the <code>Last-Modified</code> header.
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff Thus, previously cached copies may still be used by a client or
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff proxy, with the previous headers. If you change the
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff meta-information (language, content type, character set or
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff encoding) you may need to 'touch' affected files (updating
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff their last modified date) to ensure that all visitors are
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley receive the corrected content headers.</p>
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley</div>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff<div id="quickview"><h3 class="directives">Directives</h3>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff<ul id="toc">
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley<li><img alt="" src="/images/down.gif" /> <a href="#addcharset">AddCharset</a></li>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley<li><img alt="" src="/images/down.gif" /> <a href="#addencoding">AddEncoding</a></li>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley<li><img alt="" src="/images/down.gif" /> <a href="#addhandler">AddHandler</a></li>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff<li><img alt="" src="/images/down.gif" /> <a href="#addinputfilter">AddInputFilter</a></li>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff<li><img alt="" src="/images/down.gif" /> <a href="#addlanguage">AddLanguage</a></li>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff<li><img alt="" src="/images/down.gif" /> <a href="#addoutputfilter">AddOutputFilter</a></li>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff<li><img alt="" src="/images/down.gif" /> <a href="#addtype">AddType</a></li>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff<li><img alt="" src="/images/down.gif" /> <a href="#defaultlanguage">DefaultLanguage</a></li>
d947011dc393d9f9988d1349d585b246d19cc3c7Michael Graff<li><img alt="" src="/images/down.gif" /> <a href="#modmimeusepathinfo">ModMimeUsePathInfo</a></li>
d947011dc393d9f9988d1349d585b246d19cc3c7Michael Graff<li><img alt="" src="/images/down.gif" /> <a href="#multiviewsmatch">MultiviewsMatch</a></li>
d947011dc393d9f9988d1349d585b246d19cc3c7Michael Graff<li><img alt="" src="/images/down.gif" /> <a href="#removecharset">RemoveCharset</a></li>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff<li><img alt="" src="/images/down.gif" /> <a href="#removeencoding">RemoveEncoding</a></li>
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley<li><img alt="" src="/images/down.gif" /> <a href="#removehandler">RemoveHandler</a></li>
a14eb88840e06b8d458c1556e5452b6d2a50012eMichael Graff<li><img alt="" src="/images/down.gif" /> <a href="#removeinputfilter">RemoveInputFilter</a></li>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff<li><img alt="" src="/images/down.gif" /> <a href="#removelanguage">RemoveLanguage</a></li>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley<li><img alt="" src="/images/down.gif" /> <a href="#removeoutputfilter">RemoveOutputFilter</a></li>
7b5172166d816efabcdb22519b136ba124bb2619Brian Wellington<li><img alt="" src="/images/down.gif" /> <a href="#removetype">RemoveType</a></li>
7b5172166d816efabcdb22519b136ba124bb2619Brian Wellington<li><img alt="" src="/images/down.gif" /> <a href="#typesconfig">TypesConfig</a></li>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley</ul>
7b5172166d816efabcdb22519b136ba124bb2619Brian Wellington<h3>Topics</h3>
7b5172166d816efabcdb22519b136ba124bb2619Brian Wellington<ul id="topics">
7b5172166d816efabcdb22519b136ba124bb2619Brian Wellington<li><img alt="" src="/images/down.gif" /> <a href="#multipleext">Files with Multiple Extensions</a></li>
3ac63b472022ff92691d1fe69ac715a729671965Michael Graff<li><img alt="" src="/images/down.gif" /> <a href="#contentencoding">Content encoding</a></li>
acafce24bbc6140464302fb18c729791f1bfddd6Michael Graff<li><img alt="" src="/images/down.gif" /> <a href="#charset-lang">Character sets and languages</a></li>
acafce24bbc6140464302fb18c729791f1bfddd6Michael Graff</ul><h3>See also</h3>
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff<ul class="seealso">
64828244e04e86dfa40f0a4f0c05f27923da499dMichael Graff<li><code class="directive"><a href="/mod/mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></code></li>
64828244e04e86dfa40f0a4f0c05f27923da499dMichael Graff<li><code class="directive"><a href="/mod/core.html#adddefaultcharset">AddDefaultCharset</a></code></li>
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff<li><code class="directive"><a href="/mod/core.html#forcetype">ForceType</a></code></li>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff<li><code class="directive"><a href="/mod/core.html#defaulttype">DefaultType</a></code></li>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff<li><code class="directive"><a href="/mod/core.html#sethandler">SetHandler</a></code></li>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff<li><code class="directive"><a href="/mod/core.html#setinputfilter">SetInputFilter</a></code></li>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff<li><code class="directive"><a href="/mod/core.html#setoutputfilter">SetOutputFilter</a></code></li>
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff</ul></div>
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff<div class="section">
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff<h2><a name="multipleext" id="multipleext">Files with Multiple Extensions</a></h2>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <p>Files can have more than one extension, and the order of the
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff extensions is <em>normally</em> irrelevant. For example, if the
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff file <code>welcome.html.fr</code> maps onto content type
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley <code>text/html</code> and language French then the file
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <code>welcome.fr.html</code> will map onto exactly the same information.
439c0011e642fb1d26011116144af698125262dbMichael Graff If more than one extension is given which maps onto the same
11efdeb076d65fa9f0c5fc067dc040e7c99dfba6Michael Graff type of meta-information, then the one to the right will be
3ac63b472022ff92691d1fe69ac715a729671965Michael Graff used. For example, if <code>.gif</code> maps to the MIME-type
11efdeb076d65fa9f0c5fc067dc040e7c99dfba6Michael Graff <code>image/gif</code> and <code>.html</code> maps to the MIME-type
3ac63b472022ff92691d1fe69ac715a729671965Michael Graff <code>text/html</code>, then the file <code>welcome.gif.html</code>
84c46a7acb961cac19c0d857bfdd00f3383a9bc6Michael Graff will be associated with the MIME-type <code>text/html</code>.</p>
3ac63b472022ff92691d1fe69ac715a729671965Michael Graff
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley <p>Care should be taken when a file with multiple extensions
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff gets associated with both a MIME-type and a handler. This will
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff usually result in the request being by the module associated
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff with the handler. For example, if the <code>.imap</code>
e51511aa3281f8dc384eb1283115c7f8d5c402aeMichael Graff extension is mapped to the handler <code>imap-file</code> (from
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff <code class="module"><a href="/mod/mod_imap.html">mod_imap</a></code>) and the <code>.html</code> extension is
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff mapped to the MIME-type <code>text/html</code>, then the file
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <code>world.imap.html</code> will be associated with both the
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <code>imap-file</code> handler and <code>text/html</code> MIME-type.
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff When it is processed, the <code>imap-file</code> handler will be used,
2992344aacdb08e4af936c176d49ef789f5673ddMichael Graff and so it will be treated as a <code class="module"><a href="/mod/mod_imap.html">mod_imap</a></code> imagemap
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff file.</p>
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley<div class="section">
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff<h2><a name="contentencoding" id="contentencoding">Content encoding</a></h2>
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff <p>A file of a particular MIME type can additionally be encoded a
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff particular way to simplify transmission over the Internet.
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley While this usually will refer to compression, such as
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley <code>gzip</code>, it can also refer to encryption, such a
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff <code>pgp</code> or to an encoding such as UUencoding, which is
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff designed for transmitting a binary file in an ASCII (text)
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff format.</p>
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff <p>The <a href="http://www.ietf.org/rfc/rfc2616.txt">HTTP/1.1
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff RFC</a>, section 14.11 puts it this way:</p>
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff <blockquote cite="http://www.ietf.org/rfc/rfc2616.txt">
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley <p>The Content-Encoding entity-header field is used as a modifier to
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley the media-type. When present, its value indicates what additional
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff content codings have been applied to the entity-body, and thus what
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff decoding mechanisms must be applied in order to obtain the media-type
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff referenced by the Content-Type header field. Content-Encoding is
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley primarily used to allow a document to be compressed without losing
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley the identity of its underlying media type.</p>
59c049874bbef182857c57bd9cca292898921c69Bob Halley </blockquote>
59c049874bbef182857c57bd9cca292898921c69Bob Halley
59c049874bbef182857c57bd9cca292898921c69Bob Halley <p>By using more than one file extension (see <a href="#multipleext">section above about multiple file
59c049874bbef182857c57bd9cca292898921c69Bob Halley extensions</a>), you can indicate that a file is of a
59c049874bbef182857c57bd9cca292898921c69Bob Halley particular <em>type</em>, and also has a particular
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff <em>encoding</em>. </p>
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley <p>For example, you may have a file which is a Microsoft Word
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley document, which is pkzipped to reduce its size. If the
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley <code>.doc</code> extension is associated with the Microsoft
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley Word file type, and the <code>.zip</code> extension is
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff associated with the pkzip file encoding, then the file
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <code>Resume.doc.zip</code>would be known to be a pkzip'ed Word
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff document.</p>
1c3bc66ada38236cc81c41b7174a9f0a872c9ab6Michael Graff
1f90c108282533a23b8362c34bcde4267c1eb4b1Michael Graff <p>Apache sends a <code>Content-encoding</code> header with the
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff resource, in order to tell the client browser about the
ebdd11e84734e28ddd64562e82a7c646a58a04f4Michael Graff encoding method.</p>
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley <div class="example"><p><code>Content-encoding: pkzip</code></p></div>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff<div class="section">
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley<h2><a name="charset-lang" id="charset-lang">Character sets and languages</a></h2>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff <p>In addition to file type and the file encoding,
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff another important piece of information is what language a
59e22acc4f79ff481f7bfa46ef0558957ae53cfcMichael Graff particular document is in, and in what character set the file
59e22acc4f79ff481f7bfa46ef0558957ae53cfcMichael Graff should be displayed. For example, the document might be written
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley in the Vietnamese alphabet, or in Cyrillic, and should be
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff displayed as such. This information, also, is transmitted in
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff HTTP headers.</p>
28ab8277a068f273f0a805a83b4811446cb78a5bBob Halley
d43c2cc7bc4022701f141e299ea8f3fb1d0640c2Michael Graff <p>The character set, language, encoding and mime type are all
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff used in the process of content negotiation (See
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code>) to determine
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff which document to give to the client, when there are
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff alternative documents in more than one character set, language,
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff encoding or mime type. All filename extensions associations
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff created with <code class="directive"><a href="#addcharset">AddCharset</a></code>,
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff <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
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff (and extensions listed in the <code class="directive"><a href="/mod/mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></code>) participate in this select process.
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff 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
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff from matching by using the <code class="directive"><a href="#multiviewsmatch">MultiviewsMatch</a></code> directive.</p>
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley <h3><a name="charset" id="charset">Charset</a></h3>
14b98cb34eda66c87ce41a207704a2c232280eafMichael Graff <p>To convey this further information, Apache optionally sends
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley a <code>Content-Language</code> header, to specify the language
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley that the document is in, and can append additional information
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley onto the <code>Content-Type</code> header to indicate the
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley particular character set that should be used to correctly
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley render the information.</p>
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley <div class="example"><p><code>
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley Content-Language: en, fr<br />
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff Content-Type: text/plain; charset=ISO-8859-1
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff </code></p></div>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <p>The language specification is the two-letter abbreviation
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff for the language. The <code>charset</code> is the name of the
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff particular character set which should be used.</p>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff</div>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff<div class="directive-section"><h2><a name="AddCharset" id="AddCharset">AddCharset</a> <a name="addcharset" id="addcharset">Directive</a></h2>
d43c2cc7bc4022701f141e299ea8f3fb1d0640c2Michael Graff<table class="directive">
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions to the specified content
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graffcharset</td></tr>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddCharset <var>charset</var> <var>extension</var>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff[<var>extension</var>] ...</code></td></tr>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff</table>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <p>The <code class="directive">AddCharset</code> directive maps the given
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff filename extensions to the specified content charset. <var>charset</var>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff is the MIME charset parameter of filenames containing
439c0011e642fb1d26011116144af698125262dbMichael Graff <var>extension</var>. This mapping is added to any already in force,
d8590892d10fc9528b0dde7e2781935e7b8d7a87Michael Graff overriding any mappings that already exist for the same
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <var>extension</var>.</p>
d43c2cc7bc4022701f141e299ea8f3fb1d0640c2Michael Graff
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <div class="example"><h3>Example</h3><p><code>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff AddLanguage ja .ja<br />
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff AddCharset EUC-JP .euc<br />
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff AddCharset ISO-2022-JP .jis<br />
57ecc983c0b37ce7dbccf28f44c6bffdfd6491f7Andreas Gustafsson AddCharset SHIFT_JIS .sjis
57ecc983c0b37ce7dbccf28f44c6bffdfd6491f7Andreas Gustafsson </code></p></div>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff <p>Then the document <code>xxxx.ja.jis</code> will be treated
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff as being a Japanese document whose charset is <code>ISO-2022-JP</code>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff (as will the document <code>xxxx.jis.ja</code>). The
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff <code class="directive">AddCharset</code> directive is useful for both to
439c0011e642fb1d26011116144af698125262dbMichael Graff inform the client about the character encoding of the document so that
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff the document can be interpreted and displayed appropriately, and for <a href="/content-negotiation.html">content negotiation</a>,
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff where the server returns one from several documents based on
f181f94ec8da8b1dbcc6353e8be965ea4a5ea282Michael Graff the client's charset preference.</p>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <p>The <var>extension</var> argument is case-insensitive, and can
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley be specified with or without a leading dot.</p>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff<h3>See also</h3>
d43c2cc7bc4022701f141e299ea8f3fb1d0640c2Michael Graff<ul>
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff<li><code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code></li>
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff<li><code class="directive"><a href="/mod/core.html#adddefaultcharset">AddDefaultCharset</a></code></li>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff</ul>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff</div>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
d8590892d10fc9528b0dde7e2781935e7b8d7a87Michael Graff<div class="directive-section"><h2><a name="AddEncoding" id="AddEncoding">AddEncoding</a> <a name="addencoding" id="addencoding">Directive</a></h2>
439c0011e642fb1d26011116144af698125262dbMichael Graff<table class="directive">
439c0011e642fb1d26011116144af698125262dbMichael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions to the specified encoding
439c0011e642fb1d26011116144af698125262dbMichael Grafftype</td></tr>
439c0011e642fb1d26011116144af698125262dbMichael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddEncoding <var>MIME-enc</var> <var>extension</var>
f36a81c88493985ee2d1c53cc6fe88f4b00dbbc8Michael Graff[<var>extension</var>] ...</code></td></tr>
439c0011e642fb1d26011116144af698125262dbMichael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
439c0011e642fb1d26011116144af698125262dbMichael Graff<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
439c0011e642fb1d26011116144af698125262dbMichael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
c803787146cadcb2d7e10cbf4491f3be513dfa1aMichael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
c803787146cadcb2d7e10cbf4491f3be513dfa1aMichael Graff</table>
d98c74e2ec5b96bd22aa4ed6d893e8993787493bMichael Graff <p>The <code class="directive">AddEncoding</code> directive maps the given
d98c74e2ec5b96bd22aa4ed6d893e8993787493bMichael Graff filename extensions to the specified encoding type. <var>MIME-enc</var>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff is the MIME encoding to use for documents containing the
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff <var>extension</var>. This mapping is added to any already in force,
e883738546c7c73b761bce8a15e08661863d3ae1Michael Graff overriding any mappings that already exist for the same
e883738546c7c73b761bce8a15e08661863d3ae1Michael Graff <var>extension</var>.</p>
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley
439c0011e642fb1d26011116144af698125262dbMichael Graff <div class="example"><h3>Example</h3><p><code>
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff AddEncoding x-gzip .gz<br />
439c0011e642fb1d26011116144af698125262dbMichael Graff AddEncoding x-compress .Z
439c0011e642fb1d26011116144af698125262dbMichael Graff </code></p></div>
5fca48054b5e791a2fa0c5015bc3b6fef4fcdce1Andreas Gustafsson
439c0011e642fb1d26011116144af698125262dbMichael Graff <p>This will cause filenames containing the <code>.gz</code> extension
5fca48054b5e791a2fa0c5015bc3b6fef4fcdce1Andreas Gustafsson to be marked as encoded using the <code>x-gzip</code> encoding, and
5fca48054b5e791a2fa0c5015bc3b6fef4fcdce1Andreas Gustafsson filenames containing the <code>.Z</code> extension to be marked as
d5874af5a577963aad13f21ec8c7cc9c7c8b880cAndreas Gustafsson encoded with <code>x-compress</code>.</p>
c803787146cadcb2d7e10cbf4491f3be513dfa1aMichael Graff
1c3bc66ada38236cc81c41b7174a9f0a872c9ab6Michael Graff <p>Old clients expect <code>x-gzip</code> and <code>x-compress</code>,
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley however the standard dictates that they're equivalent to
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff <code>gzip</code> and <code>compress</code> respectively. Apache does
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff content encoding comparisons by ignoring any leading <code>x-</code>.
439c0011e642fb1d26011116144af698125262dbMichael Graff When responding with an encoding Apache will use whatever form
439c0011e642fb1d26011116144af698125262dbMichael Graff (<em>i.e.</em>, <code>x-foo</code> or <code>foo</code>) the
439c0011e642fb1d26011116144af698125262dbMichael Graff client requested. If the client didn't specifically request a
439c0011e642fb1d26011116144af698125262dbMichael Graff particular form Apache will use the form given by the
d8590892d10fc9528b0dde7e2781935e7b8d7a87Michael Graff <code>AddEncoding</code> directive. To make this long story
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff short, you should always use <code>x-gzip</code> and
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley <code>x-compress</code> for these two specific encodings. More
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff recent encodings, such as <code>deflate</code> should be
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff specified without the <code>x-</code>.</p>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff
4abed3e3563c7ad346178433130e6d150d3ffeafBob Halley <p>The <var>extension</var> argument is case-insensitive, and can
14b98cb34eda66c87ce41a207704a2c232280eafMichael Graff be specified with or without a leading dot.</p>
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley</div>
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff<div class="directive-section"><h2><a name="AddHandler" id="AddHandler">AddHandler</a> <a name="addhandler" id="addhandler">Directive</a></h2>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<table class="directive">
3ac63b472022ff92691d1fe69ac715a729671965Michael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the filename extensions to the specified
651228967966ba4fb2e52f92d1207c790af4b130Michael Graffhandler</td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddHandler <var>handler-name</var> <var>extension</var>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley[<var>extension</var>] ...</code></td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
e883738546c7c73b761bce8a15e08661863d3ae1Michael Graff</table>
e883738546c7c73b761bce8a15e08661863d3ae1Michael Graff <p>Files having the name <var>extension</var> will be served by the
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff specified <var><a href="/handler.html">handler-name</a></var>. This
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff mapping is added to any already in force, overriding any mappings that
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff already exist for the same <var>extension</var>. For example, to
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff activate CGI scripts with the file extension <code>.cgi</code>, you
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff might use:</p>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff <div class="example"><p><code>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff AddHandler cgi-script .cgi
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff </code></p></div>
897c9ddb4d745b2bfecf98b17e5487bb6656299aMichael Graff
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff <p>Once that has been put into your httpd.conf file, any file containing
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff the <code>.cgi</code> extension will be treated as a CGI program.</p>
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff <p>The <var>extension</var> argument is case-insensitive, and can
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff be specified with or without a leading dot.</p>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff<h3>See also</h3>
c6715d23151ab9948c7191b1ed1b99a14e6def7dDavid Lawrence<ul>
14b98cb34eda66c87ce41a207704a2c232280eafMichael Graff<li><code class="directive"><a href="/mod/core.html#sethandler">SetHandler</a></code></li>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff</ul>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff</div>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<div class="directive-section"><h2><a name="AddInputFilter" id="AddInputFilter">AddInputFilter</a> <a name="addinputfilter" id="addinputfilter">Directive</a></h2>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<table class="directive">
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps filename extensions to the filters that will process
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graffclient requests</td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddInputFilter <var>filter</var>[;<var>filter</var>...]
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<var>extension</var> [<var>extension</var>] ...</code></td></tr>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
517274e709a3c730cd42f37dc1260dde95d1ea38Michael Graff<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>AddInputFilter is only available in Apache 2.0.26 and
517274e709a3c730cd42f37dc1260dde95d1ea38Michael Grafflater.</td></tr>
517274e709a3c730cd42f37dc1260dde95d1ea38Michael Graff</table>
517274e709a3c730cd42f37dc1260dde95d1ea38Michael Graff <p><code class="directive">AddInputFilter</code> maps the filename extension
517274e709a3c730cd42f37dc1260dde95d1ea38Michael Graff <var>extension</var> to the <a href="/filter.html">filters</a> which
517274e709a3c730cd42f37dc1260dde95d1ea38Michael Graff will process client requests and POST input when they are received by
59e22acc4f79ff481f7bfa46ef0558957ae53cfcMichael Graff the server. This is in addition to any filters defined elsewhere,
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff including the <code class="directive"><a href="/mod/core.html#setinputfilter">SetInputFilter</a></code>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff directive. This mapping is merged over any already in force, overriding
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff any mappings that already exist for the same <var>extension</var>.</p>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff <p>If more than one filter is specified, they must be separated
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff by semicolons in the order in which they should process the
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff content. Both the filter and <var>extension</var> arguments are
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff case-insensitive, and the extension may be specified with or
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff without a leading dot.</p>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<h3>See also</h3>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<ul>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<li><code class="directive"><a href="#removeinputfilter">RemoveInputFilter</a></code></li>
4a3ad0da975d7115d401700f955814a0dff1adb0Bob Halley<li><code class="directive"><a href="/mod/core.html#setinputfilter">SetInputFilter</a></code></li>
4a3ad0da975d7115d401700f955814a0dff1adb0Bob Halley</ul>
24a2d84aedbad12fba2ca319c98745e62ef0bc16Bob Halley</div>
24a2d84aedbad12fba2ca319c98745e62ef0bc16Bob Halley<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff<div class="directive-section"><h2><a name="AddLanguage" id="AddLanguage">AddLanguage</a> <a name="addlanguage" id="addlanguage">Directive</a></h2>
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff<table class="directive">
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extension to the specified content
ffd9f879709c5fb35f25368e74e2e12eb6881d9bMichael Grafflanguage</td></tr>
4a3ad0da975d7115d401700f955814a0dff1adb0Bob Halley<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddLanguage <var>MIME-lang</var> <var>extension</var>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff[<var>extension</var>] ...</code></td></tr>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff</table>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff <p>The <code class="directive">AddLanguage</code> directive maps the given
3d12fa7e76c02d06e1adeaa7846b60378a3cd204Michael Graff filename extension to the specified content language.
3d12fa7e76c02d06e1adeaa7846b60378a3cd204Michael Graff <var>MIME-lang</var> is the MIME language of filenames containing
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff <var>extension</var>. This mapping is added to any already in force,
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff overriding any mappings that already exist for the same
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff <var>extension</var>.</p>
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff <div class="example"><h3>Example</h3><p><code>
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff AddEncoding x-compress .Z<br />
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff AddLanguage en .en<br />
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff AddLanguage fr .fr
1a0e33bc2044e1902493111db14cbf793083ac47Michael Graff </code></p></div>
78854e02c127f31ab90f56da0531542004b45377Michael Graff
78854e02c127f31ab90f56da0531542004b45377Michael Graff <p>Then the document <code>xxxx.en.Z</code> will be treated as
78854e02c127f31ab90f56da0531542004b45377Michael Graff being a compressed English document (as will the document
78854e02c127f31ab90f56da0531542004b45377Michael Graff <code>xxxx.Z.en</code>). Although the content language is
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff reported to the client, the browser is unlikely to use this
78854e02c127f31ab90f56da0531542004b45377Michael Graff information. The <code class="directive">AddLanguage</code> directive is
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff more useful for <a href="/content-negotiation.html">content
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff negotiation</a>, where the server returns one from several documents
daf83a29374c487a2800333d371e98e77e5a0d64Bob Halley based on the client's language preference.</p>
daf83a29374c487a2800333d371e98e77e5a0d64Bob Halley
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff <p>If multiple language assignments are made for the same
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff extension, the last one encountered is the one that is used.
e1db5e817f89b1b9ec7dab366f1bfe1c7b299438Michael Graff That is, for the case of:</p>
58cbc05eb0b80510182496ad905cd407f3624dbeBrian Wellington
58cbc05eb0b80510182496ad905cd407f3624dbeBrian Wellington <div class="example"><p><code>
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff AddLanguage en .en<br />
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff AddLanguage en-uk .en<br />
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff AddLanguage en-us .en
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff </code></p></div>
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff <p>documents with the extension <code>.en</code> would be treated as
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff being <code>en-us</code>.</p>
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff <p>The <var>extension</var> argument is case-insensitive, and can
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff be specified with or without a leading dot.</p>
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff<h3>See also</h3>
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff<ul>
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff<li><code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code></li>
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff</ul>
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff</div>
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff<div class="directive-section"><h2><a name="AddOutputFilter" id="AddOutputFilter">AddOutputFilter</a> <a name="addoutputfilter" id="addoutputfilter">Directive</a></h2>
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff<table class="directive">
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps filename extensions to the filters that will process
306a93530536f05edfb477cac1c2667d90129a8fMichael Graffresponses from the server</td></tr>
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddOutputFilter <var>filter</var>[;<var>filter</var>...]
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff<var>extension</var> [<var>extension</var>] ...</code></td></tr>
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
306a93530536f05edfb477cac1c2667d90129a8fMichael Graff<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
21e7034ec046105c00a0dab86c83732e2e77ad99Michael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
6d12fdf96621801e80f3f4c2a8a569fe48766a20David Lawrence<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>AddOutputFilter is only available in Apache 2.0.26 and
21e7034ec046105c00a0dab86c83732e2e77ad99Michael Grafflater.</td></tr>
21e7034ec046105c00a0dab86c83732e2e77ad99Michael Graff</table>
21e7034ec046105c00a0dab86c83732e2e77ad99Michael Graff <p>The <code class="directive">AddOutputFilter</code> directive maps the
21e7034ec046105c00a0dab86c83732e2e77ad99Michael Graff filename extension <var>extension</var> to the <a href="/filter.html">filters</a> which will process responses
21e7034ec046105c00a0dab86c83732e2e77ad99Michael Graff from the server before they are sent to the client. This is in
21e7034ec046105c00a0dab86c83732e2e77ad99Michael Graff 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
21e7034ec046105c00a0dab86c83732e2e77ad99Michael Graff over any already in force, overriding any mappings that already exist
21e7034ec046105c00a0dab86c83732e2e77ad99Michael Graff for the same <var>extension</var>.</p>
21e7034ec046105c00a0dab86c83732e2e77ad99Michael Graff
a14eb88840e06b8d458c1556e5452b6d2a50012eMichael Graff <p>For example, the following configuration will process all
a14eb88840e06b8d458c1556e5452b6d2a50012eMichael Graff <code>.shtml</code> files for server-side includes and will then
a14eb88840e06b8d458c1556e5452b6d2a50012eMichael Graff compress the output using <code class="module"><a href="/mod/mod_deflate.html">mod_deflate</a></code>.</p>
a14eb88840e06b8d458c1556e5452b6d2a50012eMichael Graff
a14eb88840e06b8d458c1556e5452b6d2a50012eMichael Graff <div class="example"><p><code>
a14eb88840e06b8d458c1556e5452b6d2a50012eMichael Graff AddOutputFilter INCLUDES;DEFLATE shtml
a14eb88840e06b8d458c1556e5452b6d2a50012eMichael Graff </code></p></div>
a14eb88840e06b8d458c1556e5452b6d2a50012eMichael Graff
a14eb88840e06b8d458c1556e5452b6d2a50012eMichael Graff <p>If more than one filter is specified, they must be separated
a14eb88840e06b8d458c1556e5452b6d2a50012eMichael Graff by semicolons in the order in which they should process the
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff content. Both the <var>filter</var> and <var>extension</var> arguments
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff are case-insensitive, and the extension may be specified with or
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff without a leading dot.</p>
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff<h3>See also</h3>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff<ul>
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff<li><code class="directive"><a href="#removeoutputfilter">RemoveOutputFilter</a></code></li>
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff<li><code class="directive"><a href="/mod/core.html#setoutputfilter">SetOutputFilter</a></code></li>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff</ul>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff</div>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff<div class="directive-section"><h2><a name="AddType" id="AddType">AddType</a> <a name="addtype" id="addtype">Directive</a></h2>
c03bb27f0675a6e60ceea66b451548e8481bc05cMark Andrews<table class="directive">
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions onto the specified content
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Grafftype</td></tr>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddType <var>MIME-type</var> <var>extension</var>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff[<var>extension</var>] ...</code></td></tr>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
59e22acc4f79ff481f7bfa46ef0558957ae53cfcMichael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff</table>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff <p>The <code class="directive">AddType</code> directive maps the given filename
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff extensions onto the specified content type. <var>MIME-type</var> is the
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff MIME type to use for filenames containing <var>extension</var>. This
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff mapping is added to any already in force, overriding any mappings that
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff already exist for the same <var>extension</var>. This directive can
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff be used to add mappings not listed in the MIME types file (see the
59e22acc4f79ff481f7bfa46ef0558957ae53cfcMichael Graff <code class="directive"><a href="#typesconfig">TypesConfig</a></code> directive).</p>
59e22acc4f79ff481f7bfa46ef0558957ae53cfcMichael Graff
f6f4ceece41f040cc43722afa9a5cd1f54a576b6Michael Graff <div class="example"><h3>Example</h3><p><code>
59e22acc4f79ff481f7bfa46ef0558957ae53cfcMichael Graff AddType image/gif .gif
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff </code></p></div>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff <div class="note">
59e22acc4f79ff481f7bfa46ef0558957ae53cfcMichael Graff It is recommended that new MIME types be added using the
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff <code class="directive">AddType</code> directive rather than changing the
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff <code class="directive"><a href="#typesconfig">TypesConfig</a></code> file.
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff </div>
368b37b616234fce3d23099eb180f1dd38e1fb62Mark Andrews
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff <p>The <var>extension</var> argument is case-insensitive, and can
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff be specified with or without a leading dot.</p>
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff<h3>See also</h3>
d98c74e2ec5b96bd22aa4ed6d893e8993787493bMichael Graff<ul>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff<li><code class="directive"><a href="/mod/core.html#defaulttype">DefaultType</a></code></li>
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff<li><code class="directive"><a href="/mod/core.html#forcetype">ForceType</a></code></li>
01883602b1e9c0a91f1c3526d80d8ef9db747e92Mark Andrews</ul>
d98c74e2ec5b96bd22aa4ed6d893e8993787493bMichael Graff</div>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff<div class="directive-section"><h2><a name="DefaultLanguage" id="DefaultLanguage">DefaultLanguage</a> <a name="defaultlanguage" id="defaultlanguage">Directive</a></h2>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff<table class="directive">
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets all files in the given scope to the specified
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Grafflanguage</td></tr>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultLanguage <var>MIME-lang</var></code></td></tr>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff</table>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff <p>The <code class="directive">DefaultLanguage</code> directive tells Apache
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff that all files in the directive's scope (<em>e.g.</em>, all files
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff 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
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff extension (such as <code>.fr</code> or <code>.de</code> as configured
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff by <code class="directive"><a href="#addlanguage">AddLanguage</a></code>) should be
59e22acc4f79ff481f7bfa46ef0558957ae53cfcMichael Graff considered to be in the specified <var>MIME-lang</var> language. This
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff allows entire directories to be marked as containing Dutch content, for
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff instance, without having to rename each file. Note that unlike using
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff extensions to specify languages, <code class="directive">DefaultLanguage</code>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff can only specify a single language.</p>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff <p>If no <code class="directive">DefaultLanguage</code> directive is in force,
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff and a file does not have any language extensions as configured
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff by <code class="directive"><a href="#addlanguage">AddLanguage</a></code>, then that file
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff will be considered to have no language attribute.</p>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff <div class="example"><h3>Example</h3><p><code>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff DefaultLanguage en
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff </code></p></div>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff<h3>See also</h3>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff<ul>
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff<li><code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code></li>
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff</ul>
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff</div>
d1fb73ada84ee15ea078c80b1cd0ca8ddc6aa856Michael Graff<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff<div class="directive-section"><h2><a name="ModMimeUsePathInfo" id="ModMimeUsePathInfo">ModMimeUsePathInfo</a> <a name="modmimeusepathinfo" id="modmimeusepathinfo">Directive</a></h2>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff<table class="directive">
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tells mod_mime to treat path_info
528829aa8ad69238e674cd81078bc14d4199691bMichael Graffcomponents as part of the filename</td></tr>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ModMimeUsePathInfo On|Off</code></td></tr>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ModMimeUsePathInfo Off</code></td></tr>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory</td></tr>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.41 and later</td></tr>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff</table>
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff <p>The <code class="directive">ModMimeUsePathInfo</code> directive is used to
a14eb88840e06b8d458c1556e5452b6d2a50012eMichael Graff combine the filename with the <code>path_info</code> URL component to
d947011dc393d9f9988d1349d585b246d19cc3c7Michael Graff apply <code class="module"><a href="/mod/mod_mime.html">mod_mime</a></code>'s directives to the request. The default
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff value is <code>Off</code> - therefore, the <code>path_info</code>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff component is ignored.</p>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff <p>This directive is recommended when you have a virtual filesystem.</p>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff <div class="example"><h3>Example</h3><p><code>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff ModMimeUsePathInfo On
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff </code></p></div>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff <p>If you have a request for <code>/bar/foo.shtml</code> where
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff <code>/bar</code> is a Location and <code class="directive">ModMimeUsePathInfo</code> is <code>On</code>,
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff <code class="module"><a href="/mod/mod_mime.html">mod_mime</a></code> will treat the incoming request as
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff <code>/bar/foo.shtml</code> and directives like <code>AddOutputFilter
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff INCLUDES .shtml</code> will add the <code>INCLUDES</code> filter to the
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff request. If <code class="directive">ModMimeUsePathInfo</code> is not set, the
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff <code>INCLUDES</code> filter will not be added.</p>
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff
528829aa8ad69238e674cd81078bc14d4199691bMichael Graff<h3>See also</h3>
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff<ul>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff<li><code class="directive"><a href="/mod/core.html#acceptpathinfo">AcceptPathInfo</a></code></li>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff</ul>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff</div>
2bcb48cfcae36398454c98e40c563e2cde748e07Michael Graff<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<div class="directive-section"><h2><a name="MultiviewsMatch" id="MultiviewsMatch">MultiviewsMatch</a> <a name="multiviewsmatch" id="multiviewsmatch">Directive</a></h2>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence<table class="directive">
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The types of files that will be included when searching for
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graffa matching file with MultiViews</td></tr>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff[Handlers|Filters]</code></td></tr>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MultiviewsMatch NegotiatedOnly</code></td></tr>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
59c049874bbef182857c57bd9cca292898921c69Bob Halley<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.26 and later.</td></tr>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff</table>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff <p><code class="directive">MultiviewsMatch</code> permits three different
1ac7292ced16b8469bebf04356d50279eae78d97Bob Halley behaviors for <a href="mod_negotiation.html">mod_negotiation</a>'s
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff Multiviews feature. Multiviews allows a request for a file,
78854e02c127f31ab90f56da0531542004b45377Michael Graff <em>e.g.</em> <code>index.html</code>, to match any negotiated
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence extensions following the base request, <em>e.g.</em>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff <code>index.html.en</code>, <code>index.html.fr</code>, or
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff <code>index.html.gz</code>.</p>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff <p>The <code>NegotiatedOnly</code> option provides that every extension
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff following the base name must correlate to a recognized
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff <code class="module"><a href="/mod/mod_mime.html">mod_mime</a></code> extension for content negotation, <em>e.g.</em>
d98c74e2ec5b96bd22aa4ed6d893e8993787493bMichael Graff Charset, Content-Type, Language, or Encoding. This is the strictest
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff implementation with the fewest unexpected side effects, and is the
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff default behavior.</p>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff <p>To include extensions associated with Handlers and/or Filters,
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff set the <code class="directive">MultiviewsMatch</code> directive to either
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff <code>Handlers</code>, <code>Filters</code>, or both option keywords.
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff If all other factors are equal, the smallest file will be served,
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff <em>e.g.</em> in deciding between <code>index.html.cgi</code> of 500
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff bytes and <code>index.html.pl</code> of 1000 bytes, the <code>.cgi</code>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff file would win in this example. Users of <code>.asis</code> files
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff might prefer to use the Handler option, if <code>.asis</code> files are
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff associated with the <code>asis-handler</code>.</p>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley <p>You may finally allow <code>Any</code> extensions to match, even if
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff <code class="module"><a href="/mod/mod_mime.html">mod_mime</a></code> doesn't recognize the extension. This was the
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff behavior in Apache 1.3, and can cause unpredicatable results, such as
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff serving .old or .bak files the webmaster never expected to be served.</p>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff <p>For example, the following configuration will allow handlers
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff and filters to participate in Multviews, but will exclude unknown
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff files:</p>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff <div class="example"><p><code>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff MultiviewsMatch Handlers Filters
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley </code></p></div>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley<h3>See also</h3>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley<ul>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley<li><code class="directive"><a href="/mod/core.html#options">Options</a></code></li>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<li><code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code></li>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff</ul>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff</div>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<div class="directive-section"><h2><a name="RemoveCharset" id="RemoveCharset">RemoveCharset</a> <a name="removecharset" id="removecharset">Directive</a></h2>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<table class="directive">
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any character set associations for a set of file
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graffextensions</td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveCharset <var>extension</var> [<var>extension</var>]
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff...</code></td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveCharset is only available in Apache 2.0.24 and
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Grafflater.</td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff</table>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff <p>The <code class="directive">RemoveCharset</code> directive removes any
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff character set associations for files with the given extensions.
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff This allows <code>.htaccess</code> files in subdirectories to
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff undo any associations inherited from parent directories or the
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff server config files.</p>
78854e02c127f31ab90f56da0531542004b45377Michael Graff
1c3bc66ada38236cc81c41b7174a9f0a872c9ab6Michael Graff <p>The <var>extension</var> argument is case-insensitive, and can
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff be specified with or without a leading dot.</p>
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff <div class="example"><h3>Example</h3><p><code>
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff RemoveCharset .html .shtml
517274e709a3c730cd42f37dc1260dde95d1ea38Michael Graff </code></p></div>
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff</div>
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff<div class="directive-section"><h2><a name="RemoveEncoding" id="RemoveEncoding">RemoveEncoding</a> <a name="removeencoding" id="removeencoding">Directive</a></h2>
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff<table class="directive">
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any content encoding associations for a set of file
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graffextensions</td></tr>
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveEncoding <var>extension</var> [<var>extension</var>]
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff...</code></td></tr>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff</table>
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff <p>The <code class="directive">RemoveEncoding</code> directive removes any
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff encoding associations for files with the given extensions. This
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff allows <code>.htaccess</code> files in subdirectories to undo
7ec42e4be45c0486ce80461293f377fb4b904dc0Michael Graff any associations inherited from parent directories or the
517274e709a3c730cd42f37dc1260dde95d1ea38Michael Graff server config files. An example of its use might be:</p>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff <div class="example"><h3>/foo/.htaccess:</h3><p><code>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff AddEncoding x-gzip .gz<br />
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff AddType text/plain .asc<br />
4abed3e3563c7ad346178433130e6d150d3ffeafBob Halley &lt;Files *.gz.asc&gt;<br />
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff <span class="indent">
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff RemoveEncoding .gz<br />
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff </span>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff &lt;/Files&gt;
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff </code></p></div>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff <p>This will cause <code>foo.gz</code> to be marked as being
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence encoded with the gzip method, but <code>foo.gz.asc</code> as an
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff unencoded plaintext file.</p>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff <div class="note"><h3>Note</h3>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff <p><code class="directive">RemoveEncoding</code> directives are processed
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff <em>after</em> any <code class="directive"><a href="#addencoding">AddEncoding</a></code>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff directives, so it is possible they may undo the effects of the latter
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff if both occur within the same directory configuration.</p>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff </div>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff
3d12fa7e76c02d06e1adeaa7846b60378a3cd204Michael Graff <p>The <var>extension</var> argument is case-insensitive, and can
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff be specified with or without a leading dot.</p>
93d3a6fd20aceb9998eca4723bba8810243e7689Michael Graff
93d3a6fd20aceb9998eca4723bba8810243e7689Michael Graff</div>
f788a5704623c1d686b770a0f014fd52834d4a67Michael Graff<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
93d3a6fd20aceb9998eca4723bba8810243e7689Michael Graff<div class="directive-section"><h2><a name="RemoveHandler" id="RemoveHandler">RemoveHandler</a> <a name="removehandler" id="removehandler">Directive</a></h2>
3d12fa7e76c02d06e1adeaa7846b60378a3cd204Michael Graff<table class="directive">
59e22acc4f79ff481f7bfa46ef0558957ae53cfcMichael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any handler associations for a set of file
59e22acc4f79ff481f7bfa46ef0558957ae53cfcMichael Graffextensions</td></tr>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveHandler <var>extension</var> [<var>extension</var>]
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff...</code></td></tr>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
3d12fa7e76c02d06e1adeaa7846b60378a3cd204Michael Graff<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
65f6d2e1c1fce0989c13c2efb44b8dd26cd977f3Michael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
93d3a6fd20aceb9998eca4723bba8810243e7689Michael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
93d3a6fd20aceb9998eca4723bba8810243e7689Michael Graff</table>
f788a5704623c1d686b770a0f014fd52834d4a67Michael Graff <p>The <code class="directive">RemoveHandler</code> directive removes any
93d3a6fd20aceb9998eca4723bba8810243e7689Michael Graff handler associations for files with the given extensions. This allows
3d12fa7e76c02d06e1adeaa7846b60378a3cd204Michael Graff <code>.htaccess</code> files in subdirectories to undo any
59e22acc4f79ff481f7bfa46ef0558957ae53cfcMichael Graff associations inherited from parent directories or the server
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley config files. An example of its use might be:</p>
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley <div class="example"><h3>/foo/.htaccess:</h3><p><code>
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley AddHandler server-parsed .html
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley </code></p></div>
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley <div class="example"><h3>/foo/bar/.htaccess:</h3><p><code>
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley RemoveHandler .html
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff </code></p></div>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff <p>This has the effect of returning <code>.html</code> files in
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff the <code>/foo/bar</code> directory to being treated as normal
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff files, rather than as candidates for parsing (see the <code class="module"><a href="/mod/mod_include.html">mod_include</a></code> module).</p>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence <p>The <var>extension</var> argument is case-insensitive, and can
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff be specified with or without a leading dot.</p>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff
d43c2cc7bc4022701f141e299ea8f3fb1d0640c2Michael Graff</div>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<div class="directive-section"><h2><a name="RemoveInputFilter" id="RemoveInputFilter">RemoveInputFilter</a> <a name="removeinputfilter" id="removeinputfilter">Directive</a></h2>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<table class="directive">
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any input filter associations for a set of file
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graffextensions</td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveInputFilter <var>extension</var> [<var>extension</var>]
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff...</code></td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveInputFilter is only available in Apache 2.0.26 and
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Grafflater.</td></tr>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff</table>
d43c2cc7bc4022701f141e299ea8f3fb1d0640c2Michael Graff <p>The <code class="directive">RemoveInputFilter</code> directive removes any
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff input filter associations for files with the given extensions.
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff This allows <code>.htaccess</code> files in subdirectories to
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff undo any associations inherited from parent directories or the
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley server config files.</p>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff <p>The <var>extension</var> argument is case-insensitive, and can
a385f150bb21b8b81f70ed7df545357a83f1da82Michael Graff be specified with or without a leading dot.</p>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<h3>See also</h3>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<ul>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<li><code class="directive"><a href="#addinputfilter">AddInputFilter</a></code></li>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence<li><code class="directive"><a href="/mod/core.html#setinputfilter">SetInputFilter</a></code></li>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley</ul>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley</div>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<div class="directive-section"><h2><a name="RemoveLanguage" id="RemoveLanguage">RemoveLanguage</a> <a name="removelanguage" id="removelanguage">Directive</a></h2>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<table class="directive">
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any language associations for a set of file
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halleyextensions</td></tr>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveLanguage <var>extension</var> [<var>extension</var>]
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley...</code></td></tr>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveLanguage is only available in Apache 2.0.24 and
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halleylater.</td></tr>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley</table>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley <p>The <code class="directive">RemoveLanguage</code> directive removes any
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley language associations for files with the given extensions. This
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley allows <code>.htaccess</code> files in subdirectories to undo
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley any associations inherited from parent directories or the
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley server config files.</p>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley <p>The <var>extension</var> argument is case-insensitive, and can
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff be specified with or without a leading dot.</p>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff</div>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<div class="directive-section"><h2><a name="RemoveOutputFilter" id="RemoveOutputFilter">RemoveOutputFilter</a> <a name="removeoutputfilter" id="removeoutputfilter">Directive</a></h2>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<table class="directive">
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any output filter associations for a set of file
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graffextensions</td></tr>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveOutputFilter <var>extension</var> [<var>extension</var>]
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff...</code></td></tr>
a385f150bb21b8b81f70ed7df545357a83f1da82Michael Graff<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
a385f150bb21b8b81f70ed7df545357a83f1da82Michael Graff<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveOutputFilter is only available in Apache 2.0.26 and
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Grafflater.</td></tr>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff</table>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff <p>The <code class="directive">RemoveOutputFilter</code> directive removes any
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff output filter associations for files with the given extensions.
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff This allows <code>.htaccess</code> files in subdirectories to
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff undo any associations inherited from parent directories or the
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff server config files.</p>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff <p>The <var>extension</var> argument is case-insensitive, and can
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley be specified with or without a leading dot.</p>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley <div class="example"><h3>Example</h3><p><code>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley RemoveOutputFilter shtml
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley </code></p></div>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<h3>See also</h3>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<ul>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<li><code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code></li>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley</ul>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley</div>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<div class="directive-section"><h2><a name="RemoveType" id="RemoveType">RemoveType</a> <a name="removetype" id="removetype">Directive</a></h2>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<table class="directive">
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any content type associations for a set of file
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halleyextensions</td></tr>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveType <var>extension</var> [<var>extension</var>]
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley...</code></td></tr>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff</table>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff <p>The <code class="directive">RemoveType</code> directive removes any MIME
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff type associations for files with the given extensions. This allows
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley <code>.htaccess</code> files in subdirectories to undo any
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley associations inherited from parent directories or the server
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley config files. An example of its use might be:</p>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley <div class="example"><h3>/foo/.htaccess:</h3><p><code>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence RemoveType .cgi
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley </code></p></div>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley <p>This will remove any special handling of <code>.cgi</code>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley files in the <code>/foo/</code> directory and any beneath it,
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley causing the files to be treated as being of the <code class="directive"><a href="/mod/core.html#defaulttype">DefaultType</a></code>.</p>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley <div class="note"><h3>Note</h3>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley <p><code class="directive">RemoveType</code> directives are processed
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley <em>after</em> any <code class="directive"><a href="#addtype">AddType</a></code>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley directives, so it is possible they may undo the effects of the
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley latter if both occur within the same directory configuration.</p>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley </div>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley <p>The <var>extension</var> argument is case-insensitive, and can
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley be specified with or without a leading dot.</p>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley</div>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<div class="directive-section"><h2><a name="TypesConfig" id="TypesConfig">TypesConfig</a> <a name="typesconfig" id="typesconfig">Directive</a></h2>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<table class="directive">
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The location of the mime.types file</td></tr>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TypesConfig <var>file-path</var></code></td></tr>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>TypesConfig conf/mime.types</code></td></tr>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley</table>
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley <p>The <code class="directive">TypesConfig</code> directive sets the location
45dadd25ba4b72ec2d8eecc342edc787d8421e3aBob Halley of the MIME types configuration file. <var>File-path</var> is relative
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley to the <code class="directive"><a href="/mod/core.html#serverroot">ServerRoot</a></code>. This file sets
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley the default list of mappings from filename extensions to content
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley types. Most administrators use the provided <code>mime.types</code>
fbc09123cd0cac8d513165c441ef2b2ed9b3445cBob Halley file, which associates common filename extensions with IANA registered
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley content types. The current list is maintained at <a href="http://www.isi.edu/in-notes/iana/assignments/media-types/media-types">http://www.isi.edu/in-notes/iana/assignments/media-types/media-types</a>.
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley This simplifies the <code>httpd.conf</code> file by providing the
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley majority of media-type definitions, and may be overridden by
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff <code class="directive"><a href="#addtype">AddType</a></code> directives as
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff needed. You should not edit the <code>mime.types</code> file, because
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff it may be replaced when you upgrade your server.</p>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence <p>The file contains lines in the format of the arguments to
14b98cb34eda66c87ce41a207704a2c232280eafMichael Graff an <code class="directive"><a href="#addtype">AddType</a></code> directive:</p>
14b98cb34eda66c87ce41a207704a2c232280eafMichael Graff
517274e709a3c730cd42f37dc1260dde95d1ea38Michael Graff <div class="example"><p><code>
4abed3e3563c7ad346178433130e6d150d3ffeafBob Halley <var>MIME-type</var> [<var>extension</var>] ...
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence </code></p></div>
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff
517274e709a3c730cd42f37dc1260dde95d1ea38Michael Graff <p>The case of the extension does not matter. Blank lines, and lines
4abed3e3563c7ad346178433130e6d150d3ffeafBob Halley beginning with a hash character (<code>#</code>) are ignored.</p>
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence
14b98cb34eda66c87ce41a207704a2c232280eafMichael Graff <div class="note">
14b98cb34eda66c87ce41a207704a2c232280eafMichael Graff Please do <strong>not</strong> send requests to the Apache HTTP
14b98cb34eda66c87ce41a207704a2c232280eafMichael Graff Server Project to add any new entries in the distributed
4abed3e3563c7ad346178433130e6d150d3ffeafBob Halley <code>mime.types</code> file unless (1) they are already
14b98cb34eda66c87ce41a207704a2c232280eafMichael Graff registered with IANA, and (2) they use widely accepted,
14b98cb34eda66c87ce41a207704a2c232280eafMichael Graff non-conflicting filename extensions across platforms.
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff <code>category/x-subtype</code> requests will be automatically
a253e35c2451818fb39f9b808c7641adb5275fb3Michael Graff rejected, as will any new two-letter extensions as they will
f181f94ec8da8b1dbcc6353e8be965ea4a5ea282Michael Graff likely conflict later with the already crowded language and
f181f94ec8da8b1dbcc6353e8be965ea4a5ea282Michael Graff character set namespace.
f181f94ec8da8b1dbcc6353e8be965ea4a5ea282Michael Graff </div>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence<h3>See also</h3>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<ul>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<li><code class="module"><a href="/mod/mod_mime_magic.html">mod_mime_magic</a></code></li>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff</ul>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff</div>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff</div>
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff<div class="bottomlang">
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<p><span>Available Languages: </span><a href="/en/mod/mod_mime.html" hreflang="en" title="English">&nbsp;en&nbsp;</a> | <a href="/ja/mod/mod_mime.html" hreflang="ja" title="Japanese">&nbsp;ja&nbsp;</a></p>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff</div><div id="footer">
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</a></p>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff<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>
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff</body></html>