Yii2 主题记录

15 Oct 2015 Category: PHP

Yii2本身支持多模块,多主题开发。因此对开发中遇到的多主题问题,以及自定 义不同模块主题需要的注意事项进行记录

默认全局主题在配置文件中添加comment配置


 'view' => [
            'theme' => [
                'basePath' => '@app/themes/{themesName}',
                'baseUrl' => '@web',
                'pathMap' => [
                    '@app/views' => '@app/themes/{themesName}',
                ],
            ],
  ]

如果有多个不同的模块,想要在不同的模块中设置不同的模板,在模块的入口文 件中添加


        \Yii::$app->view->theme = new \yii\base\Theme([
            'pathMap' => ['@app/views' => '@app/admin/views'],
            'baseUrl' => '@web',
        ]);

YII2中主题layout文件机制,如果定义了重新定义了@app/views,则在该目录下搜 索layout文件夹中的布局文件,如果没有,则在默认文件中寻找。其他页面的view 文件也是如此。

如果你跟我一样,将themes文件放置在app根目录内,而网站更目录是@app/web,那 么还需要对主题的静态文件做稍微修改。 YII2中,web可以访问的目录是限制在@web目录下。所以以上情况需要将主题的静态 文件使用Assets发布。

比如主题的路径@app/themes/tfviolet,在该目录下(该目录下其他目录内也可以)建 立一个ThemeAsset文件


namespace app\themes\tfviolet;

use yii\web\AssetBundle;

class ThemeAsset extends AssetBundle
{
    public $sourcePath = '@app/themes/tfviolet/static';
    public $css = [

        'css/materialize.min.css',
        'css/style.css'
    ];

    public $js = [
        'js/materialize.min.js'
    ];
}

注意,一定要定义sourcePath,只有这样才能将sourcePath的所有文件发布到asset目 录下。发布的目录是@basthPath/asset 定义sourcePath之后,该Assets的baseUrl, basePath则是无效的,被AssetManage覆盖。