ISAPI_Rewrite3.1 中文手冊 中文幫助文件

第一章：軟件介紹
ISAPI_Rewrite 是一款適用于IIS的功能強大的基于正則表達式的URL處理模塊。它兼容Apache的mod_rewrite的語法，從而使僅僅復制.htaccess文件就把配置從appach移植到IIS中或者從IIS移值到appach中變成可能。請參閱3.2兼容性圖表這一節(jié)。
ISAPI_Rewrite最重要的功能：
? ISAPI_Rewrite提供了和Apach mod_rewrite相同的句法和行為，使僅僅拷貝.htaccess文件就完成配置移植成為功能。(要想閱讀更多關于與mod_rewrite的兼容性，請參閱3.2兼容性圖表這一節(jié)。)
? 正則表達式支持靈活而強大的配置。
? 極速而且容易升級的純C++代碼。
? 真正的分布式配置：實時監(jiān)控服務器全局級別、虛擬主機（網站）級別、目錄級別的.htaccess文件。
? 隔離性：用戶級配置只影響本地用戶環(huán)境，從而使ISAPI_Rewrite成為Web主機提供商的理想解決方案。
重要的應用示例：
? 搜索引擎優(yōu)化。
? 一臺Web服務器的代理內容經過另一臺web服務器。
? 防止內容被吸血（盜鏈）。
? 阻斷特定主機、反向鏈接或者煩人的搜索機器人。
? 內容商議：向不同的語言用戶或者不同的瀏覽器用戶提供不同的文件。示例
? 為群集式服務器架構模擬負載均衡。
定價資料
? 45天的試用期
? 單機版99美元
? ISAPI_Rewrite精簡版是免費的。在這里可以看到受限的細節(jié)說明。
? 大宗采購可議折扣。

2.1系統(tǒng)要求
ISAPI_Rewrite可以被安裝在下列操作系統(tǒng)中：
? Windows 2000 with IIS 5
? Windows XP with IIS 5.1
? Windows Server 2003 with IIS 6.0
? Windows Vista with IIS 7.0
? Windows Server 2008 with IIS 7.0
在安裝ISAPI_Rewrite之前，操作系統(tǒng)中必須先安裝IIS。
32位和64位的Windows版本都是支持的，但是你必須下載32位版和64位版兩種不同的安裝包。Windows Installer 2.0必須運行安裝程序。你可以從微軟的網站上下載到最新版本的Windows Installer。
在Windows Vista和Windows Server 2008上安裝ISAPI_Rewrite，還必須先安裝下面兩個模塊(默認情況下這兩個模塊是不安裝的)
? ISAPI過濾器
? ISAPI 擴展

2.2安裝程序
在運行安裝包之前請先閱讀系統(tǒng)要求部分。下載并安裝某個版本的ISAPI_Rewrite.msi，依照安裝向導的說明操作。安裝過程是自動的，并有自我描述。ISAPI_Rewrite在自動安裝過程中必須重啟IIS。下列服務必須被重啟：IISADMIN、W3SVC。不需要手工把任何ISAPI篩選器或者擴展加入到網站或者全局列表中。它能夠在安裝和配置過程中自動完成。
命令行安裝
ISAPI_Rewrite也能夠通過命令行進行后臺安裝。請使用以下命令行語法來安裝：

msiexec /i ISAPI_Rewrite3.msi /qn AcceptEULA=Yes REGISTRATIONCODE=Code 
REGISTRATIONNAME=Name

用命令行來后臺反安裝ISAPI_Rewrite請使用下面的語法：

msiexec /x ISAPI_Rewrite3.msi /qn KEEPUSERFILES=Yes

2.3手工安裝
要手工安裝ISAPI_Rewrite的話，你必須下載不同的手工安裝包包含所有必須的文件。ISAPI_Rewrite精簡版不支持手工安裝。你可以安裝全部功能或者僅僅安裝它們中的一部分。
手工安裝包包含下列文件：
? ISAPI_Rewrite.dll - 這是ISAPI篩選器本身。
? ISAPI_RewriteProxy.dll - 這是為代理操作的ISAPI擴展模塊必不可少的。
? license.rtf - EULA的產品許可證。
? ISAPI_Rewrite.chm - .文檔文件。
? httpd.conf - 全局配置文件示例。
安裝ISAPI_Rewrite，首先你必須在你在IIS系統(tǒng)中注冊ISAPI_Rewrite.dll作為ISAPI篩選器。按默認ISAPI_Rewrite.dll文件是用來作為全局ISAPI篩選器的。而且它還能夠被安裝到某個特定的網站里，你需要記住在同一時間段里只有一個ISAPI_Rewrite.dll實例能夠加載到一個IIS工作進程里，這意味著如果你決定把ISAPI_Rewrite的ISAPI篩選器單獨地安裝到每個站點里的話，你必須把這些站點切換高隔離模式，從而為這些網站產生獨立的工作進程。如果你需要在每個站點上分別安裝ISAPI_Rewrite，我們通常會建議改為在整個IIS上全局地安裝它。
在Window 2000,Window XP 和Windows Server 2003中注冊ISAPI 篩選器，無論是整個IIS服務器要用它還是個別WEB網站要用它，都要用IIS 的MMC管理單元來把ISAPI_Rewrite.dll添到ISAPI篩選器列表。在Windows Vista和Windows Server 2008中首先你需要安裝可選IIS組件：萬維網服務、應用程序開發(fā)功能、ISAPI篩選器。
如果你需要代理服務器功能，你還需要將ISAPI_RewriteProxy.dll注冊為ISAPI擴展來侍服文件擴展名“*. rwhlp”。在不同的IIS版本中要求不同的操作。請參閱你管理的IIS版本的文檔來了解如何注冊一個新的ISAPI擴展并把它映射到IIS系統(tǒng)的文件擴展名上。在Windows Vista和windows server 2008首先必須安裝可選的IIS組件：萬組網服務、應用程序開發(fā)功能、ISAPI篩選器。使用短路徑名（8.3模式）作為ISAPI_RewriteProxy.dll的模塊路徑，如果路徑里有一個空格字符，IIS載入這個模塊時將失敗。
把httpd.conf文件放在ISAPI_Rewrite.dll文件的同一目錄下并編輯它。
把下列兩行內容放到httpd.conf文件中以注冊ISAPI_Rewrite 產品：

