說(shuō)明

對(duì)指令用途的簡(jiǎn)單說(shuō)明。

語(yǔ)法

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

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

URL

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

URL-path

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

file-path

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

directory-path

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

filename

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

regex

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

extension

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

MIME-type

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

env-variable

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

默認(rèn)值

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

作用域

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

server config

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

virtual host

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

directory

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

.htaccess

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

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

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

覆蓋項(xiàng)

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

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

狀態(tài)

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

Core

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

MPM

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

Base

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

Extension

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

Experimental

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

模塊

對(duì)該指令提供支持的模塊列表。

兼容性

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