Mod alias » History » Revision 14
Revision 13 (zkv, 2008-11-21 23:26) → Revision 14/17 (heavyhttpd, 2009-01-10 22:11)
h1. Alias
{{>toc}}
*Module: mod_alias*
h2. Description
The alias module is used to specify a special document-root for a given url-subset.
h2. Options
alias.url
Rewrites the document-root for a URL-subset
Default: empty
*Example of usage*:
<pre>
alias.url = ( "/cgi-bin/" => "/var/www/servers/www.example.org/cgi-bin/" )
</pre>
*You can add additional aliases by:*
<pre>
alias.url += ( "/content" => "/var/www/servers/www.somecontent.org/" )
</pre>
*Important note*:
As trailing slashes are stripped from the url before matching an alias, the alias "/content/ => "/dirtocontent/" will not match the url "/content/"; it matches only something like "/content/somefile" or "/content/somesubdir/".
So in most cases you shouldn't use a trailing slash on the left side (but use it on the right side!): "/content" => "/dirtocontent/"
Now "/content_x1/" is mapped to "/dirtocontent/_x1", "/content/" -> "/dirtocontent/" and "/content/somefile" -> "/dirtocontent//somefile" "/content//somefile" (yes, double slash).
If you don't use it on the right side too, "/content_x1/" is mapped to "/dirtocontent_x1", which you probably don't want.