RegistrationName=Your registration name
RegistrationCode=REG-CODE-PROVIDED-FROM-HELICON

依照“運行ISAPI_Rewrite的權限需求”這一部分的說明來檢查文件系統(tǒng)權限。

2.4反安裝
反安裝程序會刪除所有安裝程序所生成的文件、從管理元庫中注銷篩選器，并刪除所有由安裝程序所添加的其它管理元庫變化。如果用戶決定在反安裝過程中保留用戶文件的話，下列用戶數據文件在反安裝后會被留下來。

“刪除用戶創(chuàng)建的文件”的選項在將反安裝過程中提供給用戶。如果啟用這個選項則卸載程序也將刪除位于Program Files文件夾里用戶創(chuàng)建的文件。 .htaccess文件不會被刪除。
要用命令行后臺卸載ISAPI_Rewrite，請使用下面的語法：

msiexec /x ISAPI_Rewrite3.msi /qn KEEPUSERFILES=Yes

2.5運行ISAPI_Rewrite所需的權限
在一個干凈的默認Windows系統(tǒng)上自動安裝ISAPI_Rewrite不要求任何權限調整。但是一些其它產品比如說Plesk、IIS鎖定工具的安裝，等等，可能收緊服務器的安全性，并妨礙ISAPI_Rewrite的正常運行。下面是ISAPI_Rewrite的權限需求的列表單子：
在Windows 2000、Windows XP和Windows 2003的IIS5兼容模式下，篩選器運行在System帳戶下的inetinfo.exe進程中。那個system帳戶至少得被授予放置ISAPI_Rewrite安裝文件的那個文件夾的“讀取”和“目錄瀏覽”的權限。我們還建議給予system帳號對這個文件夾的一般修改權。這將允許生成一些包含解析或者其它錯誤的文件。system帳號還必須在任何包含了.htaccess文件的網站文件夾里同樣被授予這些權限，否則ISAPI_Rewrite將不能加載并監(jiān)視它。
請稍留意ISAPI_Rewrite安裝目錄上的任何一點拒絕權限設置，因為在Windows 操作系統(tǒng)中，拒絕權限優(yōu)先于任何允許權限記錄。
在Windows 2003的天然IIS模式(WPI模式)以及Windows Server 2008中，無論是篩選器還是代理服務都運行在每個網站相應的運行程序池的w3p.exe工作進程中，每個應用程序池都可以使用它自己的定制來配置，這可能使權限設置成了一種復雜的工作。然而，在一個正確的IIS配置中，每個使用中的定制必須是IIS_WPG組的一個成員。因此，IIS_WPG組可以被用來代替System帳號去分配前面所寫的權限需求。
在Windows Vista 中權限配置是和Windows 2003的配置差不多的，只是它沒有IIW_WPG組。所以，所有的WPI帳號（一般Network Service是它的惟一帳號）都必須授予上述必需權限。
此外，為了讓代理服務功能能工作，你必須在網站屬性或者運行代理服務的web應用程序的屬性中給予一個“純腳本”的執(zhí)行權限。

2.6MSI的自定義行為自定義行為
 

3.1基本概念

	if (isset($_SERVER['HTTP_X_REWRITE_URL']))
{
$_SERVER['REQUEST_URI'] = $_SERVER['HTTP_X_REWRITE_URL'];
}

單個字符轉義序列
下面的轉義序列是單個字符的別名：

雜項轉義序列
以下提供perl的大部分兼容性，但是在\l、\L、\u和\U上有一些區(qū)別

怎樣得到匹配
正則表達式將匹配第一個可匹配字符串。如果從給定的起始處可以匹配到不止一個字符串，則它會匹配那個能匹配得最長的字符串。如果從同一個起始處有多個合適的匹配，而且每個匹配的長度都一樣，則將選擇那個第一子表達式匹配得最長的匹配。如果有兩個以上的匹配字符串它們的第一子表達式匹配得一樣長，則比較第二子表達式匹配的長度，如此類推。注意：ISAPI_Rewrite使用比封演算法。只有表達式匹配了整個順序串才能得到匹配結果。例如：
• RewriteCond URL ^/somedir/.* #將匹配任何導向somedir目錄以及它的子目錄的請求，與此同時，
• RewriteCond URL ^/somedir/ #只匹配somedir根目錄的請求。
對“病態(tài)”正則表達式的特別提示：
ISAPI_Rewrite 使用了一個非常強大的來自Boost庫的正則表達式引擎。但是它依然有一些局限性：有著一些“病態(tài)”的表達式，它可能會指數級地消耗匹配時間。這些都涉及到嵌套重復運算符，例如試圖對N個連續(xù)字母a匹配表達式“(a*a)*b”，消耗的時間將與N²成正比。這些表達式常常能改成另一種寫法來避免這種問題。例如，“(a*a)*b”可以被改寫成“a*b”，解析它消耗的時間與N成正比。在多數情況下，非嵌套重復表達式消耗的時間與N²成正比，但是，如果條款是相互排斥的，則它們會在線性時間里完成匹配。在“a*b”這種情況下，每個字符將要么匹配a要么匹配b或者不匹配。相較之下，“a*a”匹配器不能告知哪個分支被采�。ǖ谝粋� a還是第二個a）因此必須嘗試兩種。
Regex可以檢測出這種“病態(tài)”的正則表達式并終止和它們的匹配。這將使ISAPI_Rewrite的規(guī)則失效。當一個規(guī)則失效時，ISAPI_Rewrite將給客戶端發(fā)送一個"Internal Server error - Rule Failed"的狀態(tài)，以表示配置錯誤。

