mod_mime.xml revision 199a8ee5984e3708982fab1ba6ebb0a5feaea90c
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
e942c741056732f50da2074b36fe59805d370650slive<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<modulesynopsis>
75569f53579b42dc17cf097015b6b055c01e6875slive<description>Associates the requested filename's extensions
75569f53579b42dc17cf097015b6b055c01e6875slive with the file's behavior (handlers and filters)
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen and content (mime-type, language, character set and
c3fcea07965f59723831e23da647a77518285b8eslive encoding)</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>This module is used to associate various bits of "meta
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen information" with files by their filename extensions. This
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen information relates the filename of the document to it's
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen mime-type, language, character set and encoding. This
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen information is sent to the browser, and participates in content
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen negotiation, so the user's preferences are respected when
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen choosing one of several possible files to serve. See
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <module>mod_negotiation</module> for more information
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen about content negotiation. </p>
75569f53579b42dc17cf097015b6b055c01e6875slive module="mod_mime">AddLanguage</directive> and <directive
75569f53579b42dc17cf097015b6b055c01e6875slive module="mod_mime">AddType</directive> are all used to map file
75569f53579b42dc17cf097015b6b055c01e6875slive extensions onto the meta-information for that file. Respectively
75569f53579b42dc17cf097015b6b055c01e6875slive they set the character set, content-encoding, content-language,
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive and MIME-type (content-type) of documents. The directive <directive
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive module="mod_mime">TypesConfig</directive> is used to specify a
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive file which also maps extensions onto MIME types. </p>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive <p>In addition, <module>mod_mime</module> may define the <a
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive href="/filter.html">filters</a> that originate and process
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive content. The directives <directive
75569f53579b42dc17cf097015b6b055c01e6875slive module="mod_mime">AddOutputFilter</directive>, and <directive
75569f53579b42dc17cf097015b6b055c01e6875slive module="mod_mime">AddInputFilter</directive> control the modules
75569f53579b42dc17cf097015b6b055c01e6875slive or scripts that serve the document. The <directive
75569f53579b42dc17cf097015b6b055c01e6875slive module="mod_mime">MultiviewsMatch</directive> directive allows
75569f53579b42dc17cf097015b6b055c01e6875slive <module>mod_negotiation</module> to consider these file extensions
f794e11d17dcdae9f5f2944a5bfd06a7ded6a579yoshiki to be included when testing Multiviews matches.</p>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive <p>While <module>mod_mime</module> associates meta-information
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive with filename extensions, the <module>core</module> server
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive provides directives that are used to associate all the files in a
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive given container (<em>e.g.</em>, <directive type="section"
df5db89264efca559e954ca181763a0d3ef2f844nd module="core">Location</directive>, <directive type="section"
df5db89264efca559e954ca181763a0d3ef2f844nd module="core">Directory</directive>, or <directive type="section"
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive meta-information. These directives include <directive
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive module="core">SetInputFilter</directive>, and <directive
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive module="core">SetOutputFilter</directive>. The core directives
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive override any filename extension mappings defined in
75569f53579b42dc17cf097015b6b055c01e6875slive <p>Note that changing the meta-information for a file does not
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen change the value of the <code>Last-Modified</code> header.
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen Thus, previously cached copies may still be used by a client or
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen proxy, with the previous headers. If you change the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen meta-information (language, content type, character set or
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen encoding) you may need to 'touch' affected files (updating
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen their last modified date) to ensure that all visitors are
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen receive the corrected content headers.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen module="mod_mime_magic">MimeMagicFile</directive></seealso>
75569f53579b42dc17cf097015b6b055c01e6875slive<seealso><directive module="core">AddDefaultCharset</directive></seealso>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive<seealso><directive module="core">ForceType</directive></seealso>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive<seealso><directive module="core">DefaultType</directive></seealso>
75569f53579b42dc17cf097015b6b055c01e6875slive<seealso><directive module="core">SetHandler</directive></seealso>
75569f53579b42dc17cf097015b6b055c01e6875slive<seealso><directive module="core">SetInputFilter</directive></seealso>
75569f53579b42dc17cf097015b6b055c01e6875slive<seealso><directive module="core">SetOutputFilter</directive></seealso>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>Files can have more than one extension, and the order of the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen extensions is <em>normally</em> irrelevant. For example, if the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen file <code>welcome.html.fr</code> maps onto content type
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen text/html and language French then the file <code>welcome.fr.html</code>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen will map onto exactly the same information. If more than one
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen extension is given which maps onto the same
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen type of meta-information, then the one to the right will be
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen used. For example, if ".gif" maps to the MIME-type image/gif
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen and ".html" maps to the MIME-type text/html, then the file
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <code>welcome.gif.html</code> will be associated with the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>Care should be taken when a file with multiple extensions
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen gets associated with both a MIME-type and a handler. This will
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen usually result in the request being by the module associated
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen with the handler. For example, if the <code>.imap</code>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen extension is mapped to the handler "imap-file" (from mod_imap)
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen and the <code>.html</code> extension is mapped to the MIME-type
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen "text/html", then the file <code>world.imap.html</code> will be
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen associated with both the "imap-file" handler and "text/html"
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen MIME-type. When it is processed, the "imap-file" handler will
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen be used, and so it will be treated as a mod_imap imagemap
c3fcea07965f59723831e23da647a77518285b8eslive<section id="contentencoding"><title>Content encoding</title>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>A file of a particular MIME type can additionally be encoded a
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen particular way to simplify transmission over the Internet.
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen While this usually will refer to compression, such as
c3fcea07965f59723831e23da647a77518285b8eslive <code>gzip</code>, it can also refer to encryption, such a
c3fcea07965f59723831e23da647a77518285b8eslive <code>pgp</code> or to an encoding such as UUencoding, which is
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen designed for transmitting a binary file in an ASCII (text)
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen format.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen The Content-Encoding entity-header field is used as a
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen modifier to the media-type. When present, its value indicates
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen what additional content coding has been applied to the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen resource, and thus what decoding mechanism must be applied in
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen order to obtain the media-type referenced by the Content-Type
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen header field. The Content-Encoding is primarily used to allow
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen a document to be compressed without losing the identity of
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen its underlying media type.
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen href="#multipleext">section above about multiple file
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen extensions</a>), you can indicate that a file is of a
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>For example, you may have a file which is a Microsoft Word
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen document, which is pkzipped to reduce its size. If the
c3fcea07965f59723831e23da647a77518285b8eslive <code>.doc</code> extension is associated with the Microsoft
c3fcea07965f59723831e23da647a77518285b8eslive Word file type, and the <code>.zip</code> extension is
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen associated with the pkzip file encoding, then the file
c3fcea07965f59723831e23da647a77518285b8eslive <code>Resume.doc.zip</code>would be known to be a pkzip'ed Word
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen document.</p>
c3fcea07965f59723831e23da647a77518285b8eslive <p>Apache send a <code>Content-encoding</code> header with the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen resource, in order to tell the client browser about the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen encoding method.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>In addition to file type and the file encoding,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen another important piece of information is what language a
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen particular document is in, and in what character set the file
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen should be displayed. For example, the document might be written
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen in the Vietnamese alphabet, or in Cyrillic, and should be
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen displayed as such. This information, also, is transmitted in
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen HTTP headers.</p>
dd6c631a85bd0659226ed0406143aeba179846d3yoshiki <p>The character set, language, encoding and mime type are all
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen used in the process of content negotiation (See
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen which document to give to the client, when there are
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen alternative documents in more than one character set, language,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen encoding or mime type. All filename extensions associations
199a8ee5984e3708982fab1ba6ebb0a5feaea90cnd created with <directive module="mod_mime">AddCharset</directive>,
199a8ee5984e3708982fab1ba6ebb0a5feaea90cnd <directive module="mod_mime">AddEncoding</directive>, <directive
199a8ee5984e3708982fab1ba6ebb0a5feaea90cnd (and extensions listed in the <directive module="mod_mime_magic"
199a8ee5984e3708982fab1ba6ebb0a5feaea90cnd >MimeMagicFile</directive>) participate in this select process.
199a8ee5984e3708982fab1ba6ebb0a5feaea90cnd Filename extensions that are only associated using the <directive
199a8ee5984e3708982fab1ba6ebb0a5feaea90cnd module="mod_mime">AddHandler</directive>, <directive module="mod_mime"
199a8ee5984e3708982fab1ba6ebb0a5feaea90cnd >AddInputFilter</directive> or <directive module="mod_mime"
199a8ee5984e3708982fab1ba6ebb0a5feaea90cnd >AddOutputFilter</directive> directives may be included or excluded
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>To convey this further information, Apache optionally sends
c3fcea07965f59723831e23da647a77518285b8eslive a <code>Content-Language</code> header, to specify the language
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen that the document is in, and can append additional information
c3fcea07965f59723831e23da647a77518285b8eslive onto the <code>Content-Type</code> header to indicate the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen particular character set that should be used to correctly
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen render the information.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowenContent-Language: en, fr<br />
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The language specification is the two-letter abbreviation
c3fcea07965f59723831e23da647a77518285b8eslive for the language. The <code>charset</code> is the name of the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen particular character set which should be used.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
c3fcea07965f59723831e23da647a77518285b8eslive<description>Maps the given filename extensions
c3fcea07965f59723831e23da647a77518285b8eslive to the specified content charset</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<compatibility>AddCharset is only available in Apache
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen1.3.10 and later</compatibility>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The AddCharset directive maps the given filename extensions
c3fcea07965f59723831e23da647a77518285b8eslive to the specified content charset. <em>charset</em> is the MIME
c3fcea07965f59723831e23da647a77518285b8eslive charset parameter of filenames containing <em>extension</em>.
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen This mapping is added to any already in force, overriding any
c3fcea07965f59723831e23da647a77518285b8eslive mappings that already exist for the same <em>extension</em>.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddLanguage ja .ja<br />
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddCharset EUC-JP .euc<br />
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddCharset ISO-2022-JP .jis<br />
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddCharset SHIFT_JIS .sjis
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>Then the document <code>xxxx.ja.jis</code> will be treated
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen as being a Japanese document whose charset is ISO-2022-JP (as
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen will the document <code>xxxx.jis.ja</code>). The AddCharset
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen directive is useful for both to inform the client about the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen character encoding of the document so that the document can be
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen interpreted and displayed appropriately, and for <a
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen href="/content-negotiation.html">content negotiation</a>,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen where the server returns one from several documents based on
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen the client's charset preference.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <em>extension</em> argument is case-insensitive, and can
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen be specified with or without a leading dot.</p>
75569f53579b42dc17cf097015b6b055c01e6875slive<seealso><directive module="core">AddDefaultCharset</directive></seealso>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
c3fcea07965f59723831e23da647a77518285b8eslive<description>Maps the given filename extensions
c3fcea07965f59723831e23da647a77518285b8eslive to the specified encoding type</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>AddEncoding
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <em>MIME-enc extension</em> [<em>extension</em>] ...</syntax>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The AddEncoding directive maps the given filename extensions
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen to the specified encoding type. <em>MIME-enc</em> is the MIME
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen encoding to use for documents containing the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <em>extension</em>. This mapping is added to any already in
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen force, overriding any mappings that already exist for the same
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddEncoding x-gzip .gz<br />
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddEncoding x-compress .Z
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>This will cause filenames containing the .gz extension to be
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen marked as encoded using the x-gzip encoding, and filenames
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen containing the .Z extension to be marked as encoded with
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen x-compress. </p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <code>x-compress</code>, however the standard dictates that
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <code>compress</code> respectively. Apache does content
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen encoding comparisons by ignoring any leading <code>x-</code>.
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen When responding with an encoding Apache will use whatever form
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen (<em>i.e.</em>, <code>x-foo</code> or <code>foo</code>) the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen client requested. If the client didn't specifically request a
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen particular form Apache will use the form given by the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <code>AddEncoding</code> directive. To make this long story
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <code>x-compress</code> for these two specific encodings. More
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen recent encodings, such as <code>deflate</code> should be
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <em>extension</em> argument is case-insensitive, and can
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen be specified with or without a leading dot.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
75569f53579b42dc17cf097015b6b055c01e6875slive<description>Maps the filename extensions
75569f53579b42dc17cf097015b6b055c01e6875sliveto the specified handler</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>AddHandler
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <em>handler-name extension</em> [<em>extension</em>] ...</syntax>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
f794e11d17dcdae9f5f2944a5bfd06a7ded6a579yoshiki<p>Files having the name <em>extension</em> will be served by the
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslivespecified <a href="/handler.html">handler-name</a>. This mapping is
eabaccd4bdeaafc3d0c21886863bd9acefea99bbsliveadded to any already in force, overriding any mappings that already
eabaccd4bdeaafc3d0c21886863bd9acefea99bbsliveexist for the same <em>extension</em>. For example, to activate CGI
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslivescripts with the file extension "<code>.cgi</code>", you might
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddHandler cgi-script .cgi
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>Once that has been put into your srm.conf or httpd.conf
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen file, any file containing the "<code>.cgi</code>" extension
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen will be treated as a CGI program.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <em>extension</em> argument is case-insensitive, and can
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen be specified with or without a leading dot.</p>
75569f53579b42dc17cf097015b6b055c01e6875slive<seealso><directive module="core">SetHandler</directive></seealso>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
75569f53579b42dc17cf097015b6b055c01e6875slive<description>Maps filename extensions
75569f53579b42dc17cf097015b6b055c01e6875slive to the filters that will process
c3fcea07965f59723831e23da647a77518285b8eslive client requests</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>AddInputFilter
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<compatibility>AddInputFilter
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen is only available in Apache 2.0.26 and later.</compatibility>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive <p>AddInputFilter maps the filename extensions <em>extension</em>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive to the <a href="/filter.html">filters</a> which will process
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen client requests and POST input when they are received by the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen server. This is in addition to any filters defined elsewhere,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen including the <a
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen href="core.html#setinputfilter">SetInputFilter</a> directive.
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive This mapping is merged over any already in force, overriding any
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive mappings that already exist for the same <em>extension</em>.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>If more than one filter is specified, they must be separated
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen by semicolons in the order in which they should process the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen content. Both the filter and <em>extension</em> arguments are
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen case-insensitive, and the extension may be specified with or
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen without a leading dot.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
c3fcea07965f59723831e23da647a77518285b8eslive<description>Maps the given filename extension
c3fcea07965f59723831e23da647a77518285b8esliveto the specified content language</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>AddLanguage
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <em>MIME-lang extension</em> [<em>extension</em>] ...</syntax>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The AddLanguage directive maps the given filename extension
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen to the specified content language. <em>MIME-lang</em> is the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen MIME language of filenames containing <em>extension</em>. This
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen mapping is added to any already in force, overriding any
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen mappings that already exist for the same
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddEncoding x-compress .Z<br />
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddLanguage en .en<br />
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddLanguage fr .fr
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>Then the document <code>xxxx.en.Z</code> will be treated as
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen being a compressed English document (as will the document
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <code>xxxx.Z.en</code>). Although the content language is
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen reported to the client, the browser is unlikely to use this
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen information. The AddLanguage directive is more useful for <a
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen href="/content-negotiation.html">content negotiation</a>,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen where the server returns one from several documents based on
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen the client's language preference.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>If multiple language assignments are made for the same
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen extension, the last one encountered is the one that is used.
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen That is, for the case of:</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddLanguage en .en<br />
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddLanguage en-uk .en<br />
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddLanguage en-us .en
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>documents with the extension "<code>.en</code>" would be
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <em>extension</em> argument is case-insensitive, and can
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen be specified with or without a leading dot.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
15ba1801088da1aad6d20609cf3f7b0b1eefce8aslive<description>Maps filename
c3fcea07965f59723831e23da647a77518285b8esliveextensions to the filters that will process
c3fcea07965f59723831e23da647a77518285b8esliveresponses from the server</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>AddOutputFilter
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<compatibility>AddOutputFilter
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen is only available in Apache 2.0.26 and later.</compatibility>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive <p>The <directive>AddOutputFilter</directive> directive maps the
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive href="/filter.html">filters</a> which will process responses
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive from the server before they are sent to the client. This is in
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive addition to any filters defined elsewhere, including the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen directive. This mapping is merged over any already in force,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen overriding any mappings that already exist for the same
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>For example, the following configuration will process all
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive .shtml files for server-side includes and will then compress
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive AddOutputFilter INCLUDES;DEFLATE shtml
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>If more than one filter is specified, they must be separated
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen by semicolons in the order in which they should process the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen content. Both the filter and <em>extension</em> arguments are
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen case-insensitive, and the extension may be specified with or
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen without a leading dot.</p>
44c61920e384b819aba8ad43310c67c71fa64a48rbowen<seealso><directive module="mod_mime">RemoveOutputFilter</directive></seealso>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
c3fcea07965f59723831e23da647a77518285b8eslive<description>Maps the given filename extensions
c3fcea07965f59723831e23da647a77518285b8esliveonto the specified content type</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive <p>The AddType directive maps the given filename extensions onto
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive the specified content type. <em>MIME-type</em> is the MIME type to
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive use for filenames containing <em>extension</em>. This mapping is
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive added to any already in force, overriding any mappings that
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive already exist for the same <em>extension</em>. This directive can
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive be used to add mappings not listed in the MIME types file (see the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen directive).</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <note>It is recommended that new MIME types be added using the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddType directive rather than changing the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <em>extension</em> argument is case-insensitive, and can
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen be specified with or without a leading dot.</p>
75569f53579b42dc17cf097015b6b055c01e6875slive<seealso><directive module="core">DefaultType</directive></seealso>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive<seealso><directive module="core">ForceType</directive></seealso>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
75569f53579b42dc17cf097015b6b055c01e6875slive<description>The types of files that will be included when
75569f53579b42dc17cf097015b6b055c01e6875slivesearching for a matching file with MultiViews</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>MultiviewsMatch
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <em>[NegotiatedOnly] [Handlers] [Filters] [Any]</em></syntax>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
75569f53579b42dc17cf097015b6b055c01e6875slive<compatibility>Available
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen in Apache 2.0.26 and later.</compatibility>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>MultiviewsMatch permits three different behaviors for
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <a href="mod_negotiation.html">mod_negotiation</a>'s Multiviews
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen feature. Multiviews allows a request for a file, e.g. index.html,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen to match any negotiated extensions following the base request,
7ded39cfde416fb4458dc08afc64bfe6274dfb1dslive e.g. index.html.en, index.html.fr, or index.html.gz.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The NegotiatedOnly option provides that every extension following
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen the base name must correlate to a recognized mod_mime extension for
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen content negotation, e.g. Charset, Content-Type, Language, or
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen Encoding. This is the strictest implementation with the fewest
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen unexpected side effects, and is the default behavior.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>To include extensions associated with Handlers and/or Filters,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen set the MultiviewsMatch directive to either Handlers, Filters, or
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen both option keywords. If all other factors are equal, the smallest
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen file will be served, e.g. in deciding between index.html.cgi of 500
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen characters and index.html.pl of 1000 bytes, the .cgi file would win
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen in this example. Users of .asis files might prefer to use the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen Handler option, if .asis files are associated with the asis-handler.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>You may finally allow Any extensions to match, even if mod_mime
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen doesn't recognize the extension. This was the behavior in Apache 1.3,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen and can cause unpredicatable results, such as serving .old or .bak
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen files the webmaster never expected to be served.</p>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive <p>For example, the following configuration will allow handlers
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive and filters to participate in Multviews, but will exclude unknown
eabaccd4bdeaafc3d0c21886863bd9acefea99bbsliveMultiviewsMatch Handlers Filters
75569f53579b42dc17cf097015b6b055c01e6875slive<seealso><directive module="core">Options</directive></seealso>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
c3fcea07965f59723831e23da647a77518285b8eslive<description>Sets all files in the given scope to the
c3fcea07965f59723831e23da647a77518285b8eslivespecified language</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>DefaultLanguage
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<compatibility>DefaultLanguage
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen is only available in Apache 1.3.4 and later.</compatibility>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The DefaultLanguage directive tells Apache that all files in
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen the directive's scope (<em>e.g.</em>, all files covered by the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen current <code><Directory></code> container) that don't
c3fcea07965f59723831e23da647a77518285b8eslive have an explicit language extension (such as <code>.fr</code>
c3fcea07965f59723831e23da647a77518285b8eslive or <code>.de</code> as configured by <code>AddLanguage</code>)
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen should be considered to be in the specified <em>MIME-lang</em>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen language. This allows entire directories to be marked as
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen containing Dutch content, for instance, without having to
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen rename each file. Note that unlike using extensions to specify
c3fcea07965f59723831e23da647a77518285b8eslive languages, <code>DefaultLanguage</code> can only specify a
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen single language.</p>
c3fcea07965f59723831e23da647a77518285b8eslive <p>If no <code>DefaultLanguage</code> directive is in force,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen and a file does not have any language extensions as configured
c3fcea07965f59723831e23da647a77518285b8eslive by <code>AddLanguage</code>, then that file will be considered
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen to have no language attribute.</p>
7ded39cfde416fb4458dc08afc64bfe6274dfb1dsliveDefaultLanguage en
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
21b70e758d670601065db7b05e16441226e4e9b4jerenkrantz<directivesynopsis>
21b70e758d670601065db7b05e16441226e4e9b4jerenkrantz<description>Tells mod_mime to treat path_info components as part of the filename</description>
21b70e758d670601065db7b05e16441226e4e9b4jerenkrantz<contextlist>
21b70e758d670601065db7b05e16441226e4e9b4jerenkrantz</contextlist>
21b70e758d670601065db7b05e16441226e4e9b4jerenkrantz<compatibility>Available in Apache 2.0.41 and later</compatibility>
df5db89264efca559e954ca181763a0d3ef2f844nd <p>The <directive>ModMimeUsePathInfo</directive> directive is used to
df5db89264efca559e954ca181763a0d3ef2f844nd combine the filename with the path_info URL component to apply
df5db89264efca559e954ca181763a0d3ef2f844nd <module>mod_mime</module>'s directives to the request. The default
df5db89264efca559e954ca181763a0d3ef2f844nd value is <code>Off</code> - therefore, the path_info component is
df5db89264efca559e954ca181763a0d3ef2f844nd ignored.</p>
df5db89264efca559e954ca181763a0d3ef2f844nd <p>This directive is recommended when you have a virtual filesystem.</p>
df5db89264efca559e954ca181763a0d3ef2f844nd ModMimeUsePathInfo On
df5db89264efca559e954ca181763a0d3ef2f844nd </example>
df5db89264efca559e954ca181763a0d3ef2f844nd <p>If you have a request for <code>/bar/foo.shtml</code> where
df5db89264efca559e954ca181763a0d3ef2f844nd >ModMimeUsePathInfo</directive> is on, <module>mod_mime</module> will
df5db89264efca559e954ca181763a0d3ef2f844nd treat the incoming request as <code>/bar/foo.shtml</code> and
df5db89264efca559e954ca181763a0d3ef2f844nd directives like <code>AddOutputFilter INCLUDES .shtml</code> will add
df5db89264efca559e954ca181763a0d3ef2f844nd the INCLUDES filter to the request. If <directive
df5db89264efca559e954ca181763a0d3ef2f844nd >ModMimeUsePathInfo</directive> is not set, the INCLUDES filter will
df5db89264efca559e954ca181763a0d3ef2f844nd not be added.</p>
21b70e758d670601065db7b05e16441226e4e9b4jerenkrantz</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
75569f53579b42dc17cf097015b6b055c01e6875slive<description>Removes any character set associations for a set of file
75569f53579b42dc17cf097015b6b055c01e6875sliveextensions</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>RemoveCharset
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<compatibility>RemoveCharset is
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen only available in Apache 2.0.24 and later.</compatibility>
c3fcea07965f59723831e23da647a77518285b8eslive <p>The <code>RemoveCharset</code> directive removes any
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen character set associations for files with the given extensions.
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen This allows <code>.htaccess</code> files in subdirectories to
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen undo any associations inherited from parent directories or the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen server config files.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <em>extension</em> argument is case-insensitive, and can
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen be specified with or without a leading dot.</p>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbsliveRemoveCharset .html .shtml
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
75569f53579b42dc17cf097015b6b055c01e6875slive<description>Removes any content encoding associations for a set of file
75569f53579b42dc17cf097015b6b055c01e6875sliveextensions</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>RemoveEncoding
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<compatibility>RemoveEncoding
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen is only available in Apache 1.3.13 and later.</compatibility>
c3fcea07965f59723831e23da647a77518285b8eslive <p>The <code>RemoveEncoding</code> directive removes any
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen encoding associations for files with the given extensions. This
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen allows <code>.htaccess</code> files in subdirectories to undo
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen any associations inherited from parent directories or the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen server config files. An example of its use might be:</p>
97a9a944b5887e91042b019776c41d5dd74557aferikabeleAddEncoding x-gzip .gz
97a9a944b5887e91042b019776c41d5dd74557aferikabele<Files *.gz.asc>
97a9a944b5887e91042b019776c41d5dd74557aferikabele RemoveEncoding .gz
97a9a944b5887e91042b019776c41d5dd74557aferikabele</Files>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>This will cause <code>foo.gz</code> to be marked as being
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen encoded with the gzip method, but <code>foo.gz.asc</code> as an
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen unencoded plaintext file.</p>
c3fcea07965f59723831e23da647a77518285b8eslive <p><strong>Note:</strong>RemoveEncoding directives are processed
c3fcea07965f59723831e23da647a77518285b8eslive <em>after</em> any AddEncoding directives, so it is possible they
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen may undo the effects of the latter if both occur within the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen same directory configuration.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <em>extension</em> argument is case-insensitive, and can
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen be specified with or without a leading dot.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
75569f53579b42dc17cf097015b6b055c01e6875slive<description>Removes any handler associations for a set of file
75569f53579b42dc17cf097015b6b055c01e6875sliveextensions</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>RemoveHandler
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<compatibility>RemoveHandler is
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen only available in Apache 1.3.4 and later.</compatibility>
c3fcea07965f59723831e23da647a77518285b8eslive <p>The <code>RemoveHandler</code> directive removes any handler
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen associations for files with the given extensions. This allows
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <code>.htaccess</code> files in subdirectories to undo any
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen associations inherited from parent directories or the server
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen config files. An example of its use might be:</p>
97a9a944b5887e91042b019776c41d5dd74557aferikabeleAddHandler server-parsed .html
97a9a944b5887e91042b019776c41d5dd74557aferikabeleRemoveHandler .html
c3fcea07965f59723831e23da647a77518285b8eslive <p>This has the effect of returning <code>.html</code> files in
c3fcea07965f59723831e23da647a77518285b8eslive the <code>/foo/bar</code> directory to being treated as normal
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen files, rather than as candidates for parsing (see the <a
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen module).</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <em>extension</em> argument is case-insensitive, and can
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen be specified with or without a leading dot.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
75569f53579b42dc17cf097015b6b055c01e6875slive<description>Removes any input filter associations for a set of file
75569f53579b42dc17cf097015b6b055c01e6875sliveextensions</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>RemoveInputFilter
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<compatibility>RemoveInputFilter is only available in Apache
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen2.0.26 and later.</compatibility>
c3fcea07965f59723831e23da647a77518285b8eslive <p>The <code>RemoveInputFilter</code> directive removes any
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen input filter associations for files with the given extensions.
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen This allows <code>.htaccess</code> files in subdirectories to
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen undo any associations inherited from parent directories or the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen server config files.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <em>extension</em> argument is case-insensitive, and can
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen be specified with or without a leading dot.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
75569f53579b42dc17cf097015b6b055c01e6875slive<description>Removes any language associations for a set of file
75569f53579b42dc17cf097015b6b055c01e6875sliveextensions</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>RemoveLanguage
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<compatibility>RemoveLanguage
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen is only available in Apache 2.0.24 and later.</compatibility>
c3fcea07965f59723831e23da647a77518285b8eslive <p>The <code>RemoveLanguage</code> directive removes any
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen language associations for files with the given extensions. This
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen allows <code>.htaccess</code> files in subdirectories to undo
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen any associations inherited from parent directories or the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen server config files.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <em>extension</em> argument is case-insensitive, and can
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen be specified with or without a leading dot.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
75569f53579b42dc17cf097015b6b055c01e6875slive<description>Removes any output filter associations for a set of file
75569f53579b42dc17cf097015b6b055c01e6875sliveextensions</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>RemoveOutputFilter
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<compatibility>RemoveOutputFilter is only available in Apache
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen2.0.26 and later.</compatibility>
c3fcea07965f59723831e23da647a77518285b8eslive <p>The <code>RemoveOutputFilter</code> directive removes any
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen output filter associations for files with the given extensions.
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen This allows <code>.htaccess</code> files in subdirectories to
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen undo any associations inherited from parent directories or the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen server config files.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <em>extension</em> argument is case-insensitive, and can
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen be specified with or without a leading dot.</p>
44c61920e384b819aba8ad43310c67c71fa64a48rbowen RemoveOutputFilter shtml
44c61920e384b819aba8ad43310c67c71fa64a48rbowen<seealso><directive module="mod_mime">AddOutputFilter</directive></seealso>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
75569f53579b42dc17cf097015b6b055c01e6875slive<description>Removes any content type associations for a set of file
75569f53579b42dc17cf097015b6b055c01e6875sliveextensions</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<syntax>RemoveType
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<compatibility>RemoveType is
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen only available in Apache 1.3.13 and later.</compatibility>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <directive>RemoveType</directive> directive removes any MIME type
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen associations for files with the given extensions. This allows
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <code>.htaccess</code> files in subdirectories to undo any
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen associations inherited from parent directories or the server
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen config files. An example of its use might be:</p>
97a9a944b5887e91042b019776c41d5dd74557aferikabeleRemoveType .cgi
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>This will remove any special handling of <code>.cgi</code>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen files in the <code>/foo/</code> directory and any beneath it,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen causing the files to be treated as being of the <a
f794e11d17dcdae9f5f2944a5bfd06a7ded6a579yoshiki <note><strong>Note:</strong><directive>RemoveType</directive> directives
f794e11d17dcdae9f5f2944a5bfd06a7ded6a579yoshiki are processed <em>after</em> any <directive>AddType</directive>
c3fcea07965f59723831e23da647a77518285b8eslive directives, so it is possible they may undo the effects of the
c3fcea07965f59723831e23da647a77518285b8eslive latter if both occur within the same directory
c3fcea07965f59723831e23da647a77518285b8eslive configuration.</note>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <em>extension</em> argument is case-insensitive, and can
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen be specified with or without a leading dot.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
75569f53579b42dc17cf097015b6b055c01e6875slive<description>The location of the mime.types file</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive <p>The TypesConfig directive sets the location of the MIME types
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive configuration file. <em>Filename</em> is relative to the <a
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive href="core.html#serverroot">ServerRoot</a>. This file sets the
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive default list of mappings from filename extensions to content
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive types. Most administrators use the provided
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive <code>mime.types</code> file, which associates common filename
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive extensions with IANA registered content types. The current list is
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive maintained at
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive <code>http://www.isi.edu/in-notes/iana/assignments/media-types/media-types</code>. This
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive simplifies the <code>httpd.conf</code> file by providing the
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive majority of media-type definitions, and may be overridden by
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive <directive module="mod_mime">AddType</directive> directives as
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive needed. You should not edit the <code>mime.types</code> file,
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive because it may be replaced when you upgrade your server.</p>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive <p>The file contains lines in the format of the arguments to
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive an <directive module="mod_mime">AddType</directive> directive:</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen MIME-type extension extension ...
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive The case of the extension does not matter. Blank lines, and lines
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen beginning with a hash character (`#') are ignored. </p>
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive <note>Please do not send requests to the Apache HTTP Server Project
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive to add any new entries in the distributed mime.types file
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive unless (1) they are already registered with IANA, and (2) they
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive use widely accepted, non-conflicting filename extensions across
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive platforms. category/x-subtype requests will be automatically
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive rejected, as will any new two-letter extensions as they will
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive likely conflict later with the already crowded language and
eabaccd4bdeaafc3d0c21886863bd9acefea99bbslive character set namespace.</note>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</modulesynopsis>