======================
Simple Virtual-Hosting
======================

------------------------
Module: mod_simple_vhost
------------------------

:Author: Jan Kneschke
:Date: $Date: 2004/08/29 09:43:49 $
:Revision: $Revision: 1.1 $

:abstract:
  virtual hosting
  
.. meta::
  :keywords: lighttpd, virtual hosting
  
.. contents:: Table of Contents

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

Simple assumption:

Every virtual host is in a direction below a base directory in a path that
is the same as the name of the vhost. Below this vhost-path might be a
extra directory which is the document-root of the vhost.

The document-root for each vhost is build from three values:

- server-root
- hostname
- document-root

Either the absolute documentroot is build by ::

  server-root + hostname + document-root
  
or if this path does not exist by ::

  server-root + default-host + document-root
  
A small example should make this thinking clean: ::

  /var/www/
  /var/www/logs/
  /var/www/servers/
  /var/www/servers/www.example.org/
  /var/www/servers/www.example.org/lib/
  /var/www/servers/www.example.org/pages/
  /var/www/servers/mail.example.org/
  /var/www/servers/mail.example.org/lib/
  /var/www/servers/mail.example.org/pages/
  
  simple-vhost.server-root = "/var/www/servers/"
  simple-vhost.default-host = "www.example.org"
  simple-vhost.document-root = "pages"

You can use symbolic links to map several hostnames to the same directory.

Options
=======

simple-vhost.server-root
  root of the virtual hosting
  
simple-vhost.default-host
  use this hostname if the 
  
simple-vhost.document-root
  path below the vhost-directory
  