4.1AccessFileName指令

指定一個ISAPI_ReWrite尋求分布式配置的文件名列表。默認文件名是.htaccess。ISAPI_ReWrite只能載入它能在這個列表中找到的第一個文件。默認情況下ISAPI_ReWrite管理者會以hidden屬性標記配置文件-它將防止文件被遠程用戶直接訪問到。
如果配置文件進行了任何修改，它將在下次請求服務器時自動加載。

4.2AllowOverride指令

這個指令聲明了在分布式.htaccess文件里的指令是否可以覆蓋父級別的httpd.conf中的指令。在ISAPI_Rewrite的使用環(huán)境中，這個指令實際上控制了特定虛擬主機或者目錄的.htaccess文件的可用或者不可用。目前只支持三個值：All、None和FileInfo。
All和FileInfo使.htaccess文件以及它里面的整個ISAPI_Rewrite目錄可用，None使所有的.htaccess文件以及目錄不可用。這些目錄具有繼承性。這意味著如果你為一些目錄或者虛擬主機指定AllowOverride none，.htaccess文件將對整個子目錄樹不可用。

4.4RewriteRule指令

這個指令定義了單個URL重寫操作。它可能在一個配置文件中出現多次，每個實例定義一個重寫URL的規(guī)則。RewriteRule指令包含URL匹配模式、替換字符串以及可選的標志設置。
Pattern（模式）是一個用來匹配當前URL的Perl兼容正則表達式。當前的URL可以是原來請求的URL或者已經由優(yōu)先級高的規(guī)則替改過的URL。網址從不包含協議或者主機名，從第一個斜杠字符開始（只對httpd.conf文件適用）。而且當前網址還因不同的應用配置級別而異。對于目錄級配置（.htaccess文件），結尾的斜線和配置文件的目錄名，會在匹配時被從URL中忽略掉。在創(chuàng)建正則表達式時，請閱讀這個文檔的正則表達式語法部分來得到更多的信息。
"!"字符打頭的模式將否定整個表達式。否定模式不能產生子匹配，所以你不能使用$N的替代引用。
Substitution(替換)字符串指定了模式是匹配時生成URL的格式字符串。除了純文本，它可以包括這些特殊字符。
• 對Rewrite模式的回溯引用 $N
• 對Rewrite模式的回溯引用 %N
• 服務器變量 %{VARNAME}
• 條件格式模式 ?Ntrue_string:false_string
• 分組括號“(”和“)”
替換字符串將所有的字符視為字面值，除了$'、'\'、'('、')'，'?'，':'和'\'。為了字面化地讀出特殊字符，它定義了用"\"引導的轉義字符。下面的特殊字符是允許的。

RewriteRule從父配置文件開始按照在配置文件中出現的次序應用。每個規(guī)則只有在它的Pattern匹配了一個URL而且所有連接條件（RewriteCond）都匹配時才會被應用。在該URL用Substitution完成替換之后，重寫過程還在繼續(xù)，一直到配置文件結束或者遇到一個用了任何停止標志的規(guī)則。在Substitution中的特殊字符串"-"(短橫)意味著沒有替換，而且當你需要應用該規(guī)則并留下的原始的未被染指過的URL時它是很有用的。
此外，這里有一個支持的flag(標志)列表。這些標識可以改變規(guī)則的表現。與Apache完全兼容的標志被標記為綠色，不支持的標志被標記為綠色，只在 ISAPI_Rewrite中被支持的標識被標記成黃色。
CU (Case Upper)
把替換字符串改成大寫.
CL (Case Lower)
把替換字符串改成小寫.
chain|C
將當前規(guī)則與后一條規(guī)則鏈接起來，后一條規(guī)則只有在當前規(guī)則被匹配的情況下才能被執(zhí)行。鏈接可以再后續(xù)鏈接。
cookie|CO=NAME:VAL:domain[:lifetime[:path]]
設置一個有指定字段的cookies頭，并把它和當前請求的響應一起發(fā)送到客戶端。
env|E=VAR:VAL
不支持，在UNIX環(huán)境中設置一個環(huán)境變量，在Windows系統(tǒng)中無意義。
forbidden|F
發(fā)送即時403 FORBIDDEN響應到客戶端，停止這個請求的規(guī)則處理以及所有其他的替換處理。
gone|G
發(fā)送一個即時401Gone響應到客戶端，停止這個請求的規(guī)則處理以及所有其他的替換過程。
handler|H=Content-handler
不支持，為請求明確指定了處理處理。在IIS的世界中這是可以通過重寫請求的文件擴展名來實現。但是沒有從Apache處理到IIS文件擴展名的直接轉換方法。
last|L
停止這里的重寫處理，不再應用當前配置文件中的其它規(guī)則。在這種情況下，后代的.htaccess文件依然能被用到。
loop|LP
在一個循環(huán)中重復運行當前單個規(guī)則直到它的模式以及條件不再被匹配了。循環(huán)次數被限定為200免得陷入無限循環(huán)。
next|N
從當前配置文件開始處重復運行重寫處理。循環(huán)次數被限定為200免得陷入無限循環(huán)。
nocase|NC
這個標記使Pattern大小寫不敏感。
noescape|NE
不轉義輸出。在ISAPI_Rewrite默認情況下，在輸出中會把所有的非ANSI字符編碼為十六進制數%xx。
nosubreq|NS
這個標識在ISAPI_Rewrite中與在Apache中含義不同。精確的轉換是不可能的，但這個標志可能仍然是有用的。每當配置文件處理完成之后，URL被重寫了，ISAPI_Rewrite將啟動這個新的URL處理過程（與Apache相同）使它可以應用到另一個配置文件中。此標識意思是該規(guī)則只針對初始用戶的請求執(zhí)行，不針對已被重寫過的請求執(zhí)行，以防可能出現的循環(huán)。ISAPI_Rewrite限定循環(huán)重復次數為10。
nounicode|NU
如果設置了NU標記，從Unicode轉換為UTF - 8將不會發(fā)生。所有Unicode字符會保持它的%xx格式不變。
O (nOrmalize)
留著用于與ISAPI_Rewrite 2.x兼容。如果使用了RewriteCompatibility2，這個指令在處理之前將URL規(guī)范化。規(guī)范化包括移除一個URL編碼、錯誤字符，等等。同時URL的規(guī)范化將完全移除它的查詢字符串。如果RewriteCompatibility2 沒有被使用，URL按照默認被規(guī)范化（就如同它在mod_rewrite中所做的），此標志的含義將反轉。
proxy|P
將結果URL強制內部處理為另一臺服務器上的目標，并即時傳到遠程服務器上，并且，規(guī)則處理在這里中斷了。遠程服務器的響應將被傳遞回客戶端。proxy需要您指定完整的URL，由協議、主機名稱等開頭。ISAPI_Rewrite使用ISAPI擴展來處理代理請求。你可以在代理配置章節(jié)中閱讀到更多有關于此的內 容。
passthrough|PT
不支持或者始終支持。在IIS中結果始終傳遞到下一個處理
qsappend|QSA
追加當前查找串的數據到替換串而不是由一個替換字符串取代它。當你需要在保留原來的參數再添加更多的查詢字符串參數時，可以使用它。
redirect|R [=code]
強制服務器用重定向指令給客戶端發(fā)送一個即時響應，提供一個新的接替位置�？梢赃x加前綴http://thishost[:thissport]/從而把URL帶到一個可用的絕對形式。如果沒有給出代碼，將使用一個302響應(暫時性移動)。你可以選擇在3XX系列范圍內指定任何代碼。
skip|S=num
如果當前的規(guī)則匹配，強制rewrite引擎跳過后面num個規(guī)則。
type|T=MIME-type
強制目標文件的MIME類型轉換成被設定的MIME類型。這能夠被用來根據一些條件設置內容類型。
U (Unmangle log)
無損記錄。記錄它原來請求的網址，而不是被重寫的URL。

