ThinkPHP 空模板與空模組機制實戰應用

ThinkPHP 提供 _empty 操作與 EmptyAction 空模組機制，優雅處理「操作不存在」與「模組不存在」的 404 情況，避免拋出預設錯誤頁面，提升用戶體驗與 SEO 友善度。

一、空操作（_empty 方法）

當訪問的 Action 方法不存在時，自動觸發控制器中的 _empty($name) 方法：

<?php
class IndexAction extends Action {
    public function _empty($name) {
        // $name 為嘗試訪問的不存在方法名
        $this->error("$name 操作不存在 <a href='__APP__/Index/index'>返回首頁</a>");
    }
}
?>

二、空模組

當訪問的模組不存在時，框架自動尋找 EmptyAction 類別：

<?php
class EmptyAction extends Action {
    public function index() {
        // 獲取 URL 中的模組名（即城市名、專題名等）
        $name = MODULE_NAME;

        // 通用邏輯：查詢城市資料
        $city = M('City');
        $list = $city->select();
        $this->assign('list', $list);

        // 動態載入對應模板：City:城市名
        $this->display("City:$name");
    }
}
?>

實戰場景：城市子站/專題頁

• URL：/beijing/、/shanghai/、/guangzhou/
• 無需為每個城市建立獨立模組/控制器
• EmptyAction::index() 統一處理，根據 MODULE_NAME 動態渲染模板
• 模板結構：Tpl/City/beijing.html、Tpl/City/shanghai.html...

進階技巧

• 404 狀態碼：在 _empty/EmptyAction 中輸出 header('HTTP/1.0 404 Not Found'); 利於 SEO
• 記錄日誌：記錄不存在的操作/模組名，分析用戶行為或發現死連結
• 友善導引：提供搜尋框、熱門推薦、網站地圖連結，降低跳出率

注意事項

1. 空模組僅在模組不存在時觸發，模組存在但操作不存在走 _empty
2. MODULE_NAME 取得的是 URL 解析出的模組名（區分大小寫視配置而定）
3. 模板檔案需實際存在，否則仍會拋出模板不存在錯誤