Alias Directive
Description: | Maps URLs to filesystem locations |
---|---|
Syntax: | Alias URL-path file-path|directory-path |
Context: | server config, virtual host |
Status: | Base |
Module: | mod_alias |
The Alias
directive allows documents to be stored in the local filesystem other than under the DocumentRoot
. URLs with a (%-decoded) path beginning with url-path will be mapped to local files beginning with directory-path.
Example:
Alias /image /ftp/pub/image
A request for http://myserver/image/foo.gif would cause the server to return the file /ftp/pub/image/foo.gif.
Note that if you include a trailing / on the url-path then the server will require a trailing / in order to expand the alias. That is, if you use Alias /icons/ /usr/local/apache/icons/
then the url /icons
will not be aliased.
Note that you may need to specify additional <Directory>
sections which cover the destination of aliases. Aliasing occurs before <Directory>
sections are checked, so only the destination of aliases are affected. (Note however <Location>
sections are run through once before aliases are performed, so they will apply.)
In particular, if you are creating an Alias
to a directory outside of your DocumentRoot
, you may need to explicitly permit access to the target directory.
Example:
Alias /image /ftp/pub/image
<Directory /ftp/pub/image>
Order allow,deny
Allow from all
</Directory>