4.5RewriteCond指令

該指令為后面的RewriteRule，RewriteHeader或RewriteProxy指令規(guī)定了一個條件。一個規(guī)則指令前可以有一個或多個條件，規(guī)則只有在所有條件得到滿足的情況下才被應用。
TestString附加到純文本可以包含下列結構。
• 用語法$N回溯引用RewriteRule模式
• 用語法%N回溯引用前面的RewriteCond模式
• 用語法${mapname:key|default}擴展RewriteMap
• 用語法%{HTTP:header}指代HTTP頭值
• 用語法%{NAME_OF_VARIABLE}指代服務器變量
以下是可用的服務器變量列表：

CondPattern指定一個應用于TestString實例的正則表達式，以下特殊值也支持：
1.在正則表達式前頭加“!”符號指明否定模式。
2.'<CondPattern'將CondPattern作為一個純字符串按字典順序比較，結果比較大
3.'>CondPattern'按字典順序比較，結果比較小
4.'=CondPattern'按字典順序比較，結果相等
5.'-d' 檢測字符串是否存在目錄。
6.'-f' 檢測字符串是否存在文件。
7.'-s' 檢測字符串是不是一個非零大小的文件。
8.'-l' (鏈接) 不支持的，始終為false。
9.'-x' (擁有可執(zhí)行權限) 不支持的，始終為true。
10.'-F' (存在的文件，通過子請求) 不支持，和'–f'一樣。
11.'-U' (存在的URL，通過子請求) 不支持的，始終為false。
下面的標記也是支持的：
'nocase|NC'
這個標記使模式大小寫不敏感。
'ornext|OR'
這個標記用邏輯或而不是隱含的邏輯與結合子請求RewriteCond指令。
O
留用于ISAPI_Rewrite 2.x的兼容性。在處理前規(guī)范化字符串。規(guī)范化包括移除一個URL編碼、錯誤字符，等等。同時URL的規(guī)范化將完全移除它的查詢字符串。

4.6RewriteBase指令

當RewriteRule指令用于每個目錄的配置文件(.htaccess)時，它將自動從路徑中剝去本地目錄前綴，只對剩下的部分應用規(guī)則。RewriteBase指令允許你為這些規(guī)則精確指定一個基準。比如，哪部分要被剝離。
和Apache的mod_rewrite不同，ISAPI_Rewrite的訪問不僅僅針對于物理路徑，同時還針對于虛擬路徑，而且可以自動地選擇正確的基準。所以這個指令只是為了兼容性原因而被保留的。
URL-path可以是相對于根的路徑也可以是空，空的URL-path意味著規(guī)則的基準等同于網站的根目錄。

4.7RewriteProxy指令

使結果URL被內部處理為另一臺服務器上的目標，并即時傳遞到遠程服務器，從此中斷了規(guī)則處理。遠程服務器的響應將被傳遞回客戶端。代理要求您指定完整的URL，由協議，主機名稱等開頭。ISAPI_Rewrite使用ISAPI擴展來處理代理請求。你可以在配置代理的章節(jié)里閱讀到更多。
語法和操作符與RewriteRule指令是相同的。但是RewroteProxy指令支持一些額外的標記。
H (preserve Host)
代理模塊在連接遠程服務器時將使用隨著源請求一起發(fā)送過來的主機頭，如果沒有這個標志代理服務器則將用主機名和遠程服務器的端口號組成主機頭。
A (Add authentication headers)
允許從代理服務器將一個認證信息傳遞到局域網服務器上，當客戶端認證和代理服務器沖突時它很有用。服務模塊將對一個請求的服務器變量

AUTH_TYPE,
AUTH_USER,
LOGON_USER,
REMOTE_USER

追加相應的頭

