Yii2 Gii 自定義模板完整配置教程

Yii 簡介
Yii 是高效能、基於元件的 PHP 框架，適合開發大型 Web 應用（入口網站、論壇、CMS、電商、RESTful 服務等）。目前主流為 2.0 版，採用 Composer、PSR、命名空間、Traits 等現代技術。

為什麼要自定義 Gii 模板？

Gii 內建的 CRUD 模板僅為通用範例，實際專案往往需要符合團隊規範的程式碼結構、命名慣例、權限控制等。自定義模板可一次配置、長期受益。

步驟

1. 複製預設模板：vendor/yiisoft/yii2-gii/generators/crud/default 複製至專案目錄，如 @app/giitemplate/crud/default。
2. 修改應用配置（config/main.php 或 config/web.php）：

$config['modules']['gii'] = [
    'class' => 'yii\gii\Module',
    'allowedIPs' => ['127.0.0.1', '::1'],
    'generators' => [
        'crud' => [
            'class' => 'yii\gii\generators\crud\Generator',
            'templates' => [
                'myCrud' => '@app/giitemplate/crud/default', // 模板名 => 路徑
            ],
        ],
    ],
];

3. 使用：開啟 Gii CRUD 生成器，Code Template 下拉選單即會出現 myCrud，選擇後即可按專案需求修改模板檔案。

掌握此技巧，即可讓 Gii 產出完全符合專案規範的程式碼，大幅提升開發效率。