你现在的位置:首页 > PHP网站建设知识库 > Yii > 正文

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]’ 对应的语言文本,作为最终显示的文本。