X-ISRW-Proxy-AUTH-TYPE,
X-ISRW-Proxy-AUTH-USER,
X-ISRW-Proxy-LOGON-USER,
X-ISRW-Proxy-REMOTE-USER

到被代理的服務器。
CR (use Credentials)
代理模塊將嘗試用在URL中指定的證書身份驗證登錄遠程服務器，或者用基本身份驗證頭登錄遠程服務器。用了這個標志，你可以在一個替換字符串中使用http://user:password@host.com/page語法作為一個URL。

4.8RewriteHeader指令

這個RewriteHeader指令是RewriteRule指令中的一個很常用的變量。而且它被設計用來重寫客戶端的URL部分以及HTTP頭的部分。技術上的RewriteRule指令，相當于RewriteHeader的URL Pattern Substitution [flag]。這個指令可用于在IIS里更多應用程序的處理之前重寫、創(chuàng)建或者刪除任何客戶端請求的HTTP頭。
HeaderName：指定將被重寫的HTTP頭的名字。
pattern、Substitution和flag與RewriteRule指令中都是相同的。

4.9RewriteMap指令

RewriteMap指令被用來定義一個鍵到值的查找功能。當你需要映射大量的值時，它會很有用的，而且它的速度遠遠快過用規(guī)則匹配來做到它。映射功能的性能受映射文件的大小影響微乎其微。有三種類型的映射：
• txt：用一個文本文件映射
• rnd：從多個可選項中產生隨機值
• int：內部函數
MapName是這個映射功能的名字，在RewriteRule命令中被用來指定這個映射。請確保每個映射用唯一的名稱定義。你可以使用以下語法在RewriteRule指令的Substitution參數中調用映射功能

${ MapName : LookupKey | DefaultValue } 

如果這個結構是在Substitution中出現，ISAPI_Rewrite將在映射中查找這個鍵，萬一找到了一個，就用它的值替換這個結構。如果什么值也沒有被找到，將用可選的DefaultValue。如果沒有指定DefaultValue，它將用一個空串替換。
下面的標志也是支持的：
‘nocase|NC’
這個標志使該查找鍵大小寫不敏感。
下面是一個大小寫不敏感映射文件指令的示例

RewriteMap examplemap txt:C:/path/to/file/map.txt [NC]

到MapSource文件的路徑，既可以是絕對地址也可以是相對地址。相對地址將被從當前配置的文件夾開始推算，換言之，就是從這個定義映射的配置文件的路徑開始推算。
然后你可以在RewriteRule中如下使用這個映射：

RewriteRule ^/ex/(.*) ${examplemap:$1}

下列MapType和MapSource的組合是可用的：
txt：純文本映射，它的source是到一個可用的文本文檔的windows文件系統(tǒng)路徑。文本文檔必須是如下格式的：

#This is a comment
key1 value1 #Another comment
key2 value2
keyN valueN

rnd：隨機查找多個值。Source是一個文本文檔的路徑，文本文檔必須是以下格式：

#This is a comment
key1 value1|value2|value3
key2 value4|value5|value6|valueN

int: 調用內部函數。 Source必須是下列預定義的內部函數之一：
• toupper: 轉換關鍵詞為大寫形式。
• tolower:轉換關鍵詞為小寫形式。
• escape:把特定字符編碼為十六進制。
• unescape:把十六進制值編譯為特定字符。

4.10RewriteLog指令

這個指令用來設定記錄ISAPI_Rewrite動作的日志文件的文件名。示例：

Rewritelog "C:\local\path\rewrite.log"

4.11RewriteLogLevel指令

這個指令設置日志的輸出長度。默認值0表示不記日志，而最大的級別9則表示所有的動作都要記錄。
使用使用較高的級別值可能會降低ISAPI_Rewrite的操作速度。我們建議你當你完成規(guī)則調試之后，通過設置日志級別為零來禁用日志。

4.12RewriteOptions指令

這個指令可以為ISAPI_Rewrite設置特定選項。當前只有惟一一個選項可用：inherit。
inherit：強迫當前配置從父級繼承所有的選項和規(guī)則。這意味著來自父級配置的所有的規(guī)則將被再次執(zhí)行，除非當前環(huán)境另有相應重寫規(guī)則。

4.13RewriteCompatibility2指令

這一指令將激活與ISAPI_Rewrite 2.x版的兼容性，將一些2.X的規(guī)則正確地翻譯為3.0版本的語法。這并不意味著ISAPI_Rewrite 3將開始懂得不經修改舊的語法。如果您有針對ISAPI_Rewrite 2.X的舊設計請使用ISAPI_Rewrite提供的翻譯工具將這些舊規(guī)則轉化為新的語法規(guī)則。
現在通過設置指令RewriteCompatibility2唯一改變的是，它將關閉網址常規(guī)前綴并刪除查詢字符串。 Apache的mod_rewrite將刪除匹配的URL的查詢字符串的這部分，相較之下ISAPI_Rewrite 2.X將匹配整個網址（包括查詢字符串在內），而且[O]標記的意思將由該指令倒置。

4.14ErrorLog指令

這個指令設置存放ISAPI_Rewrite整體錯誤和消息的日志文件的名稱。例如httpd.conf file load, .htaccess file load,等等
例：ErrorLog "C:local\path\error.log"

4.15LogLevel指令

這個指令設置一般日志的輸出長度，跟它的重寫過程無關。這里有一個level的可用值列表：emerg、alert、crit、error、warm、notice、info、debug。當前的ISAPI_Rewrite日志只記錄錯誤信息。
設置LogLevel調試來解決配置文件中加載的問題。

4.16<VirtualHost>指令

<VirtualHost> ... </VirtualHost>標簽用來對應用到特定虛擬主機里的指令進行分組。
addr的可用值為：
• 特定的IP地址
• 完整的域名
• 字符'*'可以匹配任何主機或者特定服務器的任何端口號。
例如：

