在 protected/config 文件夹下的 main.php 中做如下设置:
return array( 'basePath'=>dirname(__FILE__).DIRECTORY_SEPARATOR.'..', 'name'=>'My Web Application', 'sourceLanguage'=>'en_us', 'language'=>'zh_cn',
这里我使用的时通过PHP文件实现文本信息翻译(更多方法说明参考Yii框架官方指南系列48——专题:国际化 (I18N)),通过这个方法实现翻译之前先要在 protected/messages 下创建一个名为localID的文件夹(在本例中是zh_cn),然后在该文件夹下创建一个自定义的php文件(不能命名为yii,因为该名称只能被yii框架内部使用),本例中我们创建一个 app.php:
return array( 'My Web Application'=>'我的web站点', 'Home'=>'首页', 'About'=>'关于', 'Contact'=>'联系我们', 'Login'=>'登录', 'Logout'=>'退出', );
调用方法很简单,只需通过内置的Yii::t()方法调用即可:
Yii::t('app','My Web Application')
比如我们可以在 protected/views/layouts/main.php 中对网站标题和导航条进行翻译:
<?php echo CHtml::encode(Yii::t('app',Yii::app()->name)); ?> <?php $this->widget('zii.widgets.CMenu',array( 'items'=>array( array('label'=>Yii::t('app','Home'), 'url'=>array('/site/index')), array('label'=>Yii::t('app','About'), 'url'=>array('/site/page', 'view'=>'about')), array('label'=>Yii::t('app','Contact'), 'url'=>array('/site/contact')), array('label'=>Yii::t('app','Login'), 'url'=>array('/site/login'), 'visible'=>Yii::app()->user->isGuest), array('label'=>Yii::t('app','Logout').' ('.Yii::app()->user->name.')', 'url'=>array('/site/logout'), 'visible'=>!Yii::app()->user->isGuest) ), )); ?>
比如我们想要实现site/index.php的视图文件翻译,那么需要先在 protected/views/site 文件夹下先创建 zh_cn 文件夹,然后将 site/index.php 拷贝到 site/zh_cn/ 文件夹下,然后对zh_cn文件夹下的 index.php 文件夹进行翻译:
<?php /* @var $this SiteController */ $this->pageTitle=Yii::t("app",Yii::app()->name); ?> 欢迎来到 <?php echo CHtml::encode(Yii::t("app",Yii::app()->name)); ?> 祝贺! 你已经成功安装了你的Yii应用。
你可以通过修改下面两个文件来改变这个页面的内容:
视图文件: <?php echo __FILE__; ?>
布局文件: <?php echo $this->getLayoutFile('main'); ?>
想要了解更多关于开发这个应用的内容,可以参考这篇
至此,我们就简单完成了 site/index 页面的翻译工作。
传递参数
在 php 翻译源中的定义:
# protected/messages/zh_cn/app.php
<?php return array( // Other stuff. 'The username {username} is not available.' => '用户名{username}无效。', // More other stuff. );
调用实现翻译语句:
echo Yii::t('app', 'The username {username} is not?available.', array('{username}' => $username));
处理复数
比如如果我们处理这样的翻译:
echo Yii::t('app', 'The item has been added to your cart.|The {n} items have been added to your cart.', $num);
相应的 app.php 中的代码如下:
# protected/messages/es_mx/app.php
<?php return array( 'n==1#The item has been added to your cart.| n>1#The items have been added to your cart.' => '东西已经放到你的购物车了。|所有东西都已经放到你的购物车了。', );