Yii 2 —— 基于Mustache的頁面多語言解決方案

在Yii 2中，官方的頁面多語言解決方案有兩個：

方案1，使用Yii::t()函數(shù)，在頁面中需要輸出文字的地方，使用類似如下代碼：

<?= Yii::t(‘views/login’, ‘hello’)?>

這樣做的后果是頁面上大量充斥著類似的代碼，導(dǎo)致頁面可讀性很差，而且對于同一個頁面來說，Yii::t()函數(shù)的第一個參數(shù)基本上都是一樣的，看到這些重復(fù)代碼，也是心塞。我曾經(jīng)在項(xiàng)目中采用這種方式實(shí)現(xiàn)多語言，一個簡單的登錄頁面都能寫到心煩的要命。

方案2，為指定語言做一個專門的視圖，假設(shè)你有個頁面是英文的，想再做個中文頁面，可是中英文頁面布局等相差很大，不是簡單的翻譯文字，那么在Yii 2中，可以在該頁面的目錄下，再建立一個zh-CN目錄，然后在這個目錄下建立一個同名的視圖文件，頁面內(nèi)容用中文實(shí)現(xiàn)即可。這個我會專門再有文章說明如何實(shí)現(xiàn)。

如果中英文頁面布局基本一樣，只是文字有變化，那么建議還是不要用方案2了，寧可用方案1降低可讀性，否則一旦頁面內(nèi)容有修改，兩個頁面之間的內(nèi)容同步會搞到你懷疑人生。

總之，不管是方案1還是2，我都不喜歡，想要尋找一種簡潔明了的頁面多語言方案，頁面看起來干凈清爽，又不需要為每個語言做單獨(dú)的頁面。

那么怎樣才能做到呢，我從Mustache中找到了實(shí)現(xiàn)的方案，假設(shè)下面是一個視圖的代碼：

<h4>{{基本信息}}</h4>
<table class="table table-bordered">
    <tbody>
    <tr>
        <td class="base-label active">{{下載隊(duì)列}}</td>
        <td class="base-label active">{{等待隊(duì)列}}</td>
    </tr>
    <tr>
        <td class="base-label active">{{已安裝}}</td>
        <td class="base-label active">{{當(dāng)前GameInfo}}</td>
    </tr>
    <tr>
        <td class="base-label active">{{剩余電量}}</td>
        <td class="base-label active">{{是否允許OTA}}</td>
    </tr>
    </tbody>
</table>

如果把想要多語言顯示的文字用Mustache的變量符號給括起來，然后假設(shè)上面的內(nèi)容已經(jīng)存到一個字符串$content里，那么在Action中，可以用Mustache將其輸出為英文：

$content = $this->render('mypage', $params);
$m = new Mustache_Engine();
$content = $m->render($content, [
    '基本信息' => 'Base Information',
    '下載隊(duì)列' => 'Downloading',
    '等待隊(duì)列' => 'Waiting',
    '已安裝' => 'Installed',
    '當(dāng)前GameInfo' => 'GameInfo',
    '剩余電量' => 'Battery Level',
    '是否允許OTA' => 'Is can OTA',
]);

return $content;

這里的要點(diǎn)是先用Yii的render函數(shù)，得到要輸出頁面的字符串，然后使用Mustache，將指定的文字轉(zhuǎn)換為英文，最后通過return輸出。

上面這段代碼就是使用Mustache實(shí)現(xiàn)頁面多語言的核心思想，首先看頁面的代碼，完全沒有任何PHP的代碼，都是標(biāo)準(zhǔn)的HTML元素，頁面看起來非常的干凈清爽，前端開發(fā)人員可以直接用這個頁面做前端的各種效果，完美實(shí)現(xiàn)前后端開發(fā)的解耦。

當(dāng)然，上面展示的是核心的思想，但是要實(shí)際使用，還是需要進(jìn)一步的完善。

首先，翻譯的文字其實(shí)不適合放到Action的代碼里，這樣不好維護(hù)，應(yīng)該按照Yii 2的設(shè)計(jì)思想，放到messages目錄下，為指定語言建立messages文件，類似如下：

return [
    'device/views/deviceLog/mypage => [
        '基本信息' => 'Base Information',
        '下載隊(duì)列' => 'Downloading',
        '等待隊(duì)列' => 'Waiting',
        '已安裝' => 'Installed',
        '當(dāng)前GameInfo' => 'GameInfo',
        '剩余電量' => 'Battery Level',
        '是否允許OTA' => 'Is can OTA',
    ],
];

使用視圖的路徑作為鍵值，方便為每個頁面確定翻譯的內(nèi)容。

其次，做一個自己的Controller的基類，重載render函數(shù)：

public function render($view, $params = [])
{
    $content = parent::render($view, $params);

    $path = $this->getViewPath() . '/' . $view;
    $list = EonI18nUtils::getMsgs($path);
    if (empty($list)) {
        return $content;
    }
    $m = new Mustache_Engine([
        'delimiters' => '## ##',
    ]);
    $content = $m->render($content, $list);

    return $content;
}

這里，先調(diào)用父類的render函數(shù)，得到正常輸出的視圖字符串，再調(diào)用EonI18nUtils::getMsgs()，根據(jù)視圖文件的路徑，得到該頁面的多語言鍵值對，然后創(chuàng)建Mustache對象，將視圖字符串中的指定鍵值修改為翻譯后的文字。

為了保證頁面上基于JavaScript的Mustache可以使用，這里將Mustache的鍵值標(biāo)簽由{{}}改為####，頁面代碼類似如下：

<h4>##基本信息##</h4>
<table class="table table-bordered">
    <tbody>
    <tr>
        <td class="base-label active">##下載隊(duì)列##</td>
        <td class="base-val">{{downloading}}</td>
        <td class="base-label active">##等待隊(duì)列##</td>
        <td class="base-val">{{waitting}}</td>
    </tr>
    <tr>
        <td class="base-label active">##已安裝##</td>
        <td class="base-val">{{installed}}</td>
        <td class="base-label active">##當(dāng)前GameInfo##</td>
        <td class="base-val">{{gameinfo}}</td>
    </tr>
    <tr>
        <td class="base-label active">##剩余電量##</td>
        <td class="base-val">{{battery_level}}%</td>
        <td class="base-label active">##是否允許OTA##</td>
        <td class="base-val">{{allowOTA}}</td>
    </tr>
    </tbody>
</table>

這樣，上面代碼中用##括起來的文字會被翻譯，而用{{}}括起來的，則由頁面上的JS代碼使用Mustache方案替換文字。

EonI18nUtils::getMsgs()的參考代碼如下：

public static function getMsgs($category, $lang = null)
{
    $category = str_replace('\\', '/', $category);
    $arr = explode("/", $category);
    $arr = array_slice($arr, count($arr) - 4);
    $category = implode("/", $arr);

    $messageSource = \Yii::$app->getI18n()->getMessageSource('messages');
    $list = $messageSource->getMsgList($category, $lang);
    return $list;
}

getMsgList()代碼類似如下：

public function getMsgList($langPath, $language)
{
    $language = $this->getLanguage($language);
    if (!isset($this->_messages[$language])) {
        $this->_messages[$language] = $this->loadMessages('messages', $language);
    }
    if (isset($this->_messages[$language][$langPath])) {
        return $this->_messages[$language][$langPath];
    }
    return false;
}