用法

在服務(wù)器配置文件中，使用AddHandler指令將isapi-isa處理器與ISAPI文件關(guān)聯(lián)起來(lái)，并通過(guò)文件擴(kuò)展名來(lái)建議對(duì)應(yīng)關(guān)系。要將任何一個(gè).dll文件作為ISAPI擴(kuò)展來(lái)處理，需要編輯httpd.conf文件，并加入以下行：

Apache服務(wù)器不允許將服務(wù)于請(qǐng)求的模塊動(dòng)態(tài)地加載，但可以通過(guò)在httpd.conf文件中，加入以下語(yǔ)句使一個(gè)模塊在Apache啟動(dòng)時(shí)預(yù)先載入系統(tǒng)，并使其駐留在系統(tǒng)中：

無(wú)論是否預(yù)載一個(gè)ISAPI擴(kuò)展，所有的ISAPI擴(kuò)展都使用與CGI腳本相同的許可限制來(lái)管理。也就是說(shuō)，包含ISAPI動(dòng)態(tài)連接庫(kù)的目錄必須要設(shè)置"Options ExecCGI"。

請(qǐng)參閱附加注釋和程序員注記以得到關(guān)于mod_isapi所提供的特定的ISAPI支持的細(xì)節(jié)內(nèi)容。

附加注釋

Apache的ISAPI實(shí)現(xiàn)了除部分用來(lái)處理異步I/O的微軟特定(Microsoft-specific)擴(kuò)展以外的所有ISAPI 2.0規(guī)范。Apache的I/O模型不允許使用ISAPI可能用到的異步讀寫(xiě)方式。如果ISAPI試圖調(diào)用不支持的功能，包括異步I/O，在錯(cuò)誤日志中會(huì)顯示一條錯(cuò)誤信息以方便系統(tǒng)的調(diào)試。由于這類(lèi)錯(cuò)誤信息可能會(huì)大量地產(chǎn)生，指令"ISAPILogNotSupported Off"可以使這類(lèi)錯(cuò)誤信息不被記錄。

在某些服務(wù)器上，比如微軟的IIS，ISAPI擴(kuò)展在載入后將駐留在服務(wù)器上，直到內(nèi)存占用過(guò)高，或是指定了不同的配置選項(xiàng)。Apache目前在每次請(qǐng)求時(shí)，都會(huì)加載和卸載特定的ISAPI擴(kuò)展，除非指定了ISAPICacheFile指令。雖然這樣看來(lái)是效率很低的一種做法，但根據(jù)Apache的內(nèi)存模式使用這種方式是最有效的。許多ISAPI模塊與Apache服務(wù)器有細(xì)微的兼容性問(wèn)題，卸載這些模塊可以保證服務(wù)器的穩(wěn)定運(yùn)行。

同時(shí)請(qǐng)記住Apache支持ISAPI擴(kuò)展，但它不支持ISAPI過(guò)濾器。對(duì)于ISAPI過(guò)濾器的支持可能會(huì)在晚些時(shí)候加入，但目前沒(méi)有支持這一功能的計(jì)劃。

程序員注記

如果你正在開(kāi)發(fā) Apache 2.0 mod_isapi模塊，你必須嚴(yán)格按照以下指令的限制來(lái)調(diào)用ServerSupportFunction ：

HSE_REQ_SEND_URL_REDIRECT_RESP

重定向用戶(hù)到其它的位置。必須使用完整的、合法的URL(比如：http://server/location)。

HSE_REQ_SEND_URL

重定向用戶(hù)到其它的位置。這里不能使用一個(gè)完整的URL，你不可以傳入?yún)f(xié)議或服務(wù)器名(例如：/location)。這類(lèi)重定向由服務(wù)器來(lái)處理，不是瀏覽器。

警告

在最近發(fā)布的文檔中，微軟已經(jīng)試圖放棄這兩個(gè)HSE_REQ_SEND_URL函數(shù)的差別。但Apache還是將它們視為兩個(gè)不同的函數(shù)加以不同的實(shí)現(xiàn)。

HSE_REQ_SEND_RESPONSE_HEADER

如果在請(qǐng)求頭字符串變量中，請(qǐng)求頭的內(nèi)容后面緊跟一個(gè)空行(兩個(gè)連續(xù)的換行)，然后再加上請(qǐng)求體的內(nèi)容，Apache能接受這一相應(yīng)的請(qǐng)求體。因?yàn)檎?qǐng)求頭變量是以NULL結(jié)束的，這個(gè)請(qǐng)求體里不能包含NULL。

HSE_REQ_DONE_WITH_SESSION

Apache認(rèn)為這是一個(gè)空操作，因?yàn)楫?dāng)ISAPI處理返回時(shí)，會(huì)話就結(jié)束了。

HSE_REQ_MAP_URL_TO_PATH

Apache將虛擬名字轉(zhuǎn)換為物理名字。

HSE_APPEND_LOG_PARAMETER

這一日志信息可以在以下任一地方捕獲：

• 在CustomLog指令中的 \"%{isapi-parameter}n\" 元素里
• 在"ISAPIAppendLogToQuery On"指令中的"%q"日志元素里
• 由"ISAPIAppendLogToErrors On"指令所產(chǎn)生的錯(cuò)誤日志中

第一行的 %{isapi-parameter}n 元素總是可用的，并且是推薦的。

HSE_REQ_IS_KEEP_CONN

返回Keep-Alive的協(xié)商狀態(tài)。

HSE_REQ_SEND_RESPONSE_HEADER_EX

即使fKeepConn標(biāo)志被忽略，還是按有證書(shū)的方式來(lái)處理。

HSE_REQ_IS_CONNECTED

如果請(qǐng)求退出則報(bào)告錯(cuò)誤。

對(duì)于所有不支持的ServerSupportFunction調(diào)用，Apache返回FALSE ，同時(shí)將GetLastError的值置為ERROR_INVALID_PARAMETER 。

ReadClient越過(guò)初始緩沖區(qū)(由ISAPIReadAheadBuffer指令定義)得到請(qǐng)求的數(shù)據(jù)包。根據(jù)ISAPIReadAheadBuffer(在調(diào)用ISAPI處理前緩沖的數(shù)據(jù)字節(jié)數(shù))的設(shè)定，較小的請(qǐng)求包當(dāng)請(qǐng)求被調(diào)用時(shí)，直接完全地傳送到ISAPI擴(kuò)展。如果請(qǐng)求包很長(zhǎng)，ISAPI擴(kuò)展必須使用ReadClient得到剩下的請(qǐng)求數(shù)據(jù)。

支持WriteClient ，但只能使用HSE_IO_SYNC標(biāo)志或不帶標(biāo)志("0"值)。任何其它的WriteClient請(qǐng)求會(huì)被拒絕，并且返回FALSE ，同時(shí)GetLastError的值被置為ERROR_INVALID_PARAMETER 。

支持GetServerVariable ，雖然擴(kuò)展服務(wù)變量不存在(定義在其它服務(wù)器上)。包括ALL_HTTP和ALL_RAW ，所有的常規(guī)Apache CGI環(huán)境變量都可以通過(guò)GetServerVariable得到。

Apache 2.0 mod_isapi支持后來(lái)版本的ISAPI規(guī)范中的新增功能，比如對(duì)異步I/O的有限仿真及TransmitFile語(yǔ)義。Apache同時(shí)也支持ISAPI .dlls 的預(yù)載入以提高性能，以上這些在 Apache1.3 mod_isapi都沒(méi)有實(shí)現(xiàn)。