用於描述指令的條款

描述

指令目的的簡要描述。

語法

這表示指令會於設定檔中顯示的形式。此語法會針對不同的指令而有所不同，並在指令的定義中有詳細說明。通常，指令名稱後面會跟一到多個以空格分隔的引數。如果引數包含空格，則引數必須以雙引號括起來。選用引數會以方括號括起來。當一個引數有多個可能的值時，可能的值會以直線「|」分隔。文字會以預設字型顯示，而需要取代的引數類型則會以強調方式顯示。可使用變數個數的指令會以「...」結尾，表示最後一個引數是重複的。

指令使用許多不同的引數類型。下列定義了一些常見的類型。

網址

完整的統一資源定位器，包括範例中的識別結構、主機名稱，和選用路徑名稱，如 http://www.example.com/path/to/file.html

網址路徑

範例中 網址 中識別結構和主機名稱之後的部分，如 /path/to/file.html。網址路徑 代表資源的網路檢視，不同於檔案系統檢視。

檔案路徑

檔案路徑位於本機檔案系統中，由根目錄，例如：/usr/local/apache/htdocs/path/to/file.html 開始。除非另有指定，未以斜線開頭的 檔案路徑 會視為 ServerRoot 的相對路徑.

directory-path

目錄路徑位於本機檔案系統中，由根目錄，例如：/usr/local/apache/htdocs/path/to/ 開始。

filename

檔案名稱，無附帶路徑資訊，例如：file.html。

regex

相容於 Perl 的 正規表示式。指令定義會指定 正規表示式 符合的條件。

extension

基本上，這是在 檔案名稱 中最後出現的各種點號後面部分。但是，Apache 會辨識出多個檔案名稱的副檔名，因此，如果 檔案名稱 包含一個以上的點號，第一個點號後的每個以點號分隔的檔案名稱部分都是 副檔名。例如，檔案名稱 file.html.en 包含兩個副檔名：.html 和 .en。在 Apache 指令中，您可以使用前導點號或不使用前導點號來指定 副檔名。此外，副檔名 不分大小寫。

MIME 類型

描述檔案格式的方法，包括一個主要格式類型和一個次要格式類型，並以斜線分隔，例如：text/html。

env-variable

在 Apache 組態處理中定義的 環境變數 名稱。請注意，這和作業系統的環境變數並不一定相同。請參閱 環境變數文件，以取得更多詳細資料。

Default

如果指令具有預設值（也就是說，如果您從組態中完全略過指令，Apache Web 伺服器會假設您設定其為特定值），會在這裡描述指令的預設值。如果沒有預設值，此部分應該顯示 "None"。請注意，這裡列出的預設值不一定與伺服器隨附的預設 httpd.conf 中指令採用相同的預設值。

Context

這表示指令可以在伺服器的組態檔案的哪些位置使用。這是下列一個或多個值的逗號分隔清單

伺服器組態

這表示該指令可以在伺服器組態檔案（例如：httpd.conf）中使用，但 不能 在任何 <VirtualHost> 或 <Directory> 容器內使用。.htaccess 檔案中絕對不允許使用該指令。

虛擬主機

此內容表示該指令可以出現在伺服器組態檔案的 <VirtualHost> 容器中。

目錄

可以在本段文中標示為有效的指示可以在 <Directory>、<Location>、<Files>、<If> 和 <Proxy> 容器中使用，但前提是受到 組態部分 中所概述的限制。

.htaccess

如果某指示在本段文中有效，表示它會顯示在每個目錄的 .htaccess 檔案中。不過，根據目前運作的 覆寫 方式，它可能並未被處理。

指示只允許在指定的段落中使用；如果您嘗試在其他地方使用它，將會出現組態錯誤，而且會導致伺服器無法正確處理該段落中的要求，甚至完全無法運作 － 也就表示伺服器甚至不會啟動。

指示的有效位置實際上是所有已列出段落經過布林運算 OR 後的結果。換句話說，標示為在「伺服器組態、.htaccess」中有效的指示可以用在 httpd.conf 檔案和 .htaccess 檔案中，但不能用在任何 <Directory> 或 <VirtualHost> 容器中。

覆寫

這個指示屬性指出在 .htaccess 檔案中顯示指示時，需要啟動哪一個組態覆寫才能處理指示。如果指示的 段落 不允許它顯示在 .htaccess 檔案中，將不會列出任何段落。

覆寫會由 AllowOverride 指示啟動，並套用到特定範圍（例如目錄）和所有後代，除非稍後經過較低層級的其他 AllowOverride 指示修改。該指示的文件也列出可用的覆寫名稱。

狀態

這顯示指示與 Apache 網路伺服器結合的緊密程度；換句話說，您可能需要使用進階模組集合重新編譯伺服器，才能存取指示及其功能。這個屬性可用的值有

核心

如果指示列為具有「核心」狀態，表示它是 Apache 網路伺服器最內層部分的一部份，且始終可用。

MPM

標示為具有「MPM」狀態的指示是由 多重處理模組 提供。此類型的指示僅在您使用指示定義的 模組 行中所列出的 MPM 時才會提供。

基礎

標示為「基礎」狀態的指示由預設編譯到伺服器的標準 Apache 模組之一支援，因此除非您已採取步驟從組態中移除該模組，否則通常都可用。

擴充功能

具有「擴充功能」狀態的指示由 Apache 伺服器套件附帶的其中一個模組提供，但該模組通常不會編譯到伺服器中。若要啟用指示及其功能，您需要變更伺服器建置組態檔並重新編譯 Apache。

實驗中

「實驗中」狀態表示指示可用於 Apache 套件的一部分，但如果您嘗試使用它，後續問題將由您自行承擔。該指示記錄於此以供參考，並不一定受支援。提供該指示的模組可能已預設編譯，也可能尚未編譯；請查看說明該指示及其模組的最上層，以瞭解其是否註解可用性。

模組

這項會簡單列出定義指示的原始碼模組名稱。

相容性

如果指示並非原始 Apache 第 2 版發行的一部分，則應該在此列出其所引進的版本。此外，如果指示僅可在特定平台上使用，則會在此註明。