From: Rich Bowen Date: Wed, 16 Sep 2009 13:51:53 +0000 (+0000) Subject: Just a little additional verbiage for the FallbackResource directive. X-Git-Tag: 2.3.3~288 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=05124024ae5984bbf551c1d0db2c59129f51ebbe;p=apache 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 --- 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,34 +58,12 @@

Directives

-
top
-

DefaultMapping Directive

- - - - - - - - -
Description:Define a default URL for requests that don't map to a file
Syntax:DefaultMapping local-url
Default:None - httpd will return 404 (Not Found)
Context:server config, virtual host, directory, .htaccess
Override:Indexes
Status:Base
Module:mod_dir
-

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

-

- DefaultMapping default.php -

-

will cause requests for non-existent files to be handled by - default.php, while requests for files that exist - are unaffected.

- -
top

DirectoryIndex Directive

@@ -188,6 +166,41 @@ a directory would list the directory contents.

+ +
top
+

FallbackResource Directive

+
+ + + + + + + +
Description:Define a default URL for requests that don't map to a file
Syntax:FallbackResource local-url
Default:None - httpd will return 404 (Not Found)
Context:server config, virtual host, directory, .htaccess
Override:Indexes
Status:Base
Module:mod_dir
+

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

+

+ FallbackResource not-404.php +

+

will cause requests for non-existent files to be handled by + not-404.php, while requests for files that exist + are unaffected.

+

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.'

+

In earlier versions of httpd, this effect typically required + mod_rewrite, and the use of the -f and + -d tests for file and directory existence. This now + requires only one line of configuration.

+

+ FallbackResource index.php +

+

Existing files, such as images, css files, and so on, will be + served normally.

+
diff --git a/docs/manual/mod/mod_dir.xml b/docs/manual/mod/mod_dir.xml index 28d08e4a4e..bae5f24490 100644 --- a/docs/manual/mod/mod_dir.xml +++ b/docs/manual/mod/mod_dir.xml @@ -174,6 +174,19 @@ a directory

will cause requests for non-existent files to be handled by not-404.php, while requests for files that exist are unaffected.

+

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.'

+

In earlier versions of httpd, this effect typically required + mod_rewrite, and the use of the -f and + -d tests for file and directory existence. This now + requires only one line of configuration.

+ + FallbackResource index.php + +

Existing files, such as images, css files, and so on, will be + served normally.