diff options
Diffstat (limited to 'docs/manual/mod/mod_alias.html.en.utf8')
| -rw-r--r-- | docs/manual/mod/mod_alias.html.en.utf8 | 53 |
1 files changed, 48 insertions, 5 deletions
diff --git a/docs/manual/mod/mod_alias.html.en.utf8 b/docs/manual/mod/mod_alias.html.en.utf8 index 3137575449..9d9594eb3d 100644 --- a/docs/manual/mod/mod_alias.html.en.utf8 +++ b/docs/manual/mod/mod_alias.html.en.utf8 @@ -76,6 +76,7 @@ <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#alias">Alias</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#aliasmatch">AliasMatch</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#aliaspreservepath">AliasPreservePath</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#redirect">Redirect</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#redirectmatch">RedirectMatch</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#redirectpermanent">RedirectPermanent</a></li> @@ -206,6 +207,23 @@ Alias "/foo" "/gaq"</pre> </LocationMatch></pre> + <p>Note that when the <code class="directive">AliasPreservePath</code> + directive is on, the full path is mapped to the destination. When + the directive is off, all URLs are mapped to the single target + URL.</p> + + <pre class="prettyprint lang-config"># /files/foo and /files/bar mapped to /ftp/pub/files/foo and /ftp/pub/files/bar +<Location "/files"> + AliasPreservePath on + Alias "/ftp/pub/files" +</Location> +# /errors/foo and /errors/bar mapped to /var/www/errors.html +<Location "/errors"> + AliasPreservePath off + Alias "/var/www/errors.html" +</Location></pre> + + </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -293,6 +311,31 @@ AliasMatch "^/image/(.*)\.gif$" "/files/gif.images/$1.gif"</pre> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AliasPreservePath" id="AliasPreservePath">AliasPreservePath</a> <a name="aliaspreservepath" id="aliaspreservepath">Directive</a> <a title="Permanent link" href="#aliaspreservepath" class="permalink">¶</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Map the full path after the alias in a location.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AliasPreservePath OFF|ON</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AliasPreservePath OFF</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</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_alias</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>2.5.1 and later</td></tr> +</table> + <p>When using the two parameter version of the + <code class="directive">Alias</code> directive, the full path after the alias + is preserved. When using the one parameter version of the + <code class="directive">Alias</code> directive inside a + <code class="directive">Location</code> directive, the full path is dropped, + and all URLs are mapped to the target expression.</p> + + <p>To make the one parameter version of the + <code class="directive">Alias</code> directive preserve paths in the same way + that the two parameter version of the <code class="directive">Alias</code> + directive, enable this setting.</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="Redirect" id="Redirect">Redirect</a> <a name="redirect" id="redirect">Directive</a> <a title="Permanent link" href="#redirect" class="permalink">¶</a></h2> <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sends an external redirect asking the client to fetch @@ -468,17 +511,17 @@ a different URL</td></tr> <div class="directive-section"><h2><a name="RedirectRelative" id="RedirectRelative">RedirectRelative</a> <a name="redirectrelative" id="redirectrelative">Directive</a> <a title="Permanent link" href="#redirectrelative" class="permalink">¶</a></h2> <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Allows relative redirect targets.</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RedirectRelative OFF|ON</code></td></tr> -<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>RedirectRelative OFF</code></td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RedirectRelative On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>RedirectRelative Off</code></td></tr> <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</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_alias</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>2.5.1 and later</td></tr> </table> - <p>By default, if the target URL of a <code class="directive">Redirect</code> + <p>By default, if the target URL of a <code class="directive"><a href="#redirect">Redirect</a></code> directive is a relative URL beginning with a '/' character, the server - converts it to a an absolute URL before responding to the client. By - setting <code class="directive">RedirectRelative</code> to the value "ON", + converts it to an absolute URL before responding to the client. By + setting <code class="directive">RedirectRelative</code> to the value "On", the relative URL is presented to the client directly.</p> |