mod_dir.html.en revision 1f1b6bf13313fdd14a45e52e553d3ff28689b717
97a9a944b5887e91042b019776c41d5dd74557aferikabele<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
97a9a944b5887e91042b019776c41d5dd74557aferikabele<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
a945f35eff8b6a88009ce73de6d4c862ce58de3cslive XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
a945f35eff8b6a88009ce73de6d4c862ce58de3cslive This file is generated from xml source: DO NOT EDIT
a945f35eff8b6a88009ce73de6d4c862ce58de3cslive XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
b686b6a420bde7f78c416b90be11db94cb789979nd<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
b686b6a420bde7f78c416b90be11db94cb789979nd<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<script src="/style/scripts/prettify.min.js" type="text/javascript">
b686b6a420bde7f78c416b90be11db94cb789979nd<link href="/images/favicon.ico" rel="shortcut icon" /></head>
d229f940abfb2490dee17979e9a5ff31b7012eb5rbowen<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
b686b6a420bde7f78c416b90be11db94cb789979nd<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd<p><span>Available Languages: </span><a href="/en/mod/mod_dir.html" title="English"> en </a> |
d28579afd45cc42da1422161721fb12f9cf366b9nd<a href="/fr/mod/mod_dir.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd<a href="/ja/mod/mod_dir.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
1ac39787115a288f5e848344b1b1e8dccb1c58f1nd<a href="/ko/mod/mod_dir.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a href="/tr/mod/mod_dir.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
b686b6a420bde7f78c416b90be11db94cb789979nd<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Provides for "trailing slash" redirects and
b686b6a420bde7f78c416b90be11db94cb789979nd<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Base</td></tr>
b686b6a420bde7f78c416b90be11db94cb789979nd<tr><th><a href="module-dict.html#ModuleIdentifier">Module�Identifier:</a></th><td>dir_module</td></tr>
b686b6a420bde7f78c416b90be11db94cb789979nd<tr><th><a href="module-dict.html#SourceFile">Source�File:</a></th><td>mod_dir.c</td></tr></table>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>The index of a directory can come from one of two sources:</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>A file written by the user, typically called
97a9a944b5887e91042b019776c41d5dd74557aferikabele <code>index.html</code>. The <code class="directive"><a href="#directoryindex">DirectoryIndex</a></code> directive sets the
06ba4a61654b3763ad65f52283832ebf058fdf1cslive name of this file. This is controlled by
97a9a944b5887e91042b019776c41d5dd74557aferikabele <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code>.</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>Otherwise, a listing generated by the server. This is
97a9a944b5887e91042b019776c41d5dd74557aferikabele provided by <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code>.</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>The two functions are separated so that you can completely
06ba4a61654b3763ad65f52283832ebf058fdf1cslive remove (or replace) automatic index generation should you want
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>A "trailing slash" redirect is issued when the server
06ba4a61654b3763ad65f52283832ebf058fdf1cslive receives a request for a URL
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>dirname</code> is a directory. Directories require a
97a9a944b5887e91042b019776c41d5dd74557aferikabele trailing slash, so <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> issues a redirect to
b686b6a420bde7f78c416b90be11db94cb789979nd<div id="quickview"><h3 class="directives">Directives</h3>
b686b6a420bde7f78c416b90be11db94cb789979nd<li><img alt="" src="/images/down.gif" /> <a href="#directorycheckhandler">DirectoryCheckHandler</a></li>
c31366647a84875104bb9cbca53280b607c37595covener<li><img alt="" src="/images/down.gif" /> <a href="#directoryindex">DirectoryIndex</a></li>
4cc6016bd30b0852222630a0ed62805e36f345d1nd<li><img alt="" src="/images/down.gif" /> <a href="#directoryindexredirect">DirectoryIndexRedirect</a></li>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<li><img alt="" src="/images/down.gif" /> <a href="#directoryslash">DirectorySlash</a></li>
b686b6a420bde7f78c416b90be11db94cb789979nd<li><img alt="" src="/images/down.gif" /> <a href="#fallbackresource">FallbackResource</a></li>
b686b6a420bde7f78c416b90be11db94cb789979nd<ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
b686b6a420bde7f78c416b90be11db94cb789979nd<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
b686b6a420bde7f78c416b90be11db94cb789979nd<div class="directive-section"><h2><a name="DirectoryCheckHandler" id="DirectoryCheckHandler">DirectoryCheckHandler</a> <a name="directorycheckhandler" id="directorycheckhandler">Directive</a></h2>
b686b6a420bde7f78c416b90be11db94cb789979nd<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Toggle how this module responds when another handler is configured</td></tr>
b686b6a420bde7f78c416b90be11db94cb789979nd<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DirectoryCheckHandler On|Off</code></td></tr>
b6d2c204c150843e48f6787c1090ae75b718896ecovener<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DirectoryCheckHandler Off</code></td></tr>
b686b6a420bde7f78c416b90be11db94cb789979nd<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
b686b6a420bde7f78c416b90be11db94cb789979nd<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Indexes</td></tr>
b686b6a420bde7f78c416b90be11db94cb789979nd<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
b686b6a420bde7f78c416b90be11db94cb789979nd<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr>
b686b6a420bde7f78c416b90be11db94cb789979nd<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in 2.4.8 and later. Releases prior to 2.4 implicitly
b686b6a420bde7f78c416b90be11db94cb789979ndact as if "DirectoryCheckHandler ON" was specified.</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>The <code class="directive">DirectoryCheckHandler</code> directive determines
1887c0b8ceab2c8d64a1e5b3aa512e77b86b49fayoshiki whether <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> should check for directory indexes or
f5cbf3a7818c08d2f19c04fdf4f47257eea7d3c6nd add trailing slashes when some other handler has been configured for
06ba4a61654b3763ad65f52283832ebf058fdf1cslive the current URL. Handlers can be set by directives such as
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code class="directive"><a href="/mod/core.html#sethandler">SetHandler</a></code> or by other modules at
06ba4a61654b3763ad65f52283832ebf058fdf1cslive runtime. </p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p> In releases prior to 2.4, this module did not take any action if any
06ba4a61654b3763ad65f52283832ebf058fdf1cslive other handler was configured for a URL. This allows directory indexes to
06ba4a61654b3763ad65f52283832ebf058fdf1cslive be served even when a <code class="directive">SetHandler</code> directive is
e487d6c09669296f94a5190cc34586a98e624a00nd specified for an entire directory, but it can also result in some conflicts
f5cbf3a7818c08d2f19c04fdf4f47257eea7d3c6nd with other modules.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
c31366647a84875104bb9cbca53280b607c37595covener<div class="directive-section"><h2><a name="DirectoryIndex" id="DirectoryIndex">DirectoryIndex</a> <a name="directoryindex" id="directoryindex">Directive</a></h2>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>List of resources to look for when the client requests
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DirectoryIndex
06ba4a61654b3763ad65f52283832ebf058fdf1cslive disabled | <var>local-url</var> [<var>local-url</var>] ...</code></td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DirectoryIndex index.html</code></td></tr>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
f5cbf3a7818c08d2f19c04fdf4f47257eea7d3c6nd<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Indexes</td></tr>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>The <code class="directive">DirectoryIndex</code> directive sets the
f5cbf3a7818c08d2f19c04fdf4f47257eea7d3c6nd list of resources to look for, when the client requests an index
f5cbf3a7818c08d2f19c04fdf4f47257eea7d3c6nd of the directory by specifying a / at the end of the directory
b686b6a420bde7f78c416b90be11db94cb789979nd name. <var>Local-url</var> is the (%-encoded) URL of a document on
9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf the server relative to the requested directory; it is usually the
e2d704f65ae715639ae9d21d98bbf19ebcad58ffhumbedooh name of a file in the directory. Several URLs may be given, in
b6d2c204c150843e48f6787c1090ae75b718896ecovener which case the server will return the first one that it finds. If
b6d2c204c150843e48f6787c1090ae75b718896ecovener none of the resources exist and the <code>Indexes</code> option is
63de18ba5e922ffaab500317d7d1d0ad6b27b7e2covener set, the server will generate its own listing of the
daf4d4394c14b23e06073c13806259a2dc7574b4humbedooh directory.</p>
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">DirectoryIndex index.html</pre>
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh <p>then a request for <code>http://example.com/docs/</code> would
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh return <code>http://example.com/docs/index.html</code> if it
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh exists, or would list the directory if it did not.</p>
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh <p>Note that the documents do not need to be relative to the
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh directory;</p>
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh <pre class="prettyprint lang-config">DirectoryIndex index.html index.txt /cgi-bin/index.pl</pre>
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh <p>would cause the CGI script <code>/cgi-bin/index.pl</code> to be
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh executed if neither <code>index.html</code> or <code>index.txt</code>
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh existed in a directory.</p>
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh <p>A single argument of "disabled" prevents <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> from
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh searching for an index. An argument of "disabled" will be interpreted
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh literally if it has any arguments before or after it, even if they are "disabled"
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh as well.</p>
daf4d4394c14b23e06073c13806259a2dc7574b4humbedooh <p><strong>Note:</strong> Multiple <code class="directive">DirectoryIndex</code>
daf4d4394c14b23e06073c13806259a2dc7574b4humbedooh directives within the <a href="/sections.html"><em>same context</em></a> will add
63de18ba5e922ffaab500317d7d1d0ad6b27b7e2covener to the list of resources to look for rather than replace:
c31366647a84875104bb9cbca53280b607c37595covener <pre class="prettyprint lang-config"># Example A: Set index.html as an index page, then add index.php to that list as well.
c31366647a84875104bb9cbca53280b607c37595covener<Directory "/foo">
c31366647a84875104bb9cbca53280b607c37595covener DirectoryIndex index.html
c31366647a84875104bb9cbca53280b607c37595covener DirectoryIndex index.php
c31366647a84875104bb9cbca53280b607c37595covener</Directory>
c31366647a84875104bb9cbca53280b607c37595covener# Example B: This is identical to example A, except it's done with a single directive.
c31366647a84875104bb9cbca53280b607c37595covener<Directory "/foo">
c31366647a84875104bb9cbca53280b607c37595covener</Directory>
c31366647a84875104bb9cbca53280b607c37595covener# Example C: To replace the list, you must explicitly reset it first:
c31366647a84875104bb9cbca53280b607c37595covener# In this example, only index.php will remain as an index resource.
1462ff536f1b939bb337766b2056109c29664c4erbowen<Directory "/foo">
c31366647a84875104bb9cbca53280b607c37595covener DirectoryIndex index.html
c31366647a84875104bb9cbca53280b607c37595covener DirectoryIndex disabled
c31366647a84875104bb9cbca53280b607c37595covener DirectoryIndex index.php
c31366647a84875104bb9cbca53280b607c37595covener</Directory></pre>
e487d6c09669296f94a5190cc34586a98e624a00nd<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
c31366647a84875104bb9cbca53280b607c37595covener<div class="directive-section"><h2><a name="DirectoryIndexRedirect" id="DirectoryIndexRedirect">DirectoryIndexRedirect</a> <a name="directoryindexredirect" id="directoryindexredirect">Directive</a></h2>
9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures an external redirect for directory indexes.
c31366647a84875104bb9cbca53280b607c37595covener<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DirectoryIndexRedirect on | off | permanent | temp | seeother |
4cc6016bd30b0852222630a0ed62805e36f345d1nd<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DirectoryIndexRedirect off</code></td></tr>
4cc6016bd30b0852222630a0ed62805e36f345d1nd<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
4cc6016bd30b0852222630a0ed62805e36f345d1nd<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Indexes</td></tr>
4cc6016bd30b0852222630a0ed62805e36f345d1nd<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
4cc6016bd30b0852222630a0ed62805e36f345d1nd<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr>
4cc6016bd30b0852222630a0ed62805e36f345d1nd<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in version 2.3.14 and later</td></tr>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <p>By default, the <code class="directive">DirectoryIndex</code> is selected
4cc6016bd30b0852222630a0ed62805e36f345d1nd and returned transparently to the client. <code class="directive">DirectoryIndexRedirect</code> causes an external redirect
4cc6016bd30b0852222630a0ed62805e36f345d1nd to instead be issued.</p>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <li><code>on</code>: issues a 302 redirection to the index resource.</li>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <li><code>off</code>: does not issue a redirection. This is the legacy behaviour of mod_dir.</li>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <li><code>permanent</code>: issues a 301 (permanent) redirection to the index resource.</li>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <li><code>temp</code>: this has the same effect as <code>on</code></li>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <li><code>seeother</code>: issues a 303 redirection (also known as "See Other") to the index resource.</li>
90361ddfb3a8abaa0f8fb1729732062c78d8dc50niq <li><var>3xx-code</var>: issues a redirection marked by the chosen 3xx code.</li>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">DirectoryIndexRedirect on</pre>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <p>A request for <code>http://example.com/docs/</code> would
95d05f094d56c5986659f1aa7e57f258850b1287nd return a temporary redirect to <code>http://example.com/docs/index.html</code>
4cc6016bd30b0852222630a0ed62805e36f345d1nd if it exists.</p>
b622a4d68a26af5386003d4c69a950bc1e157005rbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
b622a4d68a26af5386003d4c69a950bc1e157005rbowen<div class="directive-section"><h2><a name="DirectorySlash" id="DirectorySlash">DirectorySlash</a> <a name="directoryslash" id="directoryslash">Directive</a></h2>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Toggle trailing slash redirects on or off</td></tr>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DirectorySlash On|Off</code></td></tr>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DirectorySlash On</code></td></tr>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Indexes</td></tr>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <p>The <code class="directive">DirectorySlash</code> directive determines whether
4cc6016bd30b0852222630a0ed62805e36f345d1nd <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> should fixup URLs pointing to a directory or
4cc6016bd30b0852222630a0ed62805e36f345d1nd <p>Typically if a user requests a resource without a trailing slash, which
4cc6016bd30b0852222630a0ed62805e36f345d1nd points to a directory, <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> redirects him to the same
4cc6016bd30b0852222630a0ed62805e36f345d1nd resource, but <em>with</em> trailing slash for some good reasons:</p>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <li>The user is finally requesting the canonical URL of the resource</li>
a01665d9a2baf14d3928df50e5c36c8e84d71b41humbedooh <li><code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> works correctly. Since it doesn't emit
a01665d9a2baf14d3928df50e5c36c8e84d71b41humbedooh the path in the link, it would point to the wrong path.</li>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <li><code class="directive"><a href="#directoryindex">DirectoryIndex</a></code> will be evaluated
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <em>only</em> for directories requested with trailing slash.</li>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <li>Relative URL references inside html pages will work correctly.</li>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <p>If you don't want this effect <em>and</em> the reasons above don't
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen apply to you, you can turn off the redirect as shown below. However,
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen be aware that there are possible security implications to doing
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <pre class="prettyprint lang-config"># see security warning below!
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen DirectorySlash Off
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen SetHandler some-handler
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen</Location></pre>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh <p>Turning off the trailing slash redirect may result in an information
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh disclosure. Consider a situation where <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> is
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen active (<code>Options +Indexes</code>) and <code class="directive"><a href="#directoryindex">DirectoryIndex</a></code> is set to a valid resource (say,
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <code>index.html</code>) and there's no other special handler defined for
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen that URL. In this case a request with a trailing slash would show the
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <code>index.html</code> file. <strong>But a request without trailing slash
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <p>Also note that some browsers may erroneously change POST requests into GET
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen (thus discarding POST data) when a redirect is issued.</p>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<div class="directive-section"><h2><a name="FallbackResource" id="FallbackResource">FallbackResource</a> <a name="fallbackresource" id="fallbackresource">Directive</a></h2>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a default URL for requests that don't map to a file</td></tr>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FallbackResource disabled | <var>local-url</var></code></td></tr>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>disabled - httpd will return 404 (Not Found)</code></td></tr>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
4f32f36773e84a2ec9a930f85b44d31fc0c0c2cfigalic<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Indexes</td></tr>
4f32f36773e84a2ec9a930f85b44d31fc0c0c2cfigalic<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>The <code>disabled</code> argument is available in version 2.4.4 and
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh <p>Use this to set a handler for any URL that doesn't map to anything
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh in your filesystem, and would otherwise return HTTP 404 (Not Found).
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen For example</p>
b686b6a420bde7f78c416b90be11db94cb789979nd <pre class="prettyprint lang-config">FallbackResource /not-404.php</pre>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd <p>will cause requests for non-existent files to be handled by
ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd <code>not-404.php</code>, while requests for files that exist
d28579afd45cc42da1422161721fb12f9cf366b9nd are unaffected.</p>
7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd <p>It is frequently desirable to have a single file or resource
1ac39787115a288f5e848344b1b1e8dccb1c58f1nd handle all requests to a particular directory, except those requests
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung that correspond to an existing file or script. This is often
727872d18412fc021f03969b8641810d8896820bhumbedooh referred to as a 'front controller.'</p>
0d0ba3a410038e179b695446bb149cce6264e0abnd <p>In earlier versions of httpd, this effect typically required
727872d18412fc021f03969b8641810d8896820bhumbedooh <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>, and the use of the <code>-f</code> and
cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedooh <code>-d</code> tests for file and directory existence. This now
0d0ba3a410038e179b695446bb149cce6264e0abnd requires only one line of configuration.</p>
cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedooh <pre class="prettyprint lang-config">FallbackResource /index.php</pre>
0d0ba3a410038e179b695446bb149cce6264e0abnd <p>Existing files, such as images, css files, and so on, will be
0d0ba3a410038e179b695446bb149cce6264e0abnd served normally.</p>
0d0ba3a410038e179b695446bb149cce6264e0abnd <p>Use the <code>disabled</code> argument to disable that feature
d58b9b74499c53472ad668dd918299f70c0c457ahumbedooh if inheritance from a parent directory is not desired.</p>
0d0ba3a410038e179b695446bb149cce6264e0abnd <p>In a sub-URI, such as <em>http://example.com/blog/</em> this
0d0ba3a410038e179b695446bb149cce6264e0abnd <em>sub-URI</em> has to be supplied as <var>local-url</var>:</p>
0d0ba3a410038e179b695446bb149cce6264e0abnd <pre class="prettyprint lang-config"><Directory "/web/example.com/htdocs/blog">
0d0ba3a410038e179b695446bb149cce6264e0abnd</Directory>
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh FallbackResource disabled
5effc8b39fae5cd169d17f342bfc265705840014rbowen</Directory></pre>
1acae7fb634ac2b01682507175e072b168995e0dcolm<p><span>Available Languages: </span><a href="/en/mod/mod_dir.html" title="English"> en </a> |
</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_dir.html';
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
<p class="apache">Copyright 2015 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--