mod_dir.html.en revision 650401e2cb916188d0e1a280dfa78dd67e24ce3b
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>
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen<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="#directoryindex">DirectoryIndex</a></li>
c31366647a84875104bb9cbca53280b607c37595covener<li><img alt="" src="/images/down.gif" /> <a href="#directoryindexredirect">DirectoryIndexRedirect</a></li>
4cc6016bd30b0852222630a0ed62805e36f345d1nd<li><img alt="" src="/images/down.gif" /> <a href="#directoryslash">DirectorySlash</a></li>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<li><img alt="" src="/images/down.gif" /> <a href="#fallbackresource">FallbackResource</a></li>
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh<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="DirectoryIndex" id="DirectoryIndex">DirectoryIndex</a> <a name="directoryindex" id="directoryindex">Directive</a></h2>
b686b6a420bde7f78c416b90be11db94cb789979nd<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>List of resources to look for when the client requests
b686b6a420bde7f78c416b90be11db94cb789979nd<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DirectoryIndex
b6d2c204c150843e48f6787c1090ae75b718896ecovener disabled | <var>local-url</var> [<var>local-url</var>] ...</code></td></tr>
b686b6a420bde7f78c416b90be11db94cb789979nd<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DirectoryIndex index.html</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>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>The <code class="directive">DirectoryIndex</code> directive sets the
06ba4a61654b3763ad65f52283832ebf058fdf1cslive list of resources to look for, when the client requests an index
1887c0b8ceab2c8d64a1e5b3aa512e77b86b49fayoshiki of the directory by specifying a / at the end of the directory
f5cbf3a7818c08d2f19c04fdf4f47257eea7d3c6nd name. <var>Local-url</var> is the (%-encoded) URL of a document on
06ba4a61654b3763ad65f52283832ebf058fdf1cslive the server relative to the requested directory; it is usually the
06ba4a61654b3763ad65f52283832ebf058fdf1cslive name of a file in the directory. Several URLs may be given, in
06ba4a61654b3763ad65f52283832ebf058fdf1cslive which case the server will return the first one that it finds. If
06ba4a61654b3763ad65f52283832ebf058fdf1cslive none of the resources exist and the <code>Indexes</code> option is
06ba4a61654b3763ad65f52283832ebf058fdf1cslive set, the server will generate its own listing of the
06ba4a61654b3763ad65f52283832ebf058fdf1cslive directory.</p>
e487d6c09669296f94a5190cc34586a98e624a00nd <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">
f5cbf3a7818c08d2f19c04fdf4f47257eea7d3c6nd DirectoryIndex index.html
c31366647a84875104bb9cbca53280b607c37595covener <p>then a request for <code>http://example.com/docs/</code> would
c31366647a84875104bb9cbca53280b607c37595covener return <code>http://example.com/docs/index.html</code> if it
06ba4a61654b3763ad65f52283832ebf058fdf1cslive exists, or would list the directory if it did not.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Note that the documents do not need to be relative to the
06ba4a61654b3763ad65f52283832ebf058fdf1cslive directory;</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>would cause the CGI script <code>/cgi-bin/index.pl</code> to be
f5cbf3a7818c08d2f19c04fdf4f47257eea7d3c6nd executed if neither <code>index.html</code> or <code>index.txt</code>
f5cbf3a7818c08d2f19c04fdf4f47257eea7d3c6nd existed in a directory.</p>
9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf <p>A single argument of "disabled" prevents <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> from
e2d704f65ae715639ae9d21d98bbf19ebcad58ffhumbedooh searching for an index. An argument of "disabled" will be interpreted
b6d2c204c150843e48f6787c1090ae75b718896ecovener literally if it has any arguments before or after it, even if they are "disabled"
b6d2c204c150843e48f6787c1090ae75b718896ecovener as well.</p>
02c8e4c50471e515a88620bddba4d15ad2384f8bgryzor <p><strong>Note:</strong> Multiple <code class="directive">DirectoryIndex</code>
02c8e4c50471e515a88620bddba4d15ad2384f8bgryzor directives within the <a href="/sections.html"><em>same context</em></a> will add
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh to the list of resources to look for rather than replace:
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh# Example A: Set index.html as an index page, then add index.php to that list as well.
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh<Directory /foo>
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh DirectoryIndex index.html
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh DirectoryIndex index.php
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh</Directory>
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh# Example B: This is identical to example A, except it's done with a single directive.
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh<Directory /foo>
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh</Directory>
8db1460fc707c9d9e2a8286808244254d4a0c949humbedooh# Example C: To replace the list, you must explicitly reset it first:
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh# In this example, only index.php will remain as an index resource.
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh<Directory /foo>
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh DirectoryIndex index.html
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh DirectoryIndex disabled
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh DirectoryIndex index.php
0332c9af2f43b2bf29133b19d06306a735b2d4a6humbedooh</Directory>
c31366647a84875104bb9cbca53280b607c37595covener<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>
c31366647a84875104bb9cbca53280b607c37595covener<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures an external redirect for directory indexes.
9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DirectoryIndexRedirect on | off | permanent | temp | seeother |
c31366647a84875104bb9cbca53280b607c37595covener<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DirectoryIndexRedirect off</code></td></tr>
c31366647a84875104bb9cbca53280b607c37595covener<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
c31366647a84875104bb9cbca53280b607c37595covener<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Indexes</td></tr>
c31366647a84875104bb9cbca53280b607c37595covener<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
c31366647a84875104bb9cbca53280b607c37595covener<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr>
1462ff536f1b939bb337766b2056109c29664c4erbowen<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in version 2.3.14 and later</td></tr>
c31366647a84875104bb9cbca53280b607c37595covener <p>By default, the <code class="directive">DirectoryIndex</code> is selected
c31366647a84875104bb9cbca53280b607c37595covener and returned transparently to the client. <code class="directive">DirectoryIndexRedirect</code> causes an external redirect
c31366647a84875104bb9cbca53280b607c37595covener to instead be issued.</p>
650401e2cb916188d0e1a280dfa78dd67e24ce3bgryzor The argument can be :
650401e2cb916188d0e1a280dfa78dd67e24ce3bgryzor <li><code>on</code> : issues a 302 redirection to the index resource.</li>
650401e2cb916188d0e1a280dfa78dd67e24ce3bgryzor <li><code>off</code> : does not issue a redirection. This is the legacy behaviour of mod_dir.</li>
650401e2cb916188d0e1a280dfa78dd67e24ce3bgryzor <li><code>permanent</code> : issues a 301 (permanent) redirection to the index resource.</li>
650401e2cb916188d0e1a280dfa78dd67e24ce3bgryzor <li><code>temp</code> : this has the same effect as <code>on</code></li>
650401e2cb916188d0e1a280dfa78dd67e24ce3bgryzor <li><code>seeother</code> : issues a 303 redirection (also known as "See Other") to the index resource.</li>
650401e2cb916188d0e1a280dfa78dd67e24ce3bgryzor <li><var>3xx-code</var> : issues a redirection marked by the chosen 3xx code.</li>
e487d6c09669296f94a5190cc34586a98e624a00nd <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">
c31366647a84875104bb9cbca53280b607c37595covener DirectoryIndexRedirect on
c31366647a84875104bb9cbca53280b607c37595covener <p>A request for <code>http://example.com/docs/</code> would
9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf return a temporary redirect to <code>http://example.com/docs/index.html</code>
c31366647a84875104bb9cbca53280b607c37595covener if it exists.</p>
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="DirectorySlash" id="DirectorySlash">DirectorySlash</a> <a name="directoryslash" id="directoryslash">Directive</a></h2>
4cc6016bd30b0852222630a0ed62805e36f345d1nd<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Toggle trailing slash redirects on or off</td></tr>
4cc6016bd30b0852222630a0ed62805e36f345d1nd<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DirectorySlash On|Off</code></td></tr>
4cc6016bd30b0852222630a0ed62805e36f345d1nd<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>DirectorySlash On</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>
b622a4d68a26af5386003d4c69a950bc1e157005rbowen <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
90361ddfb3a8abaa0f8fb1729732062c78d8dc50niq 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>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <li><code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> works correctly. Since it doesn't emit
4cc6016bd30b0852222630a0ed62805e36f345d1nd 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
4cc6016bd30b0852222630a0ed62805e36f345d1nd <em>only</em> for directories requested with trailing slash.</li>
95d05f094d56c5986659f1aa7e57f258850b1287nd <li>Relative URL references inside html pages will work correctly.</li>
b622a4d68a26af5386003d4c69a950bc1e157005rbowen <p>If you don't want this effect <em>and</em> the reasons above don't
b622a4d68a26af5386003d4c69a950bc1e157005rbowen apply to you, you can turn off the redirect as shown below. However,
b622a4d68a26af5386003d4c69a950bc1e157005rbowen be aware that there are possible security implications to doing
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh# see security warning below!
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh DirectorySlash Off
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh SetHandler some-handler
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh</Location>
4cc6016bd30b0852222630a0ed62805e36f345d1nd <p>Turning off the trailing slash redirect may result in an information
4cc6016bd30b0852222630a0ed62805e36f345d1nd disclosure. Consider a situation where <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> is
4cc6016bd30b0852222630a0ed62805e36f345d1nd active (<code>Options +Indexes</code>) and <code class="directive"><a href="#directoryindex">DirectoryIndex</a></code> is set to a valid resource (say,
4cc6016bd30b0852222630a0ed62805e36f345d1nd <code>index.html</code>) and there's no other special handler defined for
4cc6016bd30b0852222630a0ed62805e36f345d1nd that URL. In this case a request with a trailing slash would show the
4cc6016bd30b0852222630a0ed62805e36f345d1nd <code>index.html</code> file. <strong>But a request without trailing slash
02c8e4c50471e515a88620bddba4d15ad2384f8bgryzor <p>Also note that some browsers may erroneously change POST requests into GET
a01665d9a2baf14d3928df50e5c36c8e84d71b41humbedooh (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>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<div class="directive-section"><h2><a name="FallbackResource" id="FallbackResource">FallbackResource</a> <a name="fallbackresource" id="fallbackresource">Directive</a></h2>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<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>
02c8e4c50471e515a88620bddba4d15ad2384f8bgryzor<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FallbackResource disabled | <var>local-url</var></code></td></tr>
02c8e4c50471e515a88620bddba4d15ad2384f8bgryzor<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>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Indexes</td></tr>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen<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>Use this to set a handler for any URL that doesn't map to anything
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen in your filesystem, and would otherwise return HTTP 404 (Not Found).
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen For example</p>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh FallbackResource /not-404.php
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <p>will cause requests for non-existent files to be handled by
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <code>not-404.php</code>, while requests for files that exist
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen are unaffected.</p>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <p>It is frequently desirable to have a single file or resource
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen handle all requests to a particular directory, except those requests
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen that correspond to an existing file or script. This is often
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen referred to as a 'front controller.'</p>
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <p>In earlier versions of httpd, this effect typically required
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>, and the use of the <code>-f</code> and
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <code>-d</code> tests for file and directory existence. This now
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen requires only one line of configuration.</p>
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh FallbackResource /index.php
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen <p>Existing files, such as images, css files, and so on, will be
9750e43c0e01cbb2cda812fef5f341de512f03f5rbowen served normally.</p>
02c8e4c50471e515a88620bddba4d15ad2384f8bgryzor <p>Use the <code>disabled</code> argument to disable that feature
02c8e4c50471e515a88620bddba4d15ad2384f8bgryzor if inheritance from a parent directory is not desired.</p>
4f32f36773e84a2ec9a930f85b44d31fc0c0c2cfigalic <p>In a sub-URI, such as <em>http://example.com/blog/</em> this
4f32f36773e84a2ec9a930f85b44d31fc0c0c2cfigalic <em>sub-URI</em> has to be supplied as <var>local-url</var>:</p>
02c8e4c50471e515a88620bddba4d15ad2384f8bgryzor</Directory>
02c8e4c50471e515a88620bddba4d15ad2384f8bgryzor FallbackResource disabled
23255b04d466bf2621c4dd4ae1b025a9c5639e1ahumbedooh</Directory>
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>
727872d18412fc021f03969b8641810d8896820bhumbedooh</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>
727872d18412fc021f03969b8641810d8896820bhumbedoohvar comments_shortname = 'httpd';
cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedoohvar comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_dir.html';
0d0ba3a410038e179b695446bb149cce6264e0abnd(function(w, d) {
cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedooh if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
727872d18412fc021f03969b8641810d8896820bhumbedooh d.write('<div id="comments_thread"><\/div>');
0d0ba3a410038e179b695446bb149cce6264e0abnd var s = d.createElement('script');
ac082aefa89416cbdc9a1836eaf3bed9698201c8humbedooh s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
0d0ba3a410038e179b695446bb149cce6264e0abnd (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
727872d18412fc021f03969b8641810d8896820bhumbedooh d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
0d0ba3a410038e179b695446bb149cce6264e0abnd})(window, document);
1a1356f375e36db7bee379ea0684ab389579f798rbowen<p class="apache">Copyright 2013 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>
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen<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[//><!--
0d0ba3a410038e179b695446bb149cce6264e0abndif (typeof(prettyPrint) !== 'undefined') {
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd prettyPrint();