Apache HTTP Server 版本2.2
Apache HTTP Server 版本2.2
| 說(shuō)明 | 提供內(nèi)容協(xié)商支持 |
|---|---|
| 狀態(tài) | 基本(B) |
| 模塊名 | negotiation_module |
| 源文件 | mod_negotiation.c |
內(nèi)容協(xié)商，更準(zhǔn)確的說(shuō)應(yīng)該是"內(nèi)容選擇"，是從幾個(gè)有效文檔中選擇一個(gè)最匹配客戶端要求的文檔的過(guò)程。內(nèi)容協(xié)商有兩種實(shí)現(xiàn)方法。
type-map處理器信息的文件)明確地列出各變種的文件名。Options指令中的MultiViews選項(xiàng)激活)，即服務(wù)器執(zhí)行一個(gè)隱含的文件名模式匹配，并在結(jié)果中選擇。
類型表的格式有點(diǎn)類似于RFC822郵件頭的格式。它包含以空行分格的文檔描述，以井號(hào)(#)打頭的行被當(dāng)作是注釋。一個(gè)文檔描述包含幾個(gè)頭記錄，以空格開(kāi)始的行將被認(rèn)為是前一行的延續(xù)，這樣文檔描述記錄就可以包含多行。在處理處理多行記錄時(shí)，行與行被連接起來(lái)，打頭的空格會(huì)被刪除。一個(gè)頭記錄包含一個(gè)關(guān)鍵字名，并且總是在結(jié)尾的地方用一個(gè)冒號(hào)將它自己和緊跟其后的值分隔開(kāi)。在頭名字與它的值之間以及取值的各個(gè)標(biāo)記之間可以插入空格。頭可以是：
Content-Encoding:AddEncoding指令定義的編碼方式。它一般包含compress壓縮文件的x-compress編碼和gzip文件的x-gzip編碼。在編碼對(duì)照過(guò)程中，"x-"前綴會(huì)被忽略。Content-Language:en表示英語(yǔ)。如果變體包含一種以上的語(yǔ)言，用逗號(hào)來(lái)分隔。Content-Length:Content-Type:name=value"這樣的語(yǔ)法。參數(shù)包括：
leveltext/html來(lái)講，默認(rèn)值是"2"，其它的默認(rèn)值為"0"。qsqs取值都是特定于某個(gè)資源的。
Content-Type: image/jpeg; qs=0.8
URI:Body:
Body:----xyz----
<html>
<body>
<p>Content of the page.</p>
</body>
</html>
----xyz----
MultiViews查詢是由Options指令的MultiViews選項(xiàng)激活的。如果服務(wù)器接收了一個(gè)對(duì)/some/dir/foo的請(qǐng)求，而/some/dir/foo并不存在，則服務(wù)器會(huì)查找這個(gè)目錄下所有的 foo.* 文件，并有效地偽造一個(gè)說(shuō)明這些 foo.* 文件的類型表，假定客戶可能請(qǐng)求的一個(gè)，把他們指定為這個(gè)類型的媒體類型及內(nèi)容編碼。最終選擇其中最符合客戶請(qǐng)求的文檔，返回給客戶。
MultiViewsMatch指令指示Apache在選擇文件時(shí)是否考慮不包含內(nèi)容協(xié)商元信息的文件。
| 說(shuō)明 | 允許經(jīng)過(guò)內(nèi)容協(xié)商的文檔被代理服務(wù)器緩存 |
|---|---|
| 語(yǔ)法 | CacheNegotiatedDocs On|Off |
| 默認(rèn)值 | CacheNegotiatedDocs Off |
| 作用域 | server config, virtual host |
| 狀態(tài) | 基本(B) |
| 模塊 | mod_negotiation |
| 兼容性 | 從2.0版本起，語(yǔ)法有了變化 |
如果設(shè)置為"On"，則允許內(nèi)容協(xié)商文檔被代理服務(wù)器緩存。這可能意味著在代理服務(wù)器后面的客戶端得到的文檔并不是最符合他們情況的版本，但它能夠使緩存更有效。
本指令只對(duì)HTTP/1.0瀏覽器的請(qǐng)求有效。HTTP/1.1在對(duì)內(nèi)容協(xié)商文檔進(jìn)行緩沖方面提供了更好的控制，本指令對(duì)于HTTP/1.1的應(yīng)答沒(méi)有效果。
在2.0版本以前，CacheNegotiatedDocs指令不帶任何參數(shù)；它會(huì)自己在目錄存在的情況下開(kāi)啟。
| 說(shuō)明 | 指定無(wú)法匹配單個(gè)文檔的情況下所采取的動(dòng)作 |
|---|---|
| 語(yǔ)法 | ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] |
| 默認(rèn)值 | ForceLanguagePriority Prefer |
| 作用域 | server config, virtual host, directory, .htaccess |
| 覆蓋項(xiàng) | FileInfo |
| 狀態(tài) | 基本(B) |
| 模塊 | mod_negotiation |
| 兼容性 | 僅在 Apache 2.0.30 及以后的版本中可用 |
ForceLanguagePriority指令使用LanguagePriority指令的設(shè)置，在服務(wù)器無(wú)法返回單個(gè)匹配文檔的情況下，指定完成協(xié)商過(guò)程的方法。
ForceLanguagePriority Prefer 在有幾個(gè)等價(jià)選擇的情況下，使用LanguagePriority的設(shè)定以提供一個(gè)有效的結(jié)果，而不是返回HTTP結(jié)果"300"(多重選擇)。如果給出了下述指令，并且用戶的Accept-Language頭為en和de賦予了相同的品質(zhì)系數(shù)".500"(相同的品質(zhì)系數(shù)是允許的)，那么第一個(gè)匹配的變體：en將被返回。
LanguagePriority en fr de
ForceLanguagePriority Prefer
ForceLanguagePriority Fallback 使用LanguagePriority指令在無(wú)法找到合適結(jié)果的情況下，指定一個(gè)有效的結(jié)果，而不是返回HTTP結(jié)果"406"(不可接受)。如果給出了下述指令，并且用戶的Accept-Language頭只允許es的返回結(jié)果，在這個(gè)變體沒(méi)有找到的情況下，下述LanguagePriority指令列表的第一個(gè)變體將被返回。
LanguagePriority en fr de
ForceLanguagePriority Fallback
Prefer和Fallback兩個(gè)選項(xiàng)可以同時(shí)指定，這樣在有一個(gè)以上有效變體的情況下，返回LanguagePriority指令列表中第一個(gè)匹配的變體文檔，而在沒(méi)有變體能夠匹配客戶可接受的語(yǔ)言的情況下，返回第一個(gè)可用的變體文檔。
| 說(shuō)明 | 在客戶端沒(méi)有指示語(yǔ)言偏好的情況下，語(yǔ)言變體的優(yōu)先級(jí)列表 |
|---|---|
| 語(yǔ)法 | LanguagePriority MIME-lang [MIME-lang] ... |
| 作用域 | server config, virtual host, directory, .htaccess |
| 覆蓋項(xiàng) | FileInfo |
| 狀態(tài) | 基本(B) |
| 模塊 | mod_negotiation |
在處理MultiViews請(qǐng)求時(shí)，LanguagePriority指令在客戶沒(méi)有指示語(yǔ)言偏愛(ài)的情況下，設(shè)定語(yǔ)言變體的優(yōu)先級(jí)列表。這個(gè)MIME-lang列表是按優(yōu)先級(jí)降序排列的。
LanguagePriority en fr de
表示對(duì)于foo.html請(qǐng)求，如果foo.html.fr和foo.html.de同時(shí)存在，并且瀏覽器沒(méi)有表明對(duì)語(yǔ)言的偏愛(ài)，那么foo.html.fr將被返回。
注意，本指令只在根據(jù)其它信息無(wú)法決定最好的語(yǔ)言或者ForceLanguagePriority指令不是None時(shí)才有效。對(duì)正確實(shí)現(xiàn)的HTTP/1.1請(qǐng)求，本指令沒(méi)有任何作用。