說明

對指令用途的簡單說明。

語法

說明該指令在配置文件中使用的形式(隨指令的不同而不同)，在指令的定義中有說明。指令后面一般可以跟一個或多個用空格分開的參數(shù)。如果參數(shù)中有空格，則必須用雙引號括起來，用方括號括起來的是可選參數(shù)。如果一個參數(shù)可以取多個值，則各個可能的值用"|"分開。應(yīng)該原樣輸入的文字使用默認(rèn)字體，而可變的必須按實際情況加以替換的會加強顯示。使用可變參數(shù)個數(shù)的指令以"..."結(jié)尾，以表示最后一個參數(shù)可以重復(fù)。

指令的參數(shù)類型非常多，以下列出常用的部分。

URL

一個完整的包括類型、主機名和可選路徑名的統(tǒng)一資源引用名，如：http://www.example.com/path/to/file.html

URL-path

URL中類型和主機名之后的部分，如"/path/to/file.html"是表示資源在網(wǎng)絡(luò)空間(而不是文件系統(tǒng))中的位置。

file-path

文件在本地文件系統(tǒng)中相對于根目錄的路徑，如"/usr/local/apache/htdocs/path/to/file.html"。除非以斜杠(/)開頭，否則將被視為相對于ServerRoot的相對路徑。

directory-path

目錄在本地文件系統(tǒng)中相對于根目錄的路徑，如：/usr/local/apache/htdocs/path/to/

filename

不帶路徑信息的文件名，如：file.html

regex

Perl兼容的正則表達(dá)式，是對文本匹配模式的描述。指令的定義中會說明應(yīng)該使用什么regex 。

extension

一般是指filename中最后一個"."號后面的部分。不過，Apache可以辨認(rèn)文件的多個extension ，如果filename中含有多個"."，則第一個"."后面由每個"."分隔開的部分都是此文件的extension 。比如"file.html.en"有兩個extension ：.html和.en 。在Apache指令中指定extension時，可以有也可以沒有前導(dǎo)的"."，而且不區(qū)分大小寫。

MIME-type

一種用一個主格式類型和一個副格式類型并用斜杠分隔的描述文件格式的方法，如：text/html

env-variable

這是Apache配置過程中定義的環(huán)境變量的名稱。注意，它不一定與操作系統(tǒng)中的環(huán)境變量相同。詳情參見環(huán)境變量文檔。

默認(rèn)值

如果該指令有默認(rèn)值(即如果你沒有在配置中明確指定，那么Apache服務(wù)器會默認(rèn)設(shè)置一個特定的值，并認(rèn)為它是你設(shè)置的)，會在此處說明。如果沒有，則會指明是"None"。注意，此處的默認(rèn)值并不一定與服務(wù)器發(fā)行版中默認(rèn)的httpd.conf中該指令的取值相同。

作用域

它表示該指令出現(xiàn)在配置文件的什么位置才是合法的。它是一個用逗號分隔的一個或多個下列值的列表：

server config

說明該指令可以用于服務(wù)器配置文件(httpd.conf)，但不能用于任何<VirtualHost>或<Directory>段以及.htaccess文件中。

virtual host

說明該指令可以用于服務(wù)器配置文件的<VirtualHost>段中。

directory

說明該指令可以用于服務(wù)器配置文件<Directory>, <Location>, <Files>, <Proxy>段中，并服從配置段一文的限制。

.htaccess

說明該指令可以用于針對單個目錄及其子目錄的.htaccess文件中。它可能會因overrides的設(shè)置而不起作用。

指令應(yīng)該僅僅出現(xiàn)在允許出現(xiàn)的作用域中，否則會產(chǎn)生配置錯誤，并導(dǎo)致服務(wù)器不能正確處理請求，或者根本不能啟動。

指令的有效位置，事實上是其所有被列出的作用域邏輯或的結(jié)果。也就是如果一個指令被標(biāo)為"server config, .htaccess"則可以用于httpd.conf和.htaccess ，但不能用于任何<Directory>或<VirtualHost>容器。

覆蓋項

該屬性表示要使.htaccess文件中的該指令有效必須激活的配置覆蓋項。如果一個指令的作用域不包含.htaccess ，則無此內(nèi)容。

AllowOverride指令使覆蓋生效，并作用于一個特定的范圍(比如一個目錄)及其下分支，除非又被其下層中其他的AllowOverride指令所修改。對指令的說明中同時列出了其可能的覆蓋項。

狀態(tài)

狀態(tài)代表了此指令與Apache服務(wù)器結(jié)合的緊密程度；也就是說，有可能需要重新編譯服務(wù)器以獲得一個指令的功能。其可能的值有：

Core

Apache服務(wù)器最核心的部分，始終有效。

MPM

由一個多路處理模塊提供，此類指令僅僅在使用了指令定義中模塊一行所列的MPM之一時才有效。

Base

由默認(rèn)編譯進(jìn)服務(wù)器的一個Apache標(biāo)準(zhǔn)模塊提供，一般總是有效的，除非你刻意在編譯時從配置中刪除此模塊。

Extension

由一個默認(rèn)不被編譯進(jìn)服務(wù)器的模塊提供。要激活此指令并使用其功能，需要修改服務(wù)器編譯時配置并重新編譯Apache。

Experimental

由一個一般來說默認(rèn)不被編譯進(jìn)服務(wù)器的模塊提供，并且需要你自己承擔(dān)使用中的風(fēng)險。對此指令提供文檔是為了保持完整性，而并不一定有技術(shù)支持。提供此指令的模塊，是否默認(rèn)被編譯進(jìn)入服務(wù)器都有可能，其說明頁面的頂部注明了其有效性。

模塊

對該指令提供支持的模塊列表。

兼容性

如果該指令不是原始Apache2的發(fā)行版的一部分，此處會寫明此指令應(yīng)該被使用于哪個版本；另外，如果此指令在特定平臺上有功能限制，此處會有詳細(xì)說明。