發(fā)這個(gè)幫助文件是因?yàn)樵诮o朋友設(shè)置主機(jī)的時(shí)候發(fā)現(xiàn)他們的ISAPI Rewrite的設(shè)置都有些不正確，有些甚至阻礙了站點(diǎn)的正常運(yùn)行。就把官方自帶的英文幫助粗略的翻譯了一下。大家可以自由使用和轉(zhuǎn)載。但轉(zhuǎn)載時(shí)如果你愿意請(qǐng)注明是 藍(lán)色 翻譯的版本。

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
ISAPI Rewrite 配置簡(jiǎn)介：

在NT/2000/XP和2003平臺(tái)上，ISAPI Rewrite在系統(tǒng)帳戶(hù)下射入INETINFO進(jìn)程與 IIS 以共存模式過(guò)濾器運(yùn)行。所以系統(tǒng)帳戶(hù)應(yīng)該給予對(duì)ISAPI- REWIRITE DLLS Internet匿名訪問(wèn)組 可讀可執(zhí)行權(quán)限 和所有的 HTTPD。INI 文件可讀權(quán)限，還應(yīng)該給予系統(tǒng)帳戶(hù)對(duì)于所有包括 HTTPD。INI 文件的文件夾的可寫(xiě)權(quán)限，這將允許產(chǎn)生 HTTP。 PARSE。ERRORS 日志文件，來(lái)記錄配置文件語(yǔ)法錯(cuò)誤。對(duì)于PROXY模塊也需要額外的權(quán)限，因?yàn)樗鼘⑦\(yùn)行于連接池或HIGH-ISPLATED 應(yīng)用模式，IIS帳戶(hù)共享池和HIGH-ISOLATION池應(yīng)被給予對(duì)RWHELPERE。DLL的可讀權(quán)限。缺省情況下IWAM-《計(jì)算機(jī)名》被用于所有的池，在相應(yīng)的COM+應(yīng)用設(shè)置中應(yīng)借助COM+ADMINISTRATION MMC SNAP-IN建立池帳戶(hù)

配置文件格式化：

配置文件分為兩種：  GLOBAL（服務(wù)器全局模式）和 INDIVIDUAL（站點(diǎn)獨(dú)立設(shè)置模式）文件，GLOBAL（服務(wù)器端全局模式）配置文件應(yīng)該被放在ISAPI-REWRITE 安裝目錄中，名為 httpd.ini 。這個(gè)文件可以通過(guò)開(kāi)始菜單的快捷方式訪問(wèn)和配置，這個(gè)文件里面的映射規(guī)則為全局規(guī)則，將針對(duì)所有站點(diǎn)起效。INDIVIDUAL（站點(diǎn)獨(dú)立設(shè)置模式）配置文件應(yīng)該被放在虛擬站點(diǎn)的根目錄內(nèi)，也被命名為httpd.ini文件，這里面應(yīng)該放置針對(duì)站點(diǎn)的映射配置設(shè)置，只針對(duì)被放置的虛擬站點(diǎn)有效。兩種類(lèi)型的 httpd.ini 都是標(biāo)準(zhǔn)的windows ini 文件。所有的映射規(guī)則應(yīng)該被放置在 [ISAPI_Rewrite] 之后。之前的文件文本將被忽略。


HTTPD.INI文件示例

[ISAPI_Rewrite]

# This is a comment

# 300 = 5 minutes

CacheClockRate 300

RepeatLimit 20

# 設(shè)置其他人沒(méi)有下載 httpd.ini 和 httpd.parse.errors 文件的權(quán)限

RewriteRule /httpd(?:\.ini|\.parse\.errors) / [F,I,O]

# Block external access to the Helper ISAPI Extension

RewriteRule .*\.isrwhlp / [F,I,O]

# 配置規(guī)則

RewriteCond Host: (.+)

RewriteCond 指令

Syntax:（句法） RewriteCond TestVerb CondPattern [Flags]

這一指令定義一個(gè)條件規(guī)則，在 RewriteRule 或者 RewriteHeader或 RewriteProxy指令前預(yù)行RewriteCond指令，后面的規(guī)則只有它的，模式匹配URI的當(dāng)前狀態(tài)并且額外的條件也被應(yīng)用才會(huì)被應(yīng)用。

TestVerb

Specifies verb that will be matched against regular expression.

特別定義的動(dòng)詞匹配規(guī)定的表達(dá)式

TestVerb=(URL | METHOD | VERSION | HTTPHeaderName: | %ServerVariable) where:

URL - returns Request-URI of client request as described in RFC 2068 (HTTP 1.1);

返回客戶(hù)端在RFC2068中描述的需求的Request-URI

METHOD - returns HTTP method of client request (OPTIONS, GET, HEAD, POST, PUT, DELETE or TRACE);

返回客戶(hù)端需求(OPTIONS, GET, HEAD, POST, PUT, DELETE or TRACE)的HTTP方法

VERSION - returns HTTP version;

返回HTTP版本

