Yii i18n国际化，消息翻译

实现国际化有两种方式，基于文件实现和基于数据库实现。基于文件实现的方式很简单，网上有很多，请自行查询使用。这里主要说一下基于数据库实现的方式。

前提
待翻译的消息使用Yii::t()方法显示，方法参数，第一个是模式，比如常用的app，符合这种模式的消息，都会被初始化到表中，第二个是要显示的消息内容（这里的模式app在source_message表中对应category字段）。

数据库实现是基于DbMessageSource类实现的。
首先需要两张表：source_message表和message表，前者是存储要被翻译的语言，后者是存储被翻译后的语言，实现映射。

一、生成source_message 和 message表

#source_message表
CREATE TABLE source_message (
    id INTEGER PRIMARY KEY AUTO_INCREMENT,
    category VARCHAR(32),
    message TEXT
);

#message表
CREATE TABLE message (
    id INTEGER,
    language VARCHAR(16),
    translation TEXT,
    PRIMARY KEY (id, language),
    CONSTRAINT fk_message_source_message FOREIGN KEY (id)
        REFERENCES source_message (id) ON DELETE CASCADE ON UPDATE RESTRICT
);

当然，两张表的创建还有一种更便捷的方式，即yii自带的命令：

yii migrate --migrationPath=@yii/i18n/migrations/

这个命令会执行框架下的两张表的创建文件，如下：

vendor/yiisoft/yii2/i18n/migrations/m150207_210500_i18n_init.php

两种方式任一 一种执行后，数据库里都会生成这两张表。两张表的表名是可以改的，但是需要在配置文件中指定：

$sourceMessageTable 
$messageTable

二、配置i18n组件

'components' => [
  'i18n' => [
    'translations' => [
       'app' => [#对应source_message表中的category字段
           'class' => 'yii\i18n\DbMessageSource',
           // 'forceTranslation'=>true,#是否强制翻译
          'enableCaching' => false,#是否开启缓存
          //'cachingDuration' => 1 #缓存时间
          //......其他配置信息
          ]
      ],
  ],

三、创建配置文件

在需要翻译的目录，比如（frontend或者backend）目录下手动创建messages目录，执行命令：

yii message/config frontend/messages/config.php

在messages目录下生成config.php文件，内容大致如下：

return [
    'color' => null,
    'interactive' => true,
    'sourcePath' => __DIR__ . DIRECTORY_SEPARATOR . '..',#修改为待翻译目录
//    'sourcePath' => '@yii',
    'messagePath' => '@yii/messages',
    'languages' => ['zh-CN'],
    'translator' => 'Yii::t',#这里是关键，默认即可
    'sort' => false,
    'overwrite' => true,
    'removeUnused' => false,
    'markUnused' => true,
    'except' => [
        '.svn',
        '.git',
        '.gitignore',
        '.gitkeep',
        '.hgignore',
        '.hgkeep',
        '/messages',
        '/BaseYii.php',
    ],
    'only' => [
        '*.php',
    ],
    'format' => 'db',//默认生成时，是基于文件翻译，设置为db，默认是php
    'db' => 'db',//设置
    'sourceMessageTable' => '{{%source_message}}',//待翻译消息表
    'messageTable' => '{{%message}}',//翻译后消息表
    'catalog' => 'messages',
    'ignoreCategories' => [],
];

然后重新执行命令：

yii message frontend/messages/config.php

这样，两张表就会被初始化完成。最后是实现以下逻辑即可实现翻译功能。

1. 翻译前和翻译后的文本显示逻辑
2. 翻译后的文本存储逻辑

这样视图中基于t()方法显示的消息就会按照设置的文本显示。

最后看看Yii::t()方法到底做了什么：

1.Yii::t()是在BaseYii类中，中间调用了translate()方法

public static function t($category, $message, $params = [], $language = null)
    {
        if (static::$app !== null) {
            return static::$app->getI18n()->translate($category, $message, $params, $language ?: static::$app->language);
        } else {
          ...          
        }
    }

2.translate()方法

public function translate($category, $message, $params, $language)
{
    #返回模式为app的原消息
    $messageSource = $this->getMessageSource($category);
    #调用父类MessageSource的translate()方法
    $translation = $messageSource->translate($category, $message, $language);
    if ($translation === false) {
        return $this->format($message, $params, $messageSource->sourceLanguage);
    } else {
        return $this->format($translation, $params, $language);
    }
}

3.MessageSource的translate()方法

public function translate($category, $message, $language)
{
    if ($this->forceTranslation || $language !== $this->sourceLanguage) {
        #翻译消息，调用DbMessageSource类的loadMessages()方法
        return $this->translateMessage($category, $message, $language);
    } else {
        return false;
    }
}

4.loadMessages()方法，根据key，以及缓冲设置进行加载

protected function loadMessages($category, $language)
{
    if ($this->enableCaching) {
        $key = [
            __CLASS__,
            $category,
            $language,
        ];
        $messages = $this->cache->get($key);
        if ($messages === false) {
            $messages = $this->loadMessagesFromDb($category, $language);
            $this->cache->set($key, $messages, $this->cachingDuration);
        }

        return $messages;
    } else {
        return $this->loadMessagesFromDb($category, $language);
    }
}

另外还有消息格式化等，请自行查阅文档使用。

参考资料
http://www.yiichina.com/doc/guide/2.0/tutorial-i18n
http://www.yiiframework.com/doc-2.0/yii-i18n-dbmessagesource.html