Yii 框架 URL 美化：移除 index.php 並啟用 Path 格式與 .html 後綴

預設 Yii URL 格式 ?r=controller/action 不利 SEO，本文示範四步驟實現 /controller/action.html 友善路徑。

Step 1：Apache 啟用 mod_rewrite

# httpd.conf
LoadModule rewrite_module modules/mod_rewrite.so  # 取消註解
<Directory "D:/var/www/html">
    AllowOverride All  # 確保存在
</Directory>

重啟 Apache。

Step 2：Yii urlManager 設定

編輯 protected/config/main.php：

'urlManager'=>array(
    'urlFormat'=>'path',
    'showScriptName'=>false,
    'urlSuffix'=>'.html',
    'rules'=>array(),
),

• urlFormat='path'：改用 /controller/action/param/value 格式
• showScriptName=false：隱藏 index.php
• urlSuffix='.html'：偽靜態後綴

Step 3：專案根目錄建立 .htaccess

Options +FollowSymLinks
IndexIgnore */*
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php

Step 4：驗證

原 ?r=admin/UserInfo/admin 現可用 /admin/UserInfo/admin.html 存取。

常見問題排查

• 404：確認 AllowOverride All、mod_rewrite 載入、.htaccess 權限
• 無限重導：檢查 RewriteBase 是否需設定
• 參數丟失：rules 需進一步定義參數對應規則