HTTPHeaderName - returns value of the specified HTTP header. HTTPHeaderName can be any valid HTTP header name. Header names should include the trailing colon ":". If specified header does not exists in a client's request TestVerb is treated as empty string.

返回特定義的HTTP頭文件的值

HTTPHeaderName =

Accept:

Accept-Charset:

Accept-Encoding:

Accept-Language:

Authorization:

Cookie:

From:

Host:

If-Modified-Since:

If-Match:

If-None-Match:

If-Range:

If-Unmodified-Since:

Max-Forwards:

Proxy-Authorization:

Range:

Referer:

User-Agent:

Any-Custom-Header

得到更多的關(guān)于HTTP頭文件的和他們的值的信息參考RFC2068

ServerVariable 返回特定義的服務(wù)器變量的值 。例如服務(wù)器端口，全部服務(wù)器變量列表應(yīng)在IIS文檔中建立，變量名應(yīng)用%符預(yù)定；

CondPattern

The regular expression to match TestVerb

規(guī)則表達(dá)式匹配TestVerb

[Flags]

Flags is a comma-separated list of the following flags:

O (nOrmalize)

Normalizes string before processing. Normalization includes removing of an URL-encoding, illegal characters, etc. This flag is useful with URLs and URL-encoded headers

RewriteRule 指令

Syntax: RewriteRule Pattern FormatString [Flags]

這個(gè)指令可以不止發(fā)生一次，每個(gè)指令定義一個(gè)單獨(dú)的重寫(xiě)規(guī)則，這些規(guī)則的定義命令很重要，因?yàn)檫@個(gè)命令在應(yīng)用運(yùn)行時(shí)規(guī)則是有用途的

