IIS 偽靜態 (URL Rewrite) 部署完整教學

部署步驟

1. 下載元件：取得 dv_iis_url_rewrite.zip（含 IisUrlRewriter.dll、IisUrlRewriter.ini），解壓至本地目錄（例：C:\Rewrite）。
2. 開啟 IIS 管理員：依序展開「本機電腦 → 網站 → 預設網站」或目標網站。
3. 新增 ISAPI 篩選器：
   • 右鍵網站 → 「內容」 → 「ISAPI 篩選器」頁籤 → 「新增」。
   • 篩選器名稱輸入 URLRewriter，可執行檔指向 C:\Rewrite\IisUrlRewriter.dll。
   • 確定儲存。
4. 驗證生效：若未立即生效，執行 iisreset 重啟 IIS 服務。

規則配置範例：ASP → PHP 映射

編輯 IisUrlRewriter.ini，尋找並啟用以下規則（移除行首 #）：

RewriteRule ^(.*?(?:index|dispbbs))\.asp(.*)$ $1.php$2&__is_iis_rewrite=1

儲存後同樣需 iisreset 生效。此規則將 /forum/dispbbs.asp?tid=123 透明重寫為 /forum/dispbbs.php?tid=123&__is_iis_rewrite=1，實現無縫遷移或偽靜態呈現。

常見問題排查

• DLL 載入失敗：確認 IisUrlRewriter.dll 檔案存在、路徑正確、IIS 執行身份具讀取執行權限。
• 規則不生效：檢查 .ini 語法、正則表達式是否匹配目標 URL、是否已重啟 IIS。
• 日誌分析：啟用 IIS 詳細日誌，觀察 cs-uri-stem 欄位確認重寫前後路徑。

提示：生產環境建議先在測試站點驗證規則邏輯，避免正則錯誤導致全站 500 錯誤。