ThinkPHP支持多语言,采用的是语言文件的方式。如果你的应用涉及到多个语言版本和国际化的支持,那么可以定义相关的语言包文件。任何字符串形式的输出,都可以定义语言常量。
启用多语言
要启用多语言功能,首先要下载多语言行为扩展(http://www.thinkphp.cn/extend/186.html),或者下载官方的完整扩展包(http://www.thinkphp.cn/down/253.html)里面也已经包含多语言行为扩展了,把下载后解压到的CheckLangBehavior.class.php 文件放入ThinkPHP/Extend/Behavior(如果没有请手动创建)目录下面。然后在项目的行为配置文件(Conf/tags.php)中启用多语言行为,添加如下配置项:
return array(
// 添加下面一行定义即可
'app_begin' => array('CheckLang')
);
表示在app_begin标签位置执行多语言检测行为。
由于多语言默认是关闭的,我们还要在项目配置文件(Conf/config.php)中开启语言包功能:
'LANG_SWITCH_ON' => true, // 开启语言包功能
其他的多语言相关配置参数包括:
'LANG_AUTO_DETECT' => true, // 自动侦测语言 开启多语言功能后有效
'DEFAULT_LANG' => 'zh-cn', // 默认语言
'LANG_LIST' => 'zh-cn,en-us', // 允许切换的语言列表 用逗号分隔
'VAR_LANGUAGE' => 'l', // 默认语言切换变量
如果开启了LANG_AUTO_DETECT,表示会自动侦测当前语言,否则就采用DEFAULT_LANG的语言设置。
语言包的使用由系统自动判断当前用户的浏览器支持语言来定位,如果浏览器支持多种语言,那么取第一种支持语言。
也可以在URL地址中使用参数来切换多语言,例如:
http://localhost/Lang/index.php/?l=en-us
多语言切换采用了Cookie机制,因此会记住当前的语言选择。
多语言的切换受LANG_LIST参数控制,如果浏览器自动侦测的语言或者用户切换的语言在LANG_LIST之外则无效,系统会采用默认语言。
例如,上面的设置参数情况下,访问:
http://localhost/Lang/index.php/?l=zh-tw
由于zh-tw语言未在多语言列表中,所以将会采用简体中文zh-cn语言包。
定义语言包
可以为项目定义不同的语言文件,语言文件包括系统语言包和项目语言包。框架的系统语言包目录在系统框架的Lang目录下面,每个语言都对应一个语言包文件,系统默认有简体中文语言包文件zh-cn.php和英文语言包en-us.php ,如果要增加繁体中文zh-tw或者其他语言包,只要对照系统已有的语言包增加相应的文件。
语言文件主要提供对模板的多语言支持,数据的多语言转换(翻译)不在这个范畴之内。ThinkPHP具备语言包定义、自动识别、动态定义语言参数的功能。并且可以自动识别用户浏览器的语言,从而选择相应的语言包(如果有定义)。
项目语言包文件位于项目的Lang目录下面,并且按照语言类别分子目录存放,在执行的时候系统会自动加载,无需手动加载。
语言子目录采用浏览器的语言命名(全部小写)定义,例如English (United States) 可以使用en-us作为目录名。一般情况下,如果项目不大,那定义common.php文件即可:
Lang/zh-cn/common.php
如果你的项目比较大,则可以按照模块或者分组来单独定义。具体的语言包文件命名规范如下:
项目公共语言包 | 语言目录/common.php |
项目分组语言包 | 语言目录/分组名.php |
项目模块语言包 | 不存在分组情况:语言目录/模块名(小写).php |
存在分组的情况:语言目录/分组名/模块名(小写).php |
语言包文件可以按照模块来定义,每个模块单独定义语言包文件,文件名和模块名称相同,例如:
Lang/zh-cn/user.php 表示给User模块定义简体中文语言包文件
Lang/zh-tw/user.php 表示给User模块定义繁体中文语言包文件
分组的模块语言包定义受TMPL_FILE_DEPR参数配置影响,如果你修改了TMPL_FILE_DEPR参数,例如:
'TMPL_FILE_DEPR'=>'_',
那么,分组的模块语言包定义方式应该改为:
语言目录/分组名_模块名(小写).php
如果你采用了新版的独立分组模式的话,那么可以直接在分组的Lang目录下定义分组语言文件,
Lang/分组名.php
ThinkPHP语言文件定义采用返回数组方式:
return array(
'lan_define'=>'欢迎使用ThinkPHP',
);
使用语言定义
定义了语言文件后,我们通常需要改变控制器中的提示信息用法,例如:
throw_exception('新增用户失败!');
我们采用语言包后(例如在语言包里面增加了ADD_USER_ERROR 语言配置变量),在程序中的写法就要改为:
throw_exception(L('ADD_USER_ERROR'));
也就是说,字符串信息要改成L方法和语言定义来表示。
如果ADD_USER_ERROR语言变量没有定义的话,L方法会输出当前的字符串ADD_USER_ERROR本身,所以你不用担心ADD_USER_ERROR是否有定义,可以在最后统一修改语言文件。
定义好语言文件后,也可以在程序里面动态设置语言定义的值,使用下面的方式:
L('ADD_USER_ERROR','新增用户错误!');
$value = L('ADD_USER_ERROR');
模型类的自动验证功能里面会用到提示信息,这个部分也可以使用多语言的特性。例如:
原来的方式是把提示信息直接写在模型里面定义
array('title','require','标题必须!',1),
如果使用了语言文件的话(假设,我们在当前语言包里面定义了' lang_var'=>'标题必须!')
还可以这样定义模型的自动验证:
array('title','require','{%lang_var}',1),
如果要在模板中输出语言变量不需要在Action中赋值,可以直接使用模板引擎特殊标签来直接输出语言定义的值:
{$Think.lang.lang_var}
可以输出当前选择的语言包里面定义的 lang_var 语言定义。