url重寫IIRF(Ionic''s Isapi Rewrite Filter)手冊第1/2頁
2024-09-01 13:47:11
供稿：網友
說明
IIRF與ISAPI_Rewrite的規劃區別只在于IIRF不需要使用轉義字符/,而ISAPI_Rewrite則需要使用轉義字符/.
介紹
IIRF是一款開源的重寫URL過濾器，類似于Apache的URL重寫，基于VC8.0（可以用Visual Studio2005或Visual C++ 2005 Express重新編譯）開發。它可以運行在IIS5.0＋，支持ASP,ASP.NET,PHP等許多格式。相對比ASP.NET2.0自帶的URL重寫，具有更好的性能和許多我們所需要特性，重要的一點在于：它可以支持無擴展名的URL（例如：cnlbogs.com/****,你無需在創建一個默認的default.aspx文件，IIRF自動會幫你解析），讓URL更加的方便我們記憶，也能進一步提高搜索的排名？IIRF能夠在aspnet_isapi提前捕獲我們所請求的URL進行處理，如果我們訪問cnlbogs.com/a.aspx,需要獲取cnlbogs.com/a.htm,步驟需要(iis-aspnet_isapi),通過IIRF，我們可以直接跳aspnet_isapi.dll,直接訪問a.htm，要知道，這種方式在ASP.NET是無法實現的。
IIRF跟ASP.NET重寫URL一樣，它也是基于正則的方式來匹配，具有LOG記錄，請求的條件判斷。還是進入正題吧。
安裝
IIRF安裝需要我們手動操作來完成。不過。也是很方便了。
1 將IsapiRewrite4.dll, IsapiRewrite4.ini復制到c:/windows/system32/inetsrv(你也可以復制到其它適當的文件夾下面)。
IsapiRewrite4.ini是IIRF配置文件，每次該文件更改之后，IIRF會自動重新加載該文件，無需重啟IIS來重新加載配置，如果您修改后INI文件后格式不正確，IIRF將會自動獲取最后正確加載的配置文件。
2 打開IIS管理器,選擇“默認網站”，右擊“屬性”，選擇“ISAPI篩選器”，點擊“添加”，輸入篩選器名稱：Ionic Rewriter，可執行文件選擇上面復制到c:/windows/system32/inetsrv下面的IsapiRewrite4.dll文件，點“確定”。
3重啟IISADMIN service服務。（在計算機管理----windows服務里面）
4 完成。
日志
IIRF能夠將INI配置文件加載，用戶的URL請求記錄都會保存到指定的日志文件里。因為它具有很大的性能開銷，因此建議將它日志的記錄等級設為0，只有
為了方便調試的時候時候，可以設置為5，
RewriteLog 保存的日志路徑，如 c:/temp/iirfLog.out
RewriteLogLevel {0,1,2,3,4,5} 日志的等級,默認值為0
0 –不會記錄日志
1- 少許的日志
2- 比較多的日志
3- 比較詳細的日志
4- 詳細的日志（4），并會跟蹤server variable和替換的字符串。
5- 詳細的日志（5），包括日志文件更改的事件，建議方便調試的時候使用
正則
正則的語法跟.NET一樣，只不過是格式不一樣而已。所以我也不在詳細介紹。具體有關正則的說明大家可以用GOOGLE搜索。
格式：
RewriteRule <url-pattern> <replacement-string> [<modifiers>]
url-pattern：匹配的正則表達式(必需)
replacement-string:要替換的字符串（必需）
modifiers：有關對RewriteRule的操作標記?？蛇x選項。在下面我會說明
默認下IIRF的url-pattern，replacement-string正則的前面已經帶了主機頭的。
為了方便描述，直接看幾個示例(以下示例基本全部來源IIRF文檔)
RewriteRule ^/original/(.*).php /modified/$1.aspx
源：
目標：
RewriteRule ^/dinoch/album/([^/]+)/([^/]+).(jpg|JPG|PNG) /chiesa/pics.aspx?d=$1&p=$2.$3
源：
目標：?d=30&p=1.jpg
比較簡單，主要還在于modifiers的功能。下面列舉了它的所有值，允許組合(如[R,L])。
R = Redirect（URL跳轉到<replacement-string>地址）
NF = Not found(返回404錯誤給用戶，但該文件并未移除，還是保留在網站中）
L = Last test if match(如果已經匹配，將不在繼續匹配下去)
F = Forbidden(跟NF標志相似，)
I = Do case-insensitive matching
U = Store original url in server Variable HTTP_X_REWRITE_URL(保存原始的url到HTTP_X_REWRITE_URL服務器變量中。)
[R] or [R=code]
就像跟我們在ASP.NET使用的Redirect方法一樣，重新改變瀏覽器的方向，跳轉到新的指定的URL中。
[R=code]允許我們指定特定的HTTP狀態返回碼。只能介于301到399。如果超出這個范圍。默認會是使用302狀態。
RewriteRule ^/goto.aspx?r=(.*)$ $1 [R]
源:?r=http://www.google.com/
目標:
[L]
上面已經簡單介紹過。不在說明
[NF]
上面已經簡單介紹過。它還可以跟RewriteCond一起配合，來實現自定義的404錯誤請求。
特別要注意，你所要匹配的文件必須存在，替換的字符串不允許是存在文件名
RewriteRule ^/1008.aspx$ /1.aspx [NF]
1008.aspx文件需要存在，1.aspx不存在，否則無法正常達到我們的結果。
（很奇怪，我不知道是不是我搞錯了。但我最終測試的結果確實是這樣，文檔也沒詳細說明過，有知道的朋友可以告訴我一下原因）
[F]
不在說明。
[I]
模糊匹配
[U]
保存原始的url到HTTP_X_REWRITE_URL服務器變量中。
在ASP.NET你可以用Request.ServerVariables["HTTP_X_REWRITE_URL"]獲取原始值。
