Mod userdir » History » Revision 9
Revision 8 (stbuehler, 2009-02-17 10:45) → Revision 9/12 (Shtirlic, 2009-03-09 14:31)
h1. User-based Directories Module mod_userdir {{>toc}} *Module mod_userdir* {{toc}} h2. Description The userdir module provides a simple way to link user-based directories into the global namespace of the webserver. Requests in the form @/~user/page.html@ are rewritten to take the file @page.html@ from the home directory of the user. If @userdir.path@ is set, the path will be appended to the home directory building the classic mapping of: <pre> # URL: http://www.example.org/~jan/index.html # Path: /home/jan/public_html/ userdir.path = "public_html" </pre> To control which users should be able to use this feature you can set a list of usernames to include or exclude. In case your mapping is independent of /etc/passwd you can use @userdir.basepath@: <pre> # URL: http://www.example.org/~jan/index.html # Path: /var/www/users/jan/htdocs/index.html userdir.path = "htdocs" userdir.basepath = "/var/www/users/" </pre> h2. Options h3. userdir.path (required option) usually it should be set to "public_html" to take ~/public_html/ as the document root default: unset (mod_userdir disabled; set it to "" if you want the home directory to be the document root as it was the default before 1.4.19) Example: userdir.path = "public_html" h3. userdir.exclude-user list of usernames which may not use this feature default: empty (all users may use it) Example: userdir.exclude-user = ( "root", "postmaster" ) h3. userdir.include-user if set, only users from this list may use the feature default: empty (all users may use it) h3. userdir.basepath if set, don't check /etc/passwd for homedir