[APACHE DOCUMENTATION]

Apache HTTP Server Version 1.2

Module mod_userdir

This module is contained in the mod_userdir.c file, and is compiled in by default. It provides for user-specific directories.

UserDir

Syntax: UserDir directory/filename
Default: UserDir public_html
Context: server config, virtual host
Status: Base
Module: mod_userdir
Compatibility: All forms except the UserDir public_html form are only available in Apache 1.1 or above.

The UserDir directive sets the real directory in a user's home directory to use when a request for a document for a user is received. Directory is either disabled, to disable this feature, or the name of a directory, following one of the following patterns. If not disabled, then a request for http://www.foo.com/~bob/one/two.html will be translated to:

UserDir public_html     -> ~bob/public_html/one/two.html
UserDir /usr/web        -> /usr/web/bob/one/two.html
UserDir /home/*/www     -> /home/bob/www/one/two.html
The following directives will send redirects to the client:
UserDir http://www.foo.com/users   -> http//www.foo.com/users/bob/one/two.html
UserDir http://www.foo.com/*/usr   -> http://www.foo.com/bob/usr/one/two.html
UserDir http://www.foo.com/~*/     -> http://www.foo.com/~bob/one/two.html

Be careful when using this directive; for instance, "UserDir ./" would map "/~root" to "/" - which is probably undesirable. See also the <Directory> directive and the Security Tips page for more information.


Apache HTTP Server Version 1.2

Index Home