Apache模塊 mod_dir · Apache 2.2 中文官方文檔

# Apache模塊 mod_dir | [說明](#calibre_link-11) | 指定目錄索引文件以及為目錄提供"尾斜杠"重定向 | | --- | --- | | [狀態](#calibre_link-12) | 基本(B) | | [模塊名](#calibre_link-13) | dir_module | | [源文件](#calibre_link-14) | mod_dir.c | ### 概述目錄的索引可以有兩個來源： * 一個由用戶編寫的文件，通常叫：`index.html` 。`mod_dir`提供的`DirectoryIndex`指令用于設置這個文件名。 * 由服務器產生的一個列表。該功能由`mod_autoindex`提供。這兩個功能是相互獨立的，所以你可以完全去除或替換索引的自動生成。因為對目錄的請求需要以一個"/"結尾，所以當服務器接收到對 `http://servername/foo/dirname` 的請求時，若`dirname`是一個目錄，則`mod_dir`將會將其重定向到 `http://servername/foo/dirname/` 。 ## DirectoryIndex 指令 | [說明](#calibre_link-18) | 當客戶端請求一個目錄時尋找的資源列表 | | --- | --- | | [語法](#calibre_link-19) | `DirectoryIndex local-url [local-url] ...` | | [默認值](#calibre_link-24) | `DirectoryIndex index.html` | | [作用域](#calibre_link-20) | server config, virtual host, directory, .htaccess | | [覆蓋項](#calibre_link-66) | Indexes | | [狀態](#calibre_link-21) | 基本(B) | | [模塊](#calibre_link-22) | mod_dir | `DirectoryIndex`指令設置了當客戶端在請求的目錄名的末尾刻意添加一個"/"以表示請求該目錄的索引時，服務器需要尋找的資源列表。Local-url(%已解碼的)是一個相對于被請求目錄的文檔的URL(通常是那個目錄中的一個文件)。可以指定多個URL，服務器將返回最先找到的那一個。若一個也沒有找到，并且那個目錄設置了`Indexes`選項，服務器將會自動產生一個那個目錄中的資源列表。 ### 示例 ``` DirectoryIndex index.html ``` 上例配置指示對 `http://myserver/docs/` 的請求返回 `http://myserver/docs/index.html`(若存在)，或返回該目錄下所有資源的列表。注意，指定的文檔不一定必須位于被請求的目錄下，也可以指定一個絕對URL來指向其他位置： ``` DirectoryIndex index.html index.txt /cgi-bin/index.pl ``` 這樣的設置將導致在`index.html`或`index.txt`都不存在的情況下執行CGI腳本`/cgi-bin/index.pl` 。 ## DirectorySlash 指令 | [說明](#calibre_link-18) | 打開或關閉目錄結尾斜線(/)自動補全功能 | | --- | --- | | [語法](#calibre_link-19) | `DirectorySlash On|Off` | | [默認值](#calibre_link-24) | `DirectorySlash On` | | [作用域](#calibre_link-20) | server config, virtual host, directory, .htaccess | | [覆蓋項](#calibre_link-66) | Indexes | | [狀態](#calibre_link-21) | 基本(B) | | [模塊](#calibre_link-22) | mod_dir | | [兼容性](#calibre_link-137) | 僅在 Apache 2.0.51 及以后的版本中可用 | `DirectorySlash`指令決定`mod_dir`是否通過在請求的URL結尾補上"/"使其重定向到其所指向的目錄。典型的，如果用戶請求一個結尾沒有"/"的資源，并且該資源指向一個目錄，`mod_dir`將通過在請求的URL結尾補上"/"使其重定向到其所指向的目錄。默認開啟自動補全功能有以下原因： * 用戶最后使用了規范的URL來請求資源。 * `mod_autoindex`將會正確工作。因為它不會自動補全路徑，所以將會指向錯誤的路徑。 * `DirectoryIndex`將_只_評估有"/"結尾的目錄。 * html頁面中的相對URL引用將會正確工作。如果你不希望這個自動補全功能生效，_并且_不在乎上述原因，你可以關閉它： ``` # 請參見下面的安全警告 <Location /some/path> DirectorySlash Off SetHandler some-handler </Location> ``` ### 安全警告關閉目錄自動重定向可能會導致信息泄漏。考慮`mod_autoindex`被激活(`Options +Indexes`)并且`DirectoryIndex`也正確設置到一個資源(比如：`index.html`)同時沒有其他處理器用于URL的情況。此時，以"/"結尾的URL將得到`index.html`文件，而**不以"/"結尾的請求將得到目錄列表**。