Zend Framework MVC 大小寫路由問題完美解決：支持駝峰 Action 與 URL 不敏感

問題背景

ZF1 默認 Controller/Action **區分大小寫**，且 URL 映射規則固定：
`CoderBlogAction` → `/controller/coder-blog/`（大寫字母前加連字符）。
這導致兩個痛點：

1. 開發習慣駝峰命名，URL 需手動轉換，易出錯
2. 用戶輸入大寫 URL（如 `/Controller/Action`）直接 404

解決方案：兩步走

步驟 1：啟用大小寫敏感路由

// Bootstrap.php 或 application.ini
$front = Zend_Controller_Front::getInstance();
$front->setParam('useCaseSensitiveActions', true);

效果：Action 名稱保留大小寫，路由匹配時區分大小寫。

步驟 2：統一 URL 為小寫（核心修正）

在基礎 Controller 的 `init()` 中強制轉換：

class App_Controller_Action extends Zend_Controller_Action {
    public function init() {
        // 統一轉小寫，URL 不再區分大小寫
        $request = $this->getRequest();
        $request->setModuleName(strtolower($request->getModuleName()));
        $request->setControllerName(strtolower($request->getControllerName()));
        $request->setActionName(strtolower($request->getActionName()));
    }
}

// 所有業務 Controller 繼承此基類
class IndexController extends App_Controller_Action {
    public function CoderBlogAction() { /* ... */ }
}

原理深度解析

1. useCaseSensitiveActions = true 讓路由器保留原始大小寫
2. Dispatch 前在 `init()` 將 Request 物件的 Module/Controller/Action **全部轉小寫**
3. Dispatcher 查找類/方法時使用轉換後的小寫名稱
4. 類名/方法名實際定義仍可駝峰，PHP 類/方法名**本身不區分大小寫**

SEO 與用戶體驗優勢

• URL 統一小寫：`/index/coder-blog/` 更利於 SEO（搜索引擎視大小寫為不同頁面）
• 用戶隨意大小寫訪問均正常，無 404 挫敗感
• 連字符分隔單詞（`coder-blog`）比駝峰更語義化

進階：自定義路由器實現更優雅映射

class App_Controller_Router_Standard extends Zend_Controller_Router_Route_Module {
    public function match($path, $partial = false) {
        $path = strtolower($path); // 全路徑小寫匹配
        return parent::match($path, $partial);
    }
    
    public function assemble($data = [], $reset = false, $encode = false) {
        // 組裝 URL 時自動轉小寫 + 連字符
        foreach (['module', 'controller', 'action'] as $key) {
            if (isset($data[$key])) {
                $data[$key] = strtolower($data[$key]);
            }
        }
        return parent::assemble($data, $reset, $encode);
    }
}

// 註冊路由器
$front->setRouter(new App_Controller_Router_Standard());

避坑提醒

• 模塊名：若使用模塊，同樣需轉小寫
• 視圖腳本：`views/scripts/controller/action.phtml` 文件名建議小寫，匹配轉換後的 action 名
• URL 助手：`$this->url(['action' => 'CoderBlog'])` 組裝時會經過路由器 `assemble`，自動轉小寫
• 大小寫敏感文件系統：Linux 下類文件名需與類名大小寫一致（PSR-4 自動加載已保證）

總結

通過 啟用大小寫敏感參數 + Request 預處理轉小寫，完美解決 ZF1 駝峰命名與 URL 大小寫衝突問題，兼顧開發習慣、SEO 最佳實踐與用戶體驗。建議封裝為基礎 Controller/Router 組件，項目初期即引入。