RewriteEngine off
AllowOverride none
<VirtualHost onesite.com www.onesite.com>
RewriteEngine on
AllowOverride all
</VirtualHost> 

不要忘了在每個<VirtualHost>標簽中包含RewriteEngine on指令，也不要將不能應用的規(guī)則封裝進去。

4.17<Directory>指令

<Directory> ... </Directory>標簽被用來對應用到特定文件系統(tǒng)目錄以及子目錄的指令進行分組。通配符?和*是可用的。正則表達式也是可用的，需要以~字符打頭。
對目錄路徑參數必須小心：它們必須字面匹配用來訪問文件的文件系統(tǒng)路徑，用于某一特定<Directory>的指令并不適用于來自同一目錄下通過不同的路徑的文件訪問，例如通過不同的符號鏈接。只有完整的文件路徑是被允許使用的。
示例：

<Directory C:/inetpub/>
  AllowOverride None
</Directory>
<Directory C:/inetpub/home/>
  AllowOverride FileInfo
</Directory>
<Directory ~ "C:/inetpub/wwwroot/.*/[0-9]{3}">
  # ... directives here ...
</Directory>

不要忘了在每個<Directory>標簽中包含RewriteEngine on指令，也不要將不能應用的規(guī)則封裝進去。

4.18<DirectoryMatch>指令

<DirectoryMatch> ... </DirectoryMatch> 被用來封裝一個只適用于指定的文件系統(tǒng)的目錄和子目錄的指令組。這個指令和<Directory ~> 語法相同。
示例：

<DirectoryMatch "^/www/(.+/)?[0-9]{3}">
   # ... directives here ... 
</DirectoryMatch> 

不要忘了在每個< DirectoryMatch>標簽中包含 RewriteEngine on指令，也不要將不能應用的規(guī)則封裝進去。

4.19<Files> 指令

<File>指令以文件名限定了封裝的指令的作用域。filename參數必須包含一個文件名，支持?和*以及以~字符打頭的正則表達式。
示例：

<Files index.*>
   # ... directives here ... 
</Files>
<Files ~ "\.(gif|jpe?g|png)$">
   # ... directives here ... 
</Files>

不要忘了在每個<Files>標簽中包含RewriteEngine on指令，也不要將不能應用的規(guī)則封裝進去。

4.20<FilesMatch>指令

<FilesMatch>指令的語法和_指令"><Files ~>語法完全一樣。

<FilesMatch "\.(gif|jpe?g|png)$"> 

不要忘了在每個<FilesMatch>標簽中包含RewriteEngine on指令，也不要將不能應用的規(guī)則封裝進去。

4.21<Location>指令

<Location> ... </Location>標簽用來將應用到特定URL或者虛擬路徑的指令分組。<Location>將運算符完全從文件系統(tǒng)中分劃出來，因此那些指令將不會用來控制對文件文件系統(tǒng)位置的訪問。因為有幾個不同的URL可能映射到相同的文件系統(tǒng)位置。
該URL-path是一個形式為“/path/”的虛擬路徑。沒有協議、主機名、端口號、查詢請求字符串被包含在內。URL-path可以包含通配符?和*或者以~字符打頭的正則表達式。
示例：

<Location /directory>
  # ... rules go here
</Location>
<Location />
   # ... more rules go here
</Location>

不要忘了在每個<Location>標簽中包含RewriteEngine on指令，也不要將不需要用到的規(guī)則封套進去。

4.22<LocationMatch>指令

這個指令的語法和指令"><Location ~>正則表達式語法完全一樣。
示例：

<LocationMatch "/(home|section)/bin">
   # ... rules go here
</LocationMatch> 

不要忘了在每個<LocationMatch>標簽中包含RewriteEngine on指令，也不要將不能應用的規(guī)則封裝進去。

示例

	RewriteEngine on
RewriteRule ^(.*?\.asp)/([^/]*)/([^/]*)(/.+)? $1$4?$2=$3 [NC,LP,QSA]

	RewriteEngine on
RewriteRule ^(.*?\.asp)~([^~]*)~([^~]*)(.*) $1$4?$2=$3 [NC,LP,QSA]

	RewriteEngine on
RewriteBase /
RewriteRule ^products/[^?/]*_(\d+)\.asp /productpage.asp?productID=$1 [QSA]

另一個更復雜的解決方案是創(chuàng)建一對一的映射文件，并用它來映射“our_super_tool”到127。該解決方案對一些有很多參數的長URL來說很有用，并允許你隱藏數字標識符。這URL看起來像是http://www.mysite.com/products/our_super_tool.asp。請注意“our_supper_tool”部分必須是產品的唯一標識，是它的標識符。下面是這種解決方案的一個示例：

RewriteEngine on
RewriteBase /
RewriteMap mapfile txt:mapfile.txt
RewriteRule ^products/([^?/]+)\.asp /productpage.asp?productID=${mapfile:$1}

而且你必需創(chuàng)建包含以下內容的mapfile.txt映射文件：

one_product       1
another_product   2
our_super_tool    127
more_products     335

這種方法的優(yōu)點是：你可以使用它來組合十分復雜的URL轉換，但是這是一個小例子，是這個指南中的題外之話。
使用IIS作為反向代理 假設你有運行IIS的互聯網服務器以及幾臺后臺服務器或者應用程序運行在其它平臺或者機器上。這些服務器不能直接在互聯網上閱覽，但是你必須為他人提供訪問這些服務器的渠道。這里有一個演示如何簡單地將某個網站的完整內容映射到另一個運行了ISAPI_Rewrite的站點的文件夾的示例：

RewriteEngine on
RewriteBase / 
RewriteRule mappoint(.+) http://sitedomain$1 [NC,P]

藏匿文件擴展名： 雖然不可能將一個站點的所有的文件的擴展名都藏匿起來，但是我們可以使用ISAPI_Rewrite的文件檢查功能來隱藏某些已知擴展名。這里有一個藏匿網站上.asp文件擴展名的規(guī)則示例：

