Return to simple-vhost.txt CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / lighttpd / doc / outdated

Annotation of embedaddon/lighttpd/doc/outdated/simple-vhost.txt, revision 1.1.1.1

1.1       misho       1: ======================
                      2: Simple Virtual-Hosting
                      3: ======================
                      4: 
                      5: ------------------------
                      6: Module: mod_simple_vhost
                      7: ------------------------
                      8: 
                      9: :Author: Jan Kneschke
                     10: :Date: $Date: 2004/08/29 09:43:49 $
                     11: :Revision: $Revision: 1.1 $
                     12: 
                     13: :abstract:
                     14:   virtual hosting
                     15: 
                     16: .. meta::
                     17:   :keywords: lighttpd, virtual hosting
                     18: 
                     19: .. contents:: Table of Contents
                     20: 
                     21: Description
                     22: ===========
                     23: 
                     24: Simple assumption:
                     25: 
                     26: Every virtual host is in a directory below a base directory in a path that
                     27: is the same as the name of the vhost. Below this vhost path might be an
                     28: extra directory which is the document root of the vhost.
                     29: 
                     30: The document root for each vhost is built from three values:
                     31: 
                     32: - server-root
                     33: - hostname
                     34: - document-root
                     35: 
                     36: The complete document root is constructed either by ::
                     37: 
                     38:   server-root + hostname + document-root
                     39: 
                     40: or if this path does not exist by ::
                     41: 
                     42:   server-root + default-host + document-root
                     43: 
                     44: A small example should make this idea clear: ::
                     45: 
                     46:   /var/www/
                     47:   /var/www/logs/
                     48:   /var/www/servers/
                     49:   /var/www/servers/www.example.org/
                     50:   /var/www/servers/www.example.org/lib/
                     51:   /var/www/servers/www.example.org/pages/
                     52:   /var/www/servers/mail.example.org/
                     53:   /var/www/servers/mail.example.org/lib/
                     54:   /var/www/servers/mail.example.org/pages/
                     55: 
                     56:   simple-vhost.server-root = "/var/www/servers/"
                     57:   simple-vhost.default-host = "www.example.org"
                     58:   simple-vhost.document-root = "pages"
                     59: 
                     60: You can use symbolic links to map several hostnames to the same directory.
                     61: 
                     62: Conditionals vs. simple-vhost
                     63: -----------------------------
                     64: 
                     65: You have to keep in mind that conditionals and simple-vhost interfere
                     66: with one another. ::
                     67: 
                     68:   simple-vhost.server-root = "/var/www/servers/"
                     69:   simple-vhost.default-host = "www.example.org"
                     70:   simple-vhost.document-root = "pages"
                     71: 
                     72:   $HTTP["host"] == "news.example.org" {
                     73:     server.document-root = "/var/www/servers/news2.example.org/pages/"
                     74:   }
                     75: 
                     76: When ``news.example.org`` is requested, the ``server.document-root``
                     77: will be set to ``/var/www/servers/news2.example.org/pages/``, but
                     78: simple-vhost will overwrite it shortly afterwards.
                     79: 
                     80: If ``/var/www/servers/news.example.org/pages/`` exists, that will be
                     81: used. If not, ``/var/www/servers/www.example.org/pages/`` will be taken
                     82: because it is the default.
                     83: 
                     84: To use conditionals together with simple-vhost, you should do this: ::
                     85: 
                     86:   $HTTP["host"] !~ "^(news\.example\.org)$" {
                     87:     simple-vhost.server-root = "/var/www/servers/"
                     88:     simple-vhost.default-host = "www.example.org"
                     89:     simple-vhost.document-root = "pages"
                     90:   }
                     91: 
                     92:   $HTTP["host"] == "news.example.org" {
                     93:     server.document-root = "/var/www/servers/news2.example.org/pages/"
                     94:   }
                     95: 
                     96: It will enable simple vhosting for all hosts other than ``news.example.org``.
                     97: 
                     98: Options
                     99: =======
                    100: 
                    101: simple-vhost.server-root
                    102:   root of the virtual host
                    103: 
                    104: simple-vhost.default-host
                    105:   use this hostname if the requested hostname does not have its own directory
                    106: 
                    107: simple-vhost.document-root
                    108:   path below the vhost directory
                    109: