Mod alias » History » Revision 14

Revision 13 (zkv, 2008-11-21 23:26) → Revision 14/16 (heavyhttpd, 2009-01-10 22:11)

h1. Alias 


 *Module: mod_alias* 

 h2. Description 

 The alias module is used to specify a special document-root for a given url-subset. 

 h2. Options 

 Rewrites the document-root for a URL-subset 
 Default: empty 

 *Example of usage*: 


     alias.url = ( "/cgi-bin/" => "/var/www/servers/" ) 


 *You can add additional aliases by:* 

     alias.url += ( "/content" => "/var/www/servers/" ) 


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