Lighttpd

TracNav(DocsToc)

#!rst
=====
Alias
=====

-----------------
Module: mod_alias
-----------------

.. meta::
  :keywords: lighttpd, alias

.. contents:: Table of Contents

Description
===========

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

Options
=======

alias.url
  rewrites the document-root for a URL-subset

  Default: empty

  Example: ::

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

  You can add additional aliases by: ::

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

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" -> "/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.