I (ignore case）

不管大小寫(xiě)強(qiáng)行指定字符匹配，這個(gè)FLAG影響RewriteRule指令和相應(yīng)的RewriteCond 指令

F (Forbidden)

對(duì)客戶(hù)端做反應(yīng)，停止REWRITING進(jìn)程并且發(fā)送403錯(cuò)誤，注意在這種情況下FORMATSTRING 是無(wú)用的并可以設(shè)置為任何非空字符串。

L (last rule)

不應(yīng)用任何重寫(xiě)規(guī)則在此停止重寫(xiě)進(jìn)程，使用這個(gè)FLAG以阻止當(dāng)前被重寫(xiě)的URI被后面的規(guī)則再次重寫(xiě)

N (Next iteration)

強(qiáng)制REWRITINGENGINE調(diào)整規(guī)則目標(biāo)并且從頭重啟規(guī)則檢查（所有修改將保存），重啟次數(shù)由RepeatLimit指定的值限制，如果這個(gè)數(shù)值超過(guò)N FLAG將被忽略

NS (Next iteration of the same rule)

以N標(biāo)記工作不從相同的規(guī)則重啟規(guī)則規(guī)則進(jìn)程（例如強(qiáng)制重復(fù)規(guī)則應(yīng)用），通過(guò)RepeatLimit指令指定一個(gè)反復(fù)實(shí)行某一規(guī)則的最大數(shù)目，

P (force proxy)

強(qiáng)制目的URI在內(nèi)部強(qiáng)制為代理需求并且立即通過(guò)ISAPI擴(kuò)展應(yīng)付代理需求，必須確認(rèn)代理字符串是一個(gè)有效的URI包括協(xié)議主機(jī)等等否則代理將返回錯(cuò)誤

R (explicit redirect）

強(qiáng)制服務(wù)器對(duì)客戶(hù)端發(fā)出重定向指示即時(shí)應(yīng)答，提供目的URI的新地址，重定向規(guī)則經(jīng)常是最后規(guī)則

RP (permanent redirect)

幾乎和[R]標(biāo)記相同但是發(fā)布301HTTP狀態(tài)而不是302HTTP狀態(tài)代碼

U (Unmangle Log)

當(dāng)URI是源需求而不是重寫(xiě)需求時(shí)記載URI

O (nOrmalize)

在實(shí)行之前標(biāo)準(zhǔn)化字符串。標(biāo)準(zhǔn)化包括URL-ENCODING，不合法的字符的再移動(dòng)等，這個(gè)標(biāo)記對(duì)于URLS和URLS-ENDODED頭是有用的

CL (Case Lower)

小寫(xiě)

CU (Case Upper)

大寫(xiě)

RewriteHeader directive

Syntax: RewriteHeader HeaderName Pattern FormatString [Flags]

這個(gè)指令是RewriteRule的更概括化變種，它不僅重寫(xiě)URL的客戶(hù)端需求部分，而且重寫(xiě)HTTP頭，這個(gè)指令不僅用于重寫(xiě)。生成，刪除任何HTTP頭，甚至改變客戶(hù)端請(qǐng)求的方法

HeaderName

指定將被重寫(xiě)的客戶(hù)頭，可取的值與 RewriteCond 指令中TestVerb參數(shù)相同

Pattern

限定規(guī)則表達(dá)式以匹配Request-URI，

FormatString

限定將生成新的URI的FormatString

[Flags]

是一個(gè)下列FLAGS的命令分隔列表

I (ignore case）

不管大小寫(xiě)強(qiáng)行指定字符匹配，這個(gè)FLAG影響RewriteRule指令和相應(yīng)的RewriteCond 指令

F (Forbidden)

對(duì)客戶(hù)端做反應(yīng)，停止REWRITING進(jìn)程并且發(fā)送403錯(cuò)誤，注意在這種情況下FORMATSTRING 是無(wú)用的并可以設(shè)置為任何非空字符串。

L (last rule)

不應(yīng)用任何重寫(xiě)規(guī)則在此停止重寫(xiě)進(jìn)程，使用這個(gè)FLAG以阻止當(dāng)前被重寫(xiě)的URI被后面的規(guī)則再次重寫(xiě)

N (Next iteration)

強(qiáng)制REWRITINGENGINE調(diào)整規(guī)則目標(biāo)并且從頭重啟規(guī)則檢查（所有修改將保存），重啟次數(shù)由RepeatLimit指定的值限制，如果這個(gè)數(shù)值超過(guò)N FLAG將被忽略

NS (Next iteration of the same rule)

以N標(biāo)記工作不從相同的規(guī)則重啟規(guī)則規(guī)則進(jìn)程（例如強(qiáng)制重復(fù)規(guī)則應(yīng)用），通過(guò)RepeatLimit指令指定一個(gè)反復(fù)實(shí)行某一規(guī)則的最大數(shù)目，

R (explicit redirect）

強(qiáng)制服務(wù)器對(duì)客戶(hù)端發(fā)出重定向指示即時(shí)應(yīng)答，提供目的URI的新地址，重定向規(guī)則經(jīng)常是最后規(guī)則

RP (permanent redirect)

幾乎和[R]標(biāo)記相同但是發(fā)布301HTTP狀態(tài)而不是302HTTP狀態(tài)代碼

U (Unmangle Log)

當(dāng)URI是源需求而不是重寫(xiě)需求時(shí)記載URI

O (nOrmalize)

在實(shí)行之前標(biāo)準(zhǔn)化字符串。標(biāo)準(zhǔn)化包括URL-ENCODING，不合法的字符的再移動(dòng)等，這個(gè)標(biāo)記對(duì)于URLS和URLS-ENDODED頭是有用的

CL (Case Lower)

小寫(xiě)

CU (Case Upper)

大寫(xiě)

要重移動(dòng)頭，F(xiàn)ORMAT STRING模式應(yīng)該生成一個(gè)空字符串，例如這一規(guī)則將從客戶(hù)請(qǐng)求中重移代理信息

RewriteHeader User-Agent: .* $0

并且這一規(guī)則將把OLD-URL HEADER 加入請(qǐng)求中。

RewriteCond URL (.*)RewriteHeader Old-URL: ^$ $1

最后一個(gè)例子將通過(guò)改變請(qǐng)求方法定向所有的WEBDAV請(qǐng)求到/WEBDAV。ASP

RewriteCond METHOD OPTIONS

RewriteRule (.*) /webdav.asp?$1

RewriteHeader METHOD OPTIONS GET

RewriteProxy directive

Syntax: RewriteProxy Pattern FormatString [Flags]

強(qiáng)制目的URI在內(nèi)部強(qiáng)制為代理需求并且立即通過(guò)ISAPI擴(kuò)展應(yīng)付代理需求，這將允許IIS作為代理服務(wù)器并且重路由到其他站點(diǎn)和服務(wù)器

Pattern

限定規(guī)則表達(dá)式以匹配Request-URI，

FormatString

限定將生成新的URI的FormatString

[Flags]

是一個(gè)下列FLAGS的命令分隔列表

D (Delegate security)

代理模式將試圖以當(dāng)前假冒的用戶(hù)資格登陸遠(yuǎn)程服務(wù)器，

C (use Credentials)

代理模式將試圖一在URL或基本授權(quán)頭文件中指定的資格登陸遠(yuǎn)程服務(wù)器，用這個(gè)標(biāo)記你可以使用http://user:password@host.com/path/ syntax 作為URL

F (Follow redirects)

缺省情況下ISAPI_Rewrite 將試圖將MAP遠(yuǎn)程服務(wù)器返回的重定向指令到本地服務(wù)器命名空間，如果遠(yuǎn)程服務(wù)器返回重定向點(diǎn)到那臺(tái)服務(wù)器其他的某個(gè)位置，ISAPI_Rewrite 將修改這一重定向指令指向本服務(wù)器名，這將避免用戶(hù)看到真實(shí)（內(nèi)部）服務(wù)器名稱(chēng)

使用F標(biāo)記強(qiáng)制代理模式內(nèi)部跟蹤遠(yuǎn)程服務(wù)器返回的重定向指令，使用這個(gè)標(biāo)記如果你根本不需要接受遠(yuǎn)程服務(wù)器的重定向指令，在WINHTTP設(shè)置中有重定向限制以避免遠(yuǎn)程重定向循環(huán)