Yii框架的多语言设置

Yii 框架的缺省语言是美国英语（en_us ）。但是身在在中国，又希望致力于中国企业的信息化建设，所以让Yii 支持多语言（至少简体中文和美国英语）那是必须的。

1.      全局语言

和其它application 级别的配置一样，系统的缺省语言可以在protected/config/main.php 中设置：

                               return array(
                                                             'basePath'=>dirname(__FILE__).DIRECTORY_SEPARATOR.'..',
                                                              ......
                                                              'language'=>'zh_cn',  //*** 不设置的话缺省为 en_us

 

2.      Controller 级别

由于Yii 框架中Controller 掌控几乎全部的Views ，所以我们可以通过在Controller 的初始化函数中指定该Controller 控制的所有Views 的缺省语言。

       

    class foo extends Controller
                {
                              public function init()
                              {
                                            Yii::app()->language = ‘zh_cn’;
                              }
                              ……

 

需要动态切换语言的系统需要更多的逻辑。目前通行的做法是在页面的某个位置（多数是右上角）放置语言的链接，例如：中文 | English 。

echo CHtml:: link ( ' 中文 ' , array ( '' , 'hl' => 'zh' )) . '| ' . CHtml:: link ( 'English' , array ( '' , 'hl' => 'en' )) ;

 

这样在点击相应的语言链接之后，利用Cache 将语言选择保存在服务器端。同样在Controller::init() 函数中根据Cache 中缓存的语言设置系统的缺省语言。

public function init()
{
        If (isset ($_GET['hl']) && 'en'===$_GET['hl'])
{
setcookie ("hl", 'en_us');
$_COOKIE['hl']='en_us';   //cookie 不能立刻生效 
}
else if (isset ($_GET['hl']) && 'zh'===$_GET['hl'])
{
unset ($_COOKIE['hl']);
setcookie ("hl", "");
}
 
If ('en_us'==$_COOKIE['hl'])
{
Yii::app()->language='en_us';
}
}

 

3.      文本翻译

为了解决文本的不同语言版本的动态选择，Yii 框架提供一个全局性的函数Yii::t(‘[text file]’, ‘[text]’) 用来封装所有需要多语言支持的文本。其中第一个参数’[text file]’ 代表存储当前语言文本的文件，第二个参数‘[text] ’是文本编码。’[text]’ 通常就是该文本在系统的缺省语言中的版本。例如：Yii 框架缺省的系统语言是美国英语，所以’[text]’通常就是文本的英文语意。但是如果在protected/config/main.php 中设置系统的缺省语言是简体中文，那么’[text]’ 应该是文本的简体中文语意。以文本“Name （名称）”为例，如果系统语言是美国英语，我们可以将’[text]’ 定义为’Name’；而当系统语言是简体中文时，’[text]’ 应该定义为’ 名称’ 。

 

和大多数多语言框架一样，Yii 框架也将不同语言的文本保存在该语言对应的目录下，作为一个资源。基于Yii 框架的系统在根目录下有一个messages 目录（[webapp]/messages ）。简体中文资源放置在[webapp]/messages/zh_cn 下，美国英语资源放置在[webapp]/messages/en_us 下。所有语言资源都是以PHP 文件的形式存在，且都返回一个包含若干Key/Value 对的数组。其中Key 就是Yii::t() 的第二参数’[text]’ 。仍以文本“Name （名称）”为例，如果系统语言是美国英语，语言资源文件中对应的Key/Value 应该是’Name’=>’ 名称’ ； 而当系统语言是简体中文时，Key/Value 应该是’ 名称’=>’Name’ 。值得注意的是，因为Yii 框架是使用UTF-8 编码，所以语言资源文件也必须是UTF-8 编码。否则显示文本时会出现乱码。

 

      Yii 框架在运行时，会首先根据Yii::app()->language 的值定位到对应语言目录下的[text file].php 文件。然后再根据’[text]’ 在Key/Value 对数组中定位该’[text]’ 对应的语言文本，作为最终显示的文本。