Apache HTTP Server 版本2.2

| 說明 | 允許用戶從自己的主目錄中提供頁面(使用"/~username") |
|---|---|
| 狀態(tài) | 基本(B) |
| 模塊名 | userdir_module |
| 源文件 | mod_userdir.c |
此模塊允許使用類似http://example.com/~user/的語法來訪問用戶網(wǎng)站目錄。
| 說明 | 用戶網(wǎng)站目錄的位置 |
|---|---|
| 語法 | UserDir directory-filename |
| 作用域 | server config, virtual host |
| 狀態(tài) | 基本(B) |
| 模塊 | mod_userdir |
UserDir指令指定了用戶目錄下的一個(gè)實(shí)實(shí)在在的目錄,存放了該用戶提供訪問的文檔。Directory-filename可以是以下幾種形式之一:
disabled停止所有用戶名到目錄的轉(zhuǎn)換,但不包括明確使用enabled啟用的(見下面)目錄。disabled并跟隨一個(gè)以空格分隔的用戶名列表(其中的用戶即使出現(xiàn)在enabled的用戶列表中,也不會(huì)進(jìn)行目錄轉(zhuǎn)換)。enabled并跟隨一個(gè)以空格分隔的用戶名列表。此列表中的用戶允許進(jìn)行目錄轉(zhuǎn)換,即使有一個(gè)全局的disabled關(guān)閉了此操作,但是,如果同時(shí)出現(xiàn)在disabled的用戶列表中,則不執(zhí)行轉(zhuǎn)換操作。如果在Userdir指令中,既沒有enabled也沒有disabled關(guān)鍵詞,則其參數(shù)將被視為文件匹配模式,用于轉(zhuǎn)換成目錄名。對http://www.foo.com/~bob/one/two.html的請求會(huì)被轉(zhuǎn)換為:
| UserDir 指令 | 轉(zhuǎn)換后的路徑 |
|---|---|
| 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 |
下列指令將發(fā)送重定向到客戶端:
| UserDir 指令 | 轉(zhuǎn)換后的路徑 |
|---|---|
| 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 ./"可能會(huì)把"/~root映射到"/"而這可能不是我們想要的。強(qiáng)烈建議在配置文件中包含一個(gè)"UserDir disabled root"聲明。更多信息請參見Directory指令和安全提示。
舉例:
允許某些用戶使用UserDir指令,而禁止其他用戶:
UserDir disabled
UserDir enabled user1 user2 user3
允許大多數(shù)用戶使用UserDir指令,而禁止一小部分用戶:
UserDir enabled
UserDir disabled user4 user5 user6
還可以指定任選其一的(alternative)用戶網(wǎng)站目錄:
Userdir public_html /usr/web http://www.foo.com/
對http://www.foo.com/~bob/one/two.html的請求,會(huì)首先嘗試獲取"~bob/public_html/one/two.html",其次是"/usr/web/bob/one/two.html",最后產(chǎn)生一個(gè)到http://www.foo.com/bob/one/two.html的重定向。
如果要增加重定向,則必須放在列表的最后。因?yàn)锳pache不能判斷重定向是否成功,所以如果不放在最后,那么它只是一個(gè)替換地址。
2.1.4及以后的版本中,默認(rèn)不開啟用戶網(wǎng)站目錄。在未設(shè)置UserDir指令的情況下將使用"UserDir public_html"默認(rèn)值。