mod_dir.html.en revision df4578cbf77fc9e35ccade1f01b137b7eea5ede6
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.js" type="text/javascript">
b686b6a420bde7f78c416b90be11db94cb789979nd<link href="/images/favicon.ico" rel="shortcut icon" /></head>
b686b6a420bde7f78c416b90be11db94cb789979nd<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
63de18ba5e922ffaab500317d7d1d0ad6b27b7e2covener directory.</p>
c31366647a84875104bb9cbca53280b607c37595covener <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">
c31366647a84875104bb9cbca53280b607c37595covener DirectoryIndex index.html
9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf <p>then a request for <code>http://example.com/docs/</code> would
c31366647a84875104bb9cbca53280b607c37595covener return <code>http://example.com/docs/index.html</code> if it
c31366647a84875104bb9cbca53280b607c37595covener exists, or would list the directory if it did not.</p>
c31366647a84875104bb9cbca53280b607c37595covener <p>Note that the documents do not need to be relative to the
c31366647a84875104bb9cbca53280b607c37595covener directory;</p>
1462ff536f1b939bb337766b2056109c29664c4erbowen DirectoryIndex index.html index.txt /cgi-bin/index.pl
c31366647a84875104bb9cbca53280b607c37595covener <p>would cause the CGI script <code>/cgi-bin/index.pl</code> to be
c31366647a84875104bb9cbca53280b607c37595covener executed if neither <code>index.html</code> or <code>index.txt</code>
e487d6c09669296f94a5190cc34586a98e624a00nd existed in a directory.</p>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh <p>A single argument of "disabled" prevents <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> from
e487d6c09669296f94a5190cc34586a98e624a00nd searching for an index. An argument of "disabled" will be interpreted
c31366647a84875104bb9cbca53280b607c37595covener literally if it has any arguments before or after it, even if they are "disabled"
c31366647a84875104bb9cbca53280b607c37595covener as well.</p>
c31366647a84875104bb9cbca53280b607c37595covener <p><strong>Note:</strong> Multiple <code class="directive">DirectoryIndex</code>
c31366647a84875104bb9cbca53280b607c37595covener directives within the <a href="/sections.html"><em>same context</em></a> will add
c31366647a84875104bb9cbca53280b607c37595covener to the list of resources to look for rather than replace:
4cc6016bd30b0852222630a0ed62805e36f345d1nd# Example A: Set index.html as an index page, then add index.php to that list as well.
4cc6016bd30b0852222630a0ed62805e36f345d1nd<Directory /foo>
4cc6016bd30b0852222630a0ed62805e36f345d1nd DirectoryIndex index.html
4cc6016bd30b0852222630a0ed62805e36f345d1nd DirectoryIndex index.php
4cc6016bd30b0852222630a0ed62805e36f345d1nd</Directory>
4cc6016bd30b0852222630a0ed62805e36f345d1nd# Example B: This is identical to example A, except it's done with a single directive.
4cc6016bd30b0852222630a0ed62805e36f345d1nd<Directory /foo>
94aca1822ea6eaaecfa4ee8fb58b7c3264efd944nd</Directory>
b622a4d68a26af5386003d4c69a950bc1e157005rbowen# Example C: To replace the list, you must explicitly reset it first:
4cc6016bd30b0852222630a0ed62805e36f345d1nd# In this example, only index.php will remain as an index resource.
4cc6016bd30b0852222630a0ed62805e36f345d1nd<Directory /foo>
4cc6016bd30b0852222630a0ed62805e36f345d1nd DirectoryIndex index.html
4cc6016bd30b0852222630a0ed62805e36f345d1nd DirectoryIndex disabled
4cc6016bd30b0852222630a0ed62805e36f345d1nd DirectoryIndex index.php
90361ddfb3a8abaa0f8fb1729732062c78d8dc50niq</Directory>
4cc6016bd30b0852222630a0ed62805e36f345d1nd<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
4cc6016bd30b0852222630a0ed62805e36f345d1nd<div class="directive-section"><h2><a name="DirectoryIndexRedirect" id="DirectoryIndexRedirect">DirectoryIndexRedirect</a> <a name="directoryindexredirect" id="directoryindexredirect">Directive</a></h2>
4cc6016bd30b0852222630a0ed62805e36f345d1nd<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures an external redirect for directory indexes.
b622a4d68a26af5386003d4c69a950bc1e157005rbowen<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DirectoryIndexRedirect on | off | permanent | temp | seeother |
b622a4d68a26af5386003d4c69a950bc1e157005rbowen<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>
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>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in version 2.3.14 and later</td></tr>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh <p>By default, the <code class="directive">DirectoryIndex</code> is selected
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh and returned transparently to the client. <code class="directive">DirectoryIndexRedirect</code> causes an external redirect
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh 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>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <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">
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen DirectoryIndexRedirect on
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <p>A request for <code>http://example.com/docs/</code> would
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen return a temporary redirect to <code>http://example.com/docs/index.html</code>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen if it exists.</p>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<div class="directive-section"><h2><a name="DirectorySlash" id="DirectorySlash">DirectorySlash</a> <a name="directoryslash" id="directoryslash">Directive</a></h2>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Toggle trailing slash redirects on or off</td></tr>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<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>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <p>The <code class="directive">DirectorySlash</code> directive determines whether
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> should fixup URLs pointing to a directory or
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <p>Typically if a user requests a resource without a trailing slash, which
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen points to a directory, <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> redirects him to the same
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen resource, but <em>with</em> trailing slash for some good reasons:</p>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh <li>The user is finally requesting the canonical URL of the resource</li>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh <li><code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> works correctly. Since it doesn't emit
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh the path in the link, it would point to the wrong path.</li>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh <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>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh <p>If you don't want this effect <em>and</em> the reasons above don't
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh apply to you, you can turn off the redirect as shown below. However,
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh be aware that there are possible security implications to doing
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen# see security warning below!
b686b6a420bde7f78c416b90be11db94cb789979nd DirectorySlash Off
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd SetHandler some-handler
ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd</Location>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd <p>Turning off the trailing slash redirect may result in an information
5effc8b39fae5cd169d17f342bfc265705840014rbowen disclosure. Consider a situation where <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> is
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd active (<code>Options +Indexes</code>) and <code class="directive"><a href="#directoryindex">DirectoryIndex</a></code> is set to a valid resource (say,
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd <code>index.html</code>) and there's no other special handler defined for
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd that URL. In this case a request with a trailing slash would show the
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd <code>index.html</code> file. <strong>But a request without trailing slash
<div class="directive-section"><h2><a name="FallbackResource" id="FallbackResource">FallbackResource</a> <a name="fallbackresource" id="fallbackresource">Directive</a></h2>
<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>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FallbackResource disabled | <var>local-url</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>disabled - httpd will return 404 (Not Found)</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
FallbackResource /not-404.php
<code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>, and the use of the <code>-f</code> and
FallbackResource /index.php
<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 2014 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[//><!--