mod_mime.xml revision 75569f53579b42dc17cf097015b6b055c01e6875
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<?xml-stylesheet type="text/xsl" href="/style/manual.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,
75569f53579b42dc17cf097015b6b055c01e6875slive and MIME-type (content-type) of documents.</p>
75569f53579b42dc17cf097015b6b055c01e6875slive <p>In addition, <module>mod_mime</module> may define the "handler"
75569f53579b42dc17cf097015b6b055c01e6875slive for a document, which controls what module or script will serve
75569f53579b42dc17cf097015b6b055c01e6875slive the document. With the introduction of "filters" in Apache 2.0,
75569f53579b42dc17cf097015b6b055c01e6875slive <module>mod_mime</module> can also define the filters that the the
75569f53579b42dc17cf097015b6b055c01e6875slive content should be processed through (e.g. the Includes output
75569f53579b42dc17cf097015b6b055c01e6875slive filter for server side scripting) and what filters the client
75569f53579b42dc17cf097015b6b055c01e6875slive request and POST content should be processed through (the input
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen filters.)</p>
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
75569f53579b42dc17cf097015b6b055c01e6875slive to included when testing Multiviews matches.</p>
75569f53579b42dc17cf097015b6b055c01e6875slive module="mod_mime">TypesConfig</directive> is used to specify a
75569f53579b42dc17cf097015b6b055c01e6875slive file which also maps extensions onto MIME types. Most
75569f53579b42dc17cf097015b6b055c01e6875slive administrators use the provided mime.types file which associates
75569f53579b42dc17cf097015b6b055c01e6875slive common filename extensions with IANA registered content types. The
75569f53579b42dc17cf097015b6b055c01e6875slive current list is maintained at
75569f53579b42dc17cf097015b6b055c01e6875slive <code>http://www.isi.edu/in-notes/iana/assignments/media-types/media-types</code>. This
75569f53579b42dc17cf097015b6b055c01e6875slive simplifies the <code>httpd.conf</code> file by providing the
75569f53579b42dc17cf097015b6b055c01e6875slive majority of media-type definitions, and they may be overridden by
75569f53579b42dc17cf097015b6b055c01e6875slive <directive module="mod_mime">AddType</directive> directives as
75569f53579b42dc17cf097015b6b055c01e6875slive needed.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <note>Please do not send requests to the Apache httpd Project
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen to add any new entries in the distributed mime.types file
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen unless (1) they are already registered with IANA, and (2) they
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen use widely accepted, non-conflicting filename extensions across
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen platforms. category/x-subtype requests will be automatically
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen rejected, as will any new two-letter extensions as they will
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen likely conflict later with the already crowded language and
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen character set namespace.</note>
75569f53579b42dc17cf097015b6b055c01e6875slive module="core">SetHandler</directive> are used to associate all the
75569f53579b42dc17cf097015b6b055c01e6875slive type="section" module="core">location</directive>, <directive
75569f53579b42dc17cf097015b6b055c01e6875slive type="section" module="core">director</directive>, or <directive
75569f53579b42dc17cf097015b6b055c01e6875slive type="section" module="core">Files</directive>) with a particular
75569f53579b42dc17cf097015b6b055c01e6875slive MIME-type or handler. These settings override any filename
75569f53579b42dc17cf097015b6b055c01e6875slive extension mappings defined in <module>mod_mime</module>.</p>
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">DefaultType</directive></seealso>
75569f53579b42dc17cf097015b6b055c01e6875slive<seealso><directive module="core">AddDefaultCharset</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>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <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
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen created with <module>AddCharset</module>, <module>AddEncoding</module>,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <module>AddLanguage</module> and <module>AddType</module> directives
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen (and extensions listed in the <module>MimeMagicFile</module>)
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen participate in this select process. Filename extensions that
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen are only associated using the <module>AddHandler</module>,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <module>AddInputFilter</module> or <module>AddOutputFilter</module>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen directives may be included or excluded from matching by using
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen the <directive>MultiviewsMatch</directive> directive.</p>
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>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<p>This mapping is added to any already in
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen force, overriding any mappings that already exist for the same
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <em>extension</em>. For example, to activate CGI scripts with
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen the file extension "<code>.cgi</code>", you might use:</p>
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><a href="/handler.html">Handlers</a></seealso>
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>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>AddInputFilter maps the filename extensions
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <em>extension</em> to the filter or filters 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.
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen This mapping is merged over any already in force, overriding
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen any mappings that already exist for the same
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>
c3fcea07965f59723831e23da647a77518285b8eslive documentation.</seealso>
75569f53579b42dc17cf097015b6b055c01e6875slive<seealso><directive module="core">SetInputFilter</directive></seealso>
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>
c3fcea07965f59723831e23da647a77518285b8eslive<description>maps the 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>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The <directive>AddOutputFilter</directive> directive maps the filename
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen extensions <em>extension</em> to the filters which will process
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen responses from the server before they are sent to the client.
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen This is in addition to any filters defined elsewhere, including
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen the <directive module="core">SetOutputFilter</directive>
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
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen .shtml files for server-side includes.</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddOutputFilter INCLUDES 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>
c3fcea07965f59723831e23da647a77518285b8eslive<seealso><a href="/filter.html">Filters</a> documentation</seealso>
75569f53579b42dc17cf097015b6b055c01e6875slive<seealso><directive module="core">SetOutputFilter</directive></seealso>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<directivesynopsis>
c3fcea07965f59723831e23da647a77518285b8eslive<description>Maps the given filename extensions
c3fcea07965f59723831e23da647a77518285b8esliveonto the specified content type</description>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen<contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</contextlist>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The AddType directive maps the given filename extensions
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen onto the specified content type. <em>MIME-type</em> is the MIME
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen type to use for 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 <em>extension</em>.
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen This directive can be used to add mappings not listed in the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen MIME types file (see the <directive>TypesConfig</directive>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen directive).</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <note>It is recommended that new MIME types be added using the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen AddType directive rather than changing the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <note>Note that, unlike the NCSA httpd, this directive cannot be
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen used to set the type of particular files.</note>
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>
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,
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen 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>
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>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</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>
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>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <code> RemoveEncoding
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>
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>
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>
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
c3fcea07965f59723831e23da647a77518285b8eslive <note><strong>Note:</strong><module>RemoveType</module> directives
c3fcea07965f59723831e23da647a77518285b8eslive are processed <em>after</em> any <module>AddType</module>
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>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <p>The TypesConfig directive sets the location of the MIME
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen types configuration file. <em>Filename</em> is relative to the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <a href="core.html#serverroot">ServerRoot</a>. This file sets
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen the default list of mappings from filename extensions to
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen content types; changing this file is not recommended. Use the
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen <a href="#addtype">AddType</a> directive instead. The file
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen contains lines in the format of the arguments to an AddType
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen command:</p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen MIME-type extension extension ...
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen The extensions are lower-cased. Blank lines, and lines
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen beginning with a hash character (`#') are ignored. </p>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</directivesynopsis>
c053576cdcd7389a1e11dd9c656f1f723ae854bcrbowen</modulesynopsis>