diff options
author | Rich Bowen <rbowen@apache.org> | 2009-09-16 13:51:53 +0000 |
---|---|---|
committer | Rich Bowen <rbowen@apache.org> | 2009-09-16 13:51:53 +0000 |
commit | 05124024ae5984bbf551c1d0db2c59129f51ebbe (patch) | |
tree | 73966ee8f5792e7dfbdf9c21a6efb2b522d378a3 /docs/manual/mod/mod_dir.html.en | |
parent | c2a484bbb120036d2c4915f3bc16d474fbb22e20 (diff) | |
download | httpd-05124024ae5984bbf551c1d0db2c59129f51ebbe.tar.gz |
Just a little additional verbiage for the FallbackResource directive.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@815782 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/mod/mod_dir.html.en')
-rw-r--r-- | docs/manual/mod/mod_dir.html.en | 59 |
1 files changed, 36 insertions, 23 deletions
diff --git a/docs/manual/mod/mod_dir.html.en b/docs/manual/mod/mod_dir.html.en index 020b7ef75e..346ad9b13c 100644 --- a/docs/manual/mod/mod_dir.html.en +++ b/docs/manual/mod/mod_dir.html.en @@ -58,35 +58,13 @@ </div> <div id="quickview"><h3 class="directives">Directives</h3> <ul id="toc"> -<li><img alt="" src="../images/down.gif" /> <a href="#defaultmapping">DefaultMapping</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#directoryindex">DirectoryIndex</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#directoryslash">DirectorySlash</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#fallbackresource">FallbackResource</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> -<div class="directive-section"><h2><a name="DefaultMapping" id="DefaultMapping">DefaultMapping</a> <a name="defaultmapping" id="defaultmapping">Directive</a></h2> -<table class="directive"> -<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>DefaultMapping <var>local-url</var></code></td></tr> -<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>None - 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> -<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Indexes</td></tr> -<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr> -<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr> -</table> - <p>Use this to set a handler for any URL that doesn't map to anything - in your filesystem, and would otherwise return HTTP 404 (Not Found). - For example</p> - <div class="example"><p><code> - <code>DefaultMapping default.php</code> - </code></p></div> - <p>will cause requests for non-existent files to be handled by - <code>default.php</code>, while requests for files that exist - are unaffected.</p> - -</div> -<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="DirectoryIndex" id="DirectoryIndex">DirectoryIndex</a> <a name="directoryindex" id="directoryindex">Directive</a></h2> <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>List of resources to look for when the client requests @@ -189,6 +167,41 @@ a directory</td></tr> </div> </div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="FallbackResource" id="FallbackResource">FallbackResource</a> <a name="fallbackresource" id="fallbackresource">Directive</a></h2> +<table class="directive"> +<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 <var>local-url</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>None - 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> +<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Indexes</td></tr> +<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dir</td></tr> +</table> + <p>Use this to set a handler for any URL that doesn't map to anything + in your filesystem, and would otherwise return HTTP 404 (Not Found). + For example</p> + <div class="example"><p><code> + <code>FallbackResource not-404.php</code> + </code></p></div> + <p>will cause requests for non-existent files to be handled by + <code>not-404.php</code>, while requests for files that exist + are unaffected.</p> + <p>It is frequently desirable to have a single file or resource + handle all requests to a particular directory, except those requests + that correspond to an existing file or script. This is often + referred to as a 'front controller.'</p> + <p>In earlier versions of httpd, this effect typically required + <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, and the use of the <code>-f</code> and + <code>-d</code> tests for file and directory existence. This now + requires only one line of configuration.</p> + <div class="example"><p><code> + <code>FallbackResource index.php</code> + </code></p></div> + <p>Existing files, such as images, css files, and so on, will be + served normally.</p> + +</div> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_dir.html" title="English"> en </a> | |