mod_userdir - Apache HTTP Server Version 2.2 中文文档
Apache模块 mod_userdir
| 说明 | 允许用户从自己的主目录中提供页面(使用"/~username") |
|---|---|
| 状态 | 基本(B) |
| 模块名 | userdir_module |
| 源文件 | mod_userdir.c |
概述
此模块允许使用类似http://example.com/~user/的语法来访问用户网站目录。
UserDir 指令
| 说明 | 用户网站目录的位置 |
|---|---|
| 语法 | UserDir directory-filename |
| 作用域 | server config, virtual host |
| 状态 | 基本(B) |
| 模块 | mod_userdir |
UserDir指令指定了用户目录下的一个实实在在的目录，存放了该用户提供访问的文档。Directory-filename可以是以下几种形式之一：
- 一个目录名或如下所示的匹配模式：
- 关键词
disabled停止所有用户名到目录的转换，但不包括明确使用enabled启用的(见下面)目录。 - 关键词
disabled并跟随一个以空格分隔的用户名列表(其中的用户即使出现在enabled的用户列表中，也不会进行目录转换)。 - 关键词
enabled并跟随一个以空格分隔的用户名列表。此列表中的用户允许进行目录转换，即使有一个全局的disabled关闭了此操作，但是，如果同时出现在disabled的用户列表中，则不执行转换操作。
如果在Userdir指令中，既没有enabled也没有disabled关键词，则其参数将被视为文件匹配模式，用于转换成目录名。对http://www.foo.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 |
下列指令将发送重定向到客户端：
| UserDir 指令 | 转换后的路径 |
|---|---|
| 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 |
UserDir ./"可能会把"/~root映射到"/"而这可能不是我们想要的。强烈建议在配置文件中包含一个"UserDir disabled root"声明。更多信息请参见Directory指令和安全提示。
举例：
允许某些用户使用UserDir指令，而禁止其他用户：
UserDir disabled
UserDir enabled user1 user2 user3
允许大多数用户使用UserDir指令，而禁止一小部分用户：
UserDir enabled
UserDir disabled user4 user5 user6
还可以指定任选其一的(alternative)用户网站目录：
Userdir public_html /usr/web http://www.foo.com/
对http://www.foo.com/~bob/one/two.html的请求，会首先尝试获取"~bob/public_html/one/two.html"，其次是"/usr/web/bob/one/two.html"，最后产生一个到http://www.foo.com/bob/one/two.html的重定向。
如果要增加重定向，则必须放在列表的最后。因为Apache不能判断重定向是否成功，所以如果不放在最后，那么它只是一个替换地址。
2.1.4及以后的版本中，默认不开启用户网站目录。在未设置UserDir指令的情况下将使用"UserDir public_html"默认值。