mod_userdir

描述：	User-specific 目录
状态：	Base
模块标识符：	userdir_module
源文件：	mod_userdir.c

摘要

该模块允许使用http://example.com/~user/语法访问 user-specific 目录。

UserDir 指令

描述：	user-specific 目录的位置
句法：	UserDir directory-filename[directory-filename]...
Context：	server config，virtual host
状态：	Base
模块：	mod_userdir

UserDir指令设置用户主目录中的真实目录，以便在收到对用户的文档请求时使用。 Directory-filename 是以下之一：

目录的 name 或 pattern，如下所示。
关键字disabled。这将关闭所有 username-to-directory 转换，除了那些使用enabled关键字明确命名的转换(见下文)。
关键字disabled后跟 space-delimited 用户名列表。出现在此类列表中的用户名将永远不会执行目录转换，即使它们出现在enabled子句中也是如此。
关键字enabled后跟 space-delimited 用户名列表。即使 global 禁用有效，这些用户名也会执行目录转换，但如果它们也出现在disabled子句中则不会。

如果Userdir和disabled关键字都不出现在Userdir指令中，则该参数将被视为文件名 pattern，并用于将 name 转换为目录规范。对http://www.example.com/~bob/one/two.html的请求将被翻译为：

使用 UserDir 指令	翻译的路径
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

以下指令将重定向发送到 client：

使用 UserDir 指令	翻译的路径
UserDir http://www.example.com/users	http://www.example.com/users/bob/one/two.html
UserDir http://www.example.com/*/usr	http://www.example.com/bob/usr/one/two.html
UserDir http://www.example.com/~*/	http://www.example.com/~bob/one/two.html

使用此指令时要小心；例如，“UserDir ./”将 map“/~root”改为“/”-这可能是不合需要的。强烈建议您的 configuration 包含“UserDir 禁用根”声明。有关更多信息，另请参阅目录指令和安全提示页面.

其他例子：

要允许少数用户拥有UserDir目录，而不是其他任何人，请使用以下命令：

UserDir disabled
UserDir enabled user1 user2 user3

要允许大多数用户拥有UserDir目录，但拒绝这一点，请使用以下命令：

UserDir disabled user4 user5 user6

也可以指定备用用户目录。如果您使用如下命令：

UserDir "public_html" "/usr/web" "http://www.example.com/"

对http://www.example.com/~bob/one/two.html的请求，将首先尝试在~bob/public_html/one/two.html找到页面，然后是/usr/web/bob/one/two.html，最后它会发送重定向到http://www.example.com/bob/one/two.html。

如果添加重定向，则它必须是列表中的最后一个选项。 Apache httpd 无法确定重定向是否成功，因此如果您在列表的前面有重定向，那么它将始终是使用的替代方法。

默认情况下，在 2.1.4 及更高版本中，用户目录替换不是 active。在早期版本中，如果没有UserDir指令，则假定UserDir public_html。

合并细节

特定启用和禁用用户的列表将从 global 替换为虚拟 host 范围，而不是合并

参见