Apache 模組 mod_vhost_alias

目錄名稱內插

此模組中的所有指令會在路徑名稱中內插字串。內插的字串（以下稱之為「名稱」）可能是伺服器名稱（請參閱 UseCanonicalName 指令，以了解如何決定名稱的詳細資訊）或用點分十進位格式表示的伺服器上虛擬主機的 IP 位址。內插由受 printf 啟發的指定元控制，這些指定元有數種格式

N 和 M 用於指定名稱的子字串。N 從名稱中以句點分隔的組成元件中選取；而 M 則選取 N 選取的內容內的字元。M 是選用的，如果不存在則預設為零；只有在 M 存在時，句點必須存在。解譯如下

如果 N 或 M 大過於可用部分的數量，則會內插一個底線。

範例

對於基於簡單名稱的虛擬主機，您可以在伺服器組態檔中使用下列指令

UseCanonicalName    Off
VirtualDocumentRoot "/usr/local/apache/vhosts/%0"

針對 http://www.example.com/directory/file.html 的請求，將會由檔案 /usr/local/apache/vhosts/www.example.com/directory/file.html 滿足。

對於非常大量的虛擬主機，建議您安排檔案以減小 vhosts 目錄的大小。為此，您可以在您的組態檔中使用下列指令

UseCanonicalName    Off
VirtualDocumentRoot "/usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2"

針對 http://www.domain.example.com/directory/file.html 的請求，將會由檔案 /usr/local/apache/vhosts/example.com/d/o/m/domain/directory/file.html 滿足。

可以透過從名稱尾端雜湊的方式來達到檔案更平均的分布，例如

VirtualDocumentRoot "/usr/local/apache/vhosts/%3+/%2.-1/%2.-2/%2.-3/%2"

範例請求會來自 /usr/local/apache/vhosts/example.com/n/i/a/domain/directory/file.html。

或者您也可以使用

VirtualDocumentRoot "/usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2.4+"

範例請求會來自 /usr/local/apache/vhosts/example.com/d/o/m/ain/directory/file.html。

使用者很常見的請求是能夠將多個網域指向多個文件根目錄，而不用擔心請求主機名稱的部分長度或數量。如果請求的主機名稱是 sub.www.domain.example.com 而非單純的 www.domain.example.com，則使用 %3+ 會導致文件根目錄成為 /usr/local/apache/vhosts/domain.example.com/...，而不是預期的 example.com 目錄。在這種情況下，使用組合 %-2.0.%-1.0 會很有幫助，它會總是產生網域名稱和頂層網域，例如 example.com，無論主機名稱附加了多少個子網域。因此，可以進行組態，將所有第一、第二或第三層級的子網域導向同一個目錄

VirtualDocumentRoot "/usr/local/apache/vhosts/%-2.0.%-1.0"

在上述範例中，www.example.com 和 www.sub.example.com 或 example.com 都會指向 /usr/local/apache/vhosts/example.com。

對於基於 IP 的虛擬主機，您可以在您的組態檔中使用下列指令

UseCanonicalName DNS
VirtualDocumentRootIP "/usr/local/apache/vhosts/%1/%2/%3/%4/docs"
VirtualScriptAliasIP  "/usr/local/apache/vhosts/%1/%2/%3/%4/cgi-bin"

如果 www.domain.example.com 的 IP 位址是 10.20.30.40，則針對 http://www.domain.example.com/directory/file.html 的請求會由檔案 /usr/local/apache/vhosts/10/20/30/40/docs/directory/file.html 滿足。針對 http://www.domain.example.com/cgi-bin/script.pl 的請求會透過執行程式 /usr/local/apache/vhosts/10/20/30/40/cgi-bin/script.pl 滿足。

若要讓 . 字元包含在 VirtualDocumentRoot 指令中，但它與 % 指令衝突，您可使用下列方式來解決此問題。

VirtualDocumentRoot "/usr/local/apache/vhosts/%2.0.%3.0"

在 http://www.domain.example.com/directory/file.html 中的請求會由 /usr/local/apache/vhosts/domain.example/directory/file.html 檔案滿足。

%V 和 %A 等 LogFormat 指令相當適用於此模組。