RewriteEngine on
#Redirect extension requests to avoid duplicate content
RewriteRule ^([^?]+)\.asp$ $1 [NC,R=301,L]
#Internally add extensions to request
RewriteCond %{REQUEST_FILENAME}.asp -f 
RewriteRule (.*) $1.asp

仿真基于主機頭的虛擬網站 例如你已經注冊了兩個域名www.site1.com和www.site2.com�，F在你可以使用同一個物理站創(chuàng)建兩個不同的站點了。這里是一個規(guī)則示例：

RewriteEngine on
#Fix missing trailing slash char on folders
RewriteRule ^([^.?]+[^.?/])$ $1/ [R,L]
#Emulate site1
RewriteCond %{HTTP:Host} ^(?:www\.)?site1\.com$
RewriteRule (.*) /site1$1 [NC,L,NS]
#Emulate site2
RewriteCond %{HTTP:Host} ^(?:www\.)?site2\.com$
RewriteRule (.*) /site2$1 [NC,L,NS] 

現在只要把你的站點分別放到/site1和/site2目錄下就可以了。注意www.site1.com和www.site2.com這兩個域名必須在IIS中被映射到這個網站里，從而使ISAPI_Rewrite能攔截到請求。
或者，你可以使用更多通用的規(guī)則，從而把任何請求都映射到與請求主機名同名的文件夾里。

RewriteEngine on
#Fix missing trailing slash char on folders
RewriteRule ^([^.?]+[^.?/])$ $1/ [R,L]
#Map requests to the folders
RewriteCond %{HTTP:Host} ^(www\.)?(.+)
RewriteRule (.*) /%2$1 [NS]

網站的目錄名應該是這樣子的：/somesite1.com，/somesite2.info，等等。
阻斷內聯圖像（阻止盜鏈） 假如你有一些頁面插入了http://www.mysite.com/下的gif圖片。一些其它站點將通過網頁超鏈接插入這些圖片。這會給你的網站增加很多無用的通訊量，而且你希望阻止這種做法。
雖然用ISAPI_Rewrite不能100%地保護圖片不被盜鏈（只有專門的反盜鏈產品才能做到它），你至少可以在瀏覽器發(fā)來HTTP引用頭的時候限制這種情況。下面的規(guī)則可以讓你只允許來自同一主機的引用頁或者空地址訪問到這些圖片。

RewriteEngine on
RewriteCond %{HTTP:Host}#%{HTTP:Referer} ^([^#]+)#(?!http://\1).+
RewriteRule .*\.(?:gif|jpg|png) /block.gif [NC]

重定向非www的版本到www
如果你的網站同時可以通過兩種形式的URL比如說http://helicontech.com和http://www.helicontech.com來訪問到，那么最好將一種地址重定向到另一種地址里，來避免搜索引擎對重復內容做出的處罰。下面是一個能將所有的非www地址重定向到相應的www地址上去的301重定向規(guī)則。

RewriteEngine on
RewriteCond %{HTTPS} (on)?
RewriteCond %{HTTP:Host} ^(?!www\.)(.+)$ [NC]
RewriteCond %{REQUEST_URI} (.+)
RewriteRule .? http(?%1s)://www.%2%3 [R=301,L]

強制SSL或者非SSL到一個指定的位置
這里是一個演示如何將SSL強制轉到指定的文件夾的示例。只要簡單地把下面的規(guī)則放到該文件夾下的.htaccess文件里就可以了。

RewriteEngine on
#Fix missing trailing slash char on folders
RewriteRule ^([^.?]+[^.?/])$ $1/ [R,L]
#Redirect non-HTTPS to HTTPS
RewriteCond %{HTTP:Host} (.*)
RewriteCond %{HTTPS} off
RewriteCond %{REQUEST_URI} (.*)
RewriteRule .? https://%1%2 [R,L]

而這個示例作用正好相反：將非SSL強制轉到指定文件夾。

RewriteEngine on
#Fix missing trailing slash char on folders
RewriteRule ^([^.?]+[^.?/])$ $1/ [R,L]
#Redirect HTTPS to non-HTTPS
RewriteCond %{HTTP:Host} (.*)
RewriteCond %{HTTPS} on
RewriteCond %{REQUEST_URI} (.*)
RewriteRule .? http://%1%2 [R,L]

轉移站點位置
當你把網站從一個域名移到另一個域名，或者從一個文件夾移動另一個文件夾里的時候，這是經常會遇到的問題。你希望將一個網站的所有請求重定向到另一個網站里，而且不丟失請求資源名以及參數。當你希望保留現有的網頁的排名和外鏈接的時候，它是非常有用的。這個解決方案是在舊的網站服務器上使用ISAPI_Rewrite：

RewriteEngine on
#Permanent redirect to update old links
RewriteRule (.+) http://newserver.com$1 [R=301,L]

平衡負荷仿真
這個示例模擬某種DNS輪換負荷平衡技術。假設你有主站www.mysite.com和數臺web服務器分別注冊為www[1-9].mysite.com。如果你在主服務器上安裝了ISAPI_Rewrite，你可以將初始的客戶端請求重定向到幾臺特定服務器，從而在幾臺服務器之間隨機攤開通訊量。一旦已重定向，客戶端將一直使用這一臺服務器。雖然這種解決方案并不非常理想，但是它確實能分攤你的通訊量并避免在維護會話狀態(tài)方面發(fā)生的問題。
使用下面的規(guī)則來重定向客戶端：

RewriteEngine on
RewriteMap hosts rnd:hosts.txt
RewriteCond %{HTTP:Host} (www)\.mysite.com [NC]
RewriteRule (.*) http://${hosts:%1}.mysite.com$1 [R,L]

下面是hosts.txt文件的內容

www www1|www2|www3|www4|www5|www6|www7|www8|www9

