在 Yii2 Starter Kit 的后台应用中，新建一套主题的流程

$配置 view 应用组件的 [[yii\base\View::theme|theme]] 属性$

作者：

永夜

在

项目构建, yii2-starter-kit, Web前端, Yii, 开发工具, Web框架, Web应用开发, Yii 2

Post Views: 131

1、新建目录：\backend\views\themes\default，指定包含主题资源(CSS, JS, images, 等等)的基准目录，如图1

2、复制目录：\backend\views\ 下的所有文件(除去themes)，如图2

3、粘贴至目录：\backend\views\themes\default\ 下，已经复制成功，如图3

4、配置 view 应用组件的 [[yii\base\View::theme|theme]] 属性，如图4

PHP

    'components' => [
        'view' => [
            'theme' => [
                'basePath' => '@app/views/themes/default',
                'baseUrl' => '@web/views/themes/default',
                'pathMap' => [
                    '@app/views' => '@app/views/themes/default',
                ],
            ],
        ],
    ],


    'components' => [
        'view' => [
            'theme' => [
                'basePath' => '@app/views/themes/default',
                'baseUrl' => '@web/views/themes/default',
                'pathMap' => [
                    '@app/views' => '@app/views/themes/default',
                ],
            ],
        ],
    ],

配置 view 应用组件的 [[yii\base\View::theme|theme]] 属性 — 图4

5、配置 Gii 模板文件，其主题为：default，如图5

PHP

if (YII_ENV_DEV) {
    $config['modules']['gii'] = [
        'class' => yii\gii\Module::class,
        'generators' => [
            'crud' => [
                'class' => yii\gii\generators\crud\Generator::class,
                'templates' => [
                    'yii2-starter-kit' => Yii::getAlias('@backend/views/themes/default/_gii/templates')
                ],
                'template' => 'yii2-starter-kit',
                'messageCategory' => 'backend'
            ]
        ]
    ];
}


if (YII_ENV_DEV) {
    $config['modules']['gii'] = [
        'class' => yii\gii\Module::class,
        'generators' => [
            'crud' => [
                'class' => yii\gii\generators\crud\Generator::class,
                'templates' => [
                    'yii2-starter-kit' => Yii::getAlias('@backend/views/themes/default/_gii/templates')
                ],
                'template' => 'yii2-starter-kit',
                'messageCategory' => 'backend'
            ]
        ]
    ];
}

6、主题化模块，如：i18n ，新建目录：\backend\modules\i18n\views\themes\default，如图6

7、复制目录：\backend\modules\i18n\views\ 下的所有文件(除去themes)，如图7

8、粘贴至目录：\backend\modules\i18n\views\themes\default\ 下，已经复制成功，如图8

9、配置 view 应用组件的 [[yii\base\View::theme|theme]] 属性，如图9

PHP

        'view' => [
            'theme' => [
                'basePath' => '@app/views/themes/default',
                'baseUrl' => '@web/views/themes/default',
                'pathMap' => [
                    '@app/views' => '@app/views/themes/default',
                    '@app/modules/i18n/views' => '@app/modules/i18n/views/themes/default',
                ],
            ],
        ],


        'view' => [
            'theme' => [
                'basePath' => '@app/views/themes/default',
                'baseUrl' => '@web/views/themes/default',
                'pathMap' => [
                    '@app/views' => '@app/views/themes/default',
                    '@app/modules/i18n/views' => '@app/modules/i18n/views/themes/default',
                ],
            ],
        ],

10、通过 [[yii\base\View::theme]] 属性访问 [[yii\base\Theme]] 对象。编辑：\backend\views\themes\default\sign-in\login.php，如图10

PHP

$theme = $this->theme;
print_r($theme);
exit;


$theme = $this->theme;
print_r($theme);
exit;

通过 [[yii\base\View::theme]] 属性访问 [[yii\base\Theme]] 对象。编辑：\backend\views\themes\default\sign-in\login.php — 图10

11、打印出的对象，如图11

yii\base\Theme Object
(
[pathMap] => Array
(
[@app/views] => @app/views/themes/default
[@app/modules/i18n/views] => @app/modules/i18n/views/themes/default
)

[_baseUrl:yii\base\Theme:private] => /views/themes/default
[_basePath:yii\base\Theme:private] => E:\wwwroot\cmcp\backend/views/themes/default
[_events:yii\base\Component:private] => Array
(
)

[_behaviors:yii\base\Component:private] =>
)

12、在 .env 中设置主题名称：default，如图12

Plaintext

# Themes
# ----
BACKEND_THEME = default


# Themes
# ----
BACKEND_THEME = default

13、设置主题相关别名，编辑：\backend\config\bootstrap.php，定义别名，如图13

PHP

/**
 * Setting theme aliases
 */
Yii::setAlias('@themePath', '@backend/web/themes/' . env('BACKEND_THEME'));
Yii::setAlias('@themeUrl', '@backendUrl/themes/' . env('BACKEND_THEME'));


/**
 * Setting theme aliases
 */
