Yii2 之 frontend 子模块实践之三：布局和语言配置 [ 2.0 版本 ]

▪ 环境

基于《Yii2 之 frontend 子模块实践之一：添加前后台子模块》。

基于《Yii2 之 frontend 子模块实践之二：构建子模块的独立配置》。

▪ 配置子模块的布局

既然启用了 子模块，那么我们就希望每个 子模块 的布局文件直接放到其根目录之下，例如 [Sub Module Path]/views/layouts/，这样就比较利于管理。

在 《Yii2 之 frontend 子模块实践之一：添加前后台子模块》 文章中，我们通过在 子模块 根目录下 Module.php 文件里的 init() 函数中添加 $this->layout = 'main'; 代码来设置每个 子模块 的独立布局文件。

现在请先删除两个 子模块 根目录下 Module.php 文件里的 $this->layout = 'main'; 代码，因为接下来我们将介绍更巧妙更方便的方法设置。

编辑两个 子模块 的 [Sub Module Path]/Config.php 文件，添加如下配置项：

'layout' => '@module/views/layouts/main'

别名 @module 的具体值请参见 《Yii2 之 frontend 子模块实践之二：构建子模块的独立配置》

说明：当 frontend 应用主体 实例化一个子模块时，别名 @module 将被赋值为当前激活的 子模块 根目录路径；当控制器渲染视图时，自然就调用当前 子模块 下的视图文件。

▪ 配置子模块的语言

无论是不是简单的企业网站，还是复杂平台网站；无论是否只有一种语言，还是有多种语言；都建议大家使用语言文件包，也许它会给你的项目开发增加一点点时间，但是其后期带来的可维护性还是非常不错的。

在此之前，还是希望大家先看看官方的 Yii2 国际化 介绍。

1. 语言包目录配置

同 布局 的架构方式一样，我们也希望每个 子模块 的语言包文件直接放到其根目录之下，例如 [Sub Module Path]/languages/，这样就比较利于管理，话不多说，直接编辑两个 子模块 的 [Sub Module Path]/Config.php 文件，添加如下配置项即可：

'components' => [

    // ...
    
    'i18n' => [
        'translations' => [
            '*' => [
                'class' => 'yii\i18n\PhpMessageSource',
                'basePath' => '@module/languages',
            ]
        ]
    ]
    
    // ...
}

说明：当 frontend 应用主体 实例化一个子模块时，别名 @module 将被赋值为当前激活的 子模块 根目录路径；当控制器渲染视图时，自然就调用当前 子模块 下的视图文件。

2. 默认语言配置

Yii2 默认的语言是 en-US，很多时候它并不符合我们的开发要求，所以我们就要把的默认语言设置为 zh-CN，编辑 /frontend/config/main.php，添加如下配置：

'language' => 'zh-CN'

除了上面直接将语言写到配置文件外，还可以将语言写到每个 子模块 根目录下 Module.php 文件里：

Yii::$app->language = 'zh-CN';

推荐使用第二种方法，将语言配置写到 Module.php 里面，这样就可以利用 Cookie、Get参数等多种方式动态的改变语言，更加灵活

以下就是我常用的语言动态配置代码

// 设置默认语言
$language = Language::getRecord($_GET['l']);
$languages = Language::getRecordsByFilter(array('module'=>'frontend-'.$this->id));

if( !empty($language) ) setcookie('language-frontend-'.$this->id, $language['language_id'], time()+3600*24, '/');
if( $_GET['ll'] ) $language = Language::getRecord($_GET['ll']);

$language = empty($language) ? $_COOKIE['language-frontend-'.$this->id] : $language['language_id'];
$language = $language ? Language::getRecord($language) : $languages[0];

Yii::$app->language = $language['code'];
Yii::$app->params = array_merge(Yii::$app->params, array('language'=>$language,'languages'=>$languages));

这里代码仅仅抛砖引玉，模型 Language 的具体代码也不贴了，大家看看思路即可，具体可以自己写

更多Yii2文章参见 https://my.oschina.net/lengdo/blog