你還可以在Apeche文檔里找到很多其它有用的例子。它們多數不需要修改就可以在ISAPI_Rewrite3里使用。

故障處理

	RewriteLogLevel 9
LogLevel debug

ISAPI_Rewrite 發(fā)布歷史
發(fā)布 3.1.0.67
================
[篩選器功能] 增強映射文件的動態(tài)加載
[代理幫助文件錯誤]如果后端不設置內容長度頭的話，并不會返回所有的響應。
發(fā)布 3.1.0.66
================

精簡版的限制
ISAPI_Rewrite的精簡版擁有相同的引擎和重寫功能。但是也有下面這些限制：
? 不支持分布式.htaccess配置、目錄以及網站級配置，只有一個精簡版安裝目錄中的全局的httpd.conf配置能被載入。
? 不支持<VirtualHost>、<Directory>、<DirectoryMatch>、<Files>、<FilesMatch>、<Location> 以及<LocationMatch>這幾個標簽。
? 精簡版中沒有代理服務模塊，因而所有的和代理服務功能相關的比如說RewriteProxy指令以及[P]標記都會被忽略。
? 精簡版沒有針對于虛擬主機環(huán)境的手工安裝包
ISAPI_Rewrite精簡版完全免費，它對開發(fā)或者測試目的以及只有幾個網站而且不需要分布式配置或者代理功能的小型服務器來說是一個很好的解決方案

技術信息 ISAPI_Rewrite由四個部分組成：ISAPI篩選器、ISAPI擴展幫助、GUI管理器以及MMC嵌入式管理單元擴展。ISAPI_Rewrite篩選器和擴展都是用純C++語言寫的快速DLL模塊。當安裝ISAPI_Rwrite的時候， MMC嵌入式管理單元會被自動注冊。ISAPI篩選器將安裝在一個全局級別上，你不需要手工注冊它。ISAPI擴展也會被安裝并注冊。
ISAPI_Rewrite管理器實用工具可以在沒有安裝MMC的系統(tǒng)中運行ISAPI_Rewrite MMC嵌入式管理單元。
Windows Vista以及Windows Server 2008系統(tǒng)中的ISAPI_Rewrite管理器實用工具(Helicon Manager.exe)要求管理員權限來執(zhí)行，因為較小權限的用戶沒有權力讀取IIS管理元庫，而它對顯示網站配置來說是必需的。如果用受限的帳號運行ISAPI_Rewrite管理器，你會得到登錄管理員帳號的自動提示。
ISAPI_Rewrite篩選器已經有足夠地快，因此不用擔心它的性能。除非你的服務器運行在最大負荷之下。用戶在響應時間或者CPU負荷方面幾乎不能發(fā)現什么區(qū)別，但是如果用了很多的規(guī)則的話，服務器最大帶寬可能掉下一點來。所以請注意你用的配置決定了性能。建議每個網站使用的規(guī)則不要超過100條。在多數情況下，可以利用RewriteMap來避免使用大量的規(guī)則。
該程序使用了Regex++ 庫。
Regex++ (Version Boost 1.31)
Copyright ?1998-2004, Dr John Maddock

使用和傳播許可
該使用許可覆蓋了所有的現有版本的ISAPI_Rewite，包括ISAPI_Rewrite、ISAPI_Rewrite完全版、ISAPI_Rewrite精簡版、ISAPI_Rewrite測試版，后面統(tǒng)稱為ISAPI_Rewrite除非另有指明。
1.所有未明確授予的權利均由Helicon Tech保留。
2.所有的關于ISAPI_Rewrite的版權都由它的作者Helicon Tech獨家保留。
3. Helicon Tech準予免費使用ISAPI_Rewrite精簡版產品。
4. Helicon Tech準予免費試用ISAPI_Rewrite產品30天，當試用期結束時，請要么購買ISAPI_Rewrite，要么刪除ISAPI_Rewrite產品。
5.未注冊過的ISAPI_Rewrite試用版，可以在不被改動的前提下自由傳播，除非有下例情況。任何個人或者公司都不用為在未得版權持有人書面許可的情況下傳播ISAPI_Rewrite而付費。未經版權持有者的書面許可，未注冊的試用版ISAPI_Rewrite不允許捆綁其它安裝包。
6. ISAPI_Rewrite必須被原樣傳播，不提供任何形式的保證明示或暗示。你可以在你自己的磁盤上使用ISAPI_Rewrite。作者不為因為濫用本軟件導致的數據丟失、損壞，或任何其他類型的損失承擔責任。
7.你不得使用、復制、模仿、克隆、出租、出售、修改、反編譯、反匯編以及其它任何反向工程，或者轉讓許可程序，或者任何許可程序的一個子集，除非本協議有提供。任何未經授權的使用將導致本許可自動終止。并可能導致刑事或民事起訴。
8.本許可協議的條款是在未來版本的ISAPI_Rewrite將會有所變化。
9.當你購買ISAPI_Rewrite時，將發(fā)給你“注冊碼”。這種“注冊碼”可以個人或者公司購買，并只在一臺計算機上使用。如果您購買一個以上的ISAPI_Rewrite副本，發(fā)給你們的“注冊碼”只能在等于你購買的許可證數的計算機上使用。
10.您只能使用來自Helicom Tech以及與Helicom Tech有業(yè)務合作或者技術合作的公司的注冊碼。
11. 安裝和使用ISAPI_Rewrite意味著接受這些條款及許可條件。
12. 如果您不同意本許可證的條款或違反本許可與您當地的法律規(guī)定，您必須從您的存儲設備中刪除ISAPI_Rewrite文件，并停止使用該產品。
13.我們堅持嚴格的隱私的準則，不會收集個人識別信息，除非是自愿提供的。
如果您有進一步的問題或意見，請訪問我們的http://www.helicontech.com。
感謝你使用ISAPI_Rewrite。
Helicon Tech Corporation.

轉自：asprain