Yii::setAlias('@themePath', '@backend/web/themes/' . env('BACKEND_THEME'));
Yii::setAlias('@themeUrl', '@backendUrl/themes/' . env('BACKEND_THEME'));

设置主题相关别名，编辑：\backend\config\bootstrap.php，定义别名 — 图13

14、第5步骤的设置，调整，如图14

PHP

if (YII_ENV_DEV) {
    $config['modules']['gii'] = [
        'class' => yii\gii\Module::class,
        'generators' => [
            'crud' => [
                'class' => yii\gii\generators\crud\Generator::class,
                'templates' => [
                    'yii2-starter-kit' => Yii::getAlias('@backend/views/themes/' . env('BACKEND_THEME') . '/_gii/templates')
                ],
                'template' => 'yii2-starter-kit',
                'messageCategory' => 'backend'
            ]
        ]
    ];
}


if (YII_ENV_DEV) {
    $config['modules']['gii'] = [
        'class' => yii\gii\Module::class,
        'generators' => [
            'crud' => [
                'class' => yii\gii\generators\crud\Generator::class,
                'templates' => [
                    'yii2-starter-kit' => Yii::getAlias('@backend/views/themes/' . env('BACKEND_THEME') . '/_gii/templates')
                ],
                'template' => 'yii2-starter-kit',
                'messageCategory' => 'backend'
            ]
        ]
    ];
}

15、第9步骤的设置，调整，如图15

PHP

        'view' => [
            'theme' => [
                'basePath' => '@app/views/themes/' . env('BACKEND_THEME'),
                'baseUrl' => '@web/views/themes/' . env('BACKEND_THEME'),
                'pathMap' => [
                    '@app/views' => '@app/views/themes/' . env('BACKEND_THEME'),
                    '@app/modules/i18n/views' => '@app/modules/i18n/views/themes/' . env('BACKEND_THEME'),
                ],
            ],
        ],


        'view' => [
            'theme' => [
                'basePath' => '@app/views/themes/' . env('BACKEND_THEME'),
                'baseUrl' => '@web/views/themes/' . env('BACKEND_THEME'),
                'pathMap' => [
                    '@app/views' => '@app/views/themes/' . env('BACKEND_THEME'),
                    '@app/modules/i18n/views' => '@app/modules/i18n/views/themes/' . env('BACKEND_THEME'),
                ],
            ],
        ],

16、新建目录：\backend\web\themes\default，指定包含主题资源(CSS, JS, images, 等等)的基准目录，如图16

17、复制目录：\backend\web\ 下的目录(css、img、js)，如图17

18、粘贴至目录：\backend\web\themes\default\ 下，已经复制成功，如图18

19、基于主题重新定义资源包，编辑：\backend\assets\BackendAsset.php，如图19

PHP

    public $basePath = '@themePath';
    public $baseUrl = '@themeUrl';


    public $basePath = '@themePath';
    public $baseUrl = '@themeUrl';

基于主题重新定义资源包，编辑：\backend\assets\BackendAsset.php — 图19

20、查看登录页面的源代码，最大的变化在于包含的CSS/JS文件，其路径为绝对路径，如图20

PHP / Laravel / Yii2 老项目维护与长期技术支持

如果你的 PHP / Laravel / Yii2 项目已经上线，但遇到原开发离职、Bug 长期无人修复、接口不稳定、性能下降、代码难以接手等问题，可以联系我做一次远程技术排查。

适合以下情况：
✅ 老旧 PHP 系统无人维护
✅ Laravel / Yii2 项目 Bug 修复
✅ 后台管理系统小功能迭代
✅ RESTful API 接口排查
✅ MySQL / Redis / Nginx 性能问题
✅ 长期远程兼职维护

可先从一次小问题开始：
✅ 线上报错排查
✅ 接口异常分析
✅ 慢查询与性能瓶颈定位
✅ 代码结构初步评估
✅ 部署环境与日志检查

如需咨询，请联系我，并注明：PHP 维护咨询。

联系方式：
Telegram：@shuijingwan
微信：13980074657
邮箱：shuijingwanwq@gmail.com

Yii2 OAuth2 Server yii2-starter-kit backend view theme 资源包 AssetBundle Yii 2 Asset template

发表回复取消回复

这个站点使用 Akismet 来减少垃圾评论。了解你的评论数据如何被处理。

在 Yii2 Starter Kit 的后台应用中，新建一套主题的流程

评论

发表回复 取消回复

更多文章

放弃 Type-C 转 VGA 后，我为 ThinkPad T570 换了一台 HDMI 副屏：Ubuntu 双屏终于恢复正常

智谱 GLM-5.2 费用明细为什么有 4 条？3 次 API 请求与 10,880 Tokens 的完整对账

GLM-5.2 整篇翻译持续返回 HTTP 400：从安全检测拦截到 Plaintext 载荷缩减的完整排查与修复

WordPress 网站根目录清理实战：从误粘贴生成的 0 字节文件，到历史脚本、验证文件与旧安装包逐项排查

发表回复取消回复