mirror of
https://github.com/apache/httpd.git
synced 2025-08-26 05:42:34 +03:00
b2ab672f99
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@76995 13f79535-47bb-0310-9956-ffa450edef68
94 lines
3.7 KiB
HTML
94 lines
3.7 KiB
HTML
<!--%hypertext -->
|
|
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<TITLE>Apache module mod_alias</TITLE>
|
|
</HEAD>
|
|
|
|
<BODY>
|
|
<IMG SRC="../images/apache_sub.gif" ALT="">
|
|
<!--/%hypertext -->
|
|
<H1>Module mod_alias</h1>
|
|
|
|
This module is contained in the <code>mod_alias.c</code> file, and
|
|
is compiled in by default. It provides for mapping different parts of the
|
|
host filesystem in the the document tree, and for URL redirection.
|
|
|
|
<!--%hypertext -->
|
|
<menu>
|
|
<li><A HREF="#alias">Alias</A>
|
|
<li><A HREF="#redirect">Redirect</A>
|
|
<li><A HREF="#scriptalias">ScriptAlias</A>
|
|
</menu>
|
|
<hr>
|
|
<!--/%hypertext -->
|
|
|
|
<A name="alias"><h2>Alias</h2></A>
|
|
<!--%plaintext <?INDEX {\tt Alias} directive> -->
|
|
<strong>Syntax:</strong> Alias <em>url-path directory-filename</em><br>
|
|
<Strong>Context:</strong> server config, virtual host<br>
|
|
<strong>Status:</strong> Base<br>
|
|
<strong>Module:</strong> mod_alias<br>
|
|
<strong>Compatibility:</strong> Alias is only available in Apache 1.1
|
|
and later<p>
|
|
|
|
The Alias directive allows documents to be stored in the local filesystem
|
|
other than under the <A HREF="core.html#documentroot">DocumentRoot</A>.
|
|
URLs with a (%-decoded) path beginning with <em>url-path</em> will be
|
|
mapped to local files beginning with <em>directory-filename</em>.
|
|
Example:
|
|
<blockquote><code>Alias /image /ftp/pub/image</code></blockquote>
|
|
A request for http://myserver/image/foo.gif would cause the server to
|
|
return the file /ftp/pub/image/foo.gif.<p>
|
|
See also <A HREF="#scriptalias">ScriptAlias</A>.<p><hr>
|
|
|
|
<A name="redirect"><h2>Redirect</h2></A>
|
|
<!--%plaintext <?INDEX {\tt Redirect} directive> -->
|
|
<strong>Syntax:</strong> Redirect <em>url-path url</em><br>
|
|
<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
|
|
<strong>Status:</strong> Base<br>
|
|
<strong>Module:</strong> mod_alias<br>
|
|
<strong>Compatibility:</strong> The directory and .htaccess context's
|
|
are only available in versions 1.1 and later<p>
|
|
|
|
The Redirect directive maps an old URL into a new one. The new URL is returned
|
|
to the client which attempts to fetch it again with the new address.
|
|
<em>Url-path</em> a (%-decoded) path; any requests for documents beginning with
|
|
this path will be returned a redirect error to a new (%-encoded) url
|
|
beginning with <em>url</em>. Example:
|
|
<blockquote><code>Redirect /service
|
|
http://foo2.bar.com/service</code></blockquote>
|
|
If the client requests http://myserver/service/foo.txt, it will be told to
|
|
access http://foo2.bar.com/service/foo.txt instead.<p>
|
|
Note: Redirect directives take precedence over Alias and ScriptAlias
|
|
directives, irrespective of their ordering in the configuration file.<p><hr>
|
|
|
|
<A name="scriptalias"><h2>ScriptAlias</h2></A>
|
|
<!--%plaintext <?INDEX {\tt ScriptAlias} directive> -->
|
|
<strong>Syntax:</strong> ScriptAlias <em>url-path directory-filename</em><br>
|
|
<Strong>Context:</strong> server config, virtual host<br>
|
|
<strong>Status:</strong> Base<br>
|
|
<strong>Module:</strong> mod_alias<br>
|
|
<strong>Compatibility:</strong> ScriptAlias is only available in Apache 1.1
|
|
and later<p>
|
|
|
|
The ScriptAlias directive has the same behaviour as the
|
|
<A HREF="#alias">Alias</A> directive, except that in addition it
|
|
marks the target directory as containing CGI scripts.
|
|
URLs with a (%-decoded) path beginning with <em>url-path</em> will be
|
|
mapped to scripts beginning with <em>directory-filename</em>.
|
|
Example:
|
|
<blockquote><code>ScriptAlias /cgi-bin/ /web/cgi-bin/</code></blockquote>
|
|
A request for http://myserver/cgi-bin/foo would cause the server to
|
|
run the script /web/cgi-bin/foo.<p>
|
|
|
|
<!--%hypertext -->
|
|
<hr>
|
|
|
|
<A HREF="../"><IMG SRC="../images/apache_home.gif" ALT="Home"></A>
|
|
<A HREF="./"><IMG SRC="../images/apache_index.gif" ALT="Index"></A>
|
|
|
|
</BODY>
|
|
</HTML>
|
|
<!--/%hypertext -->
|