ThinkPHP多语言支持的配置与使用

ThinkPHP 多语言配置

ThinkPHP
内置了对多语言的支持，如果应用项目涉及到国际化，那么可以定义相关的语言包文件以实现多语言支持。这里涉及的多语言支持是指模板语言，数据的多语言转换（翻译）不在这个范畴之内。

在项目配置文件里添加如下参数以开启多语言的支持：

'LANG_SWITCH_ON'
=> true, //开启多语言支持开关
'DEFAULT_LANG' => 'zh-cn', //
默认语言
'LANG_AUTO_DETECT' => true, // 自动侦测语言

ThinkPHP
会自动判断当前用户的浏览器支持语言来定位该使用何种语言包，如果找不到相关的语言包文件，会使用默认语言。如果浏览器支持多种语言，那么取第一种支持语言。

除了自动侦测当前用户的浏览器语言之外，也可以在
URL
中指定使用何种语言，详细见下面例子。

与多语言有关的文件包或目录如下：

ThinkPHP系统简体中文语言包：ThinkPHP系统目录/Lang/zh-cn.php
ThinkPHP系统繁体中文语言包：ThinkPHP系统目录/Lang/zh-tw.php
ThinkPHP系统美国英语语言包：ThinkPHP系统目录/Lang/en-us.php
项目简体中文语言包目录：项目目录/Lang/<项目分组/>zh-cn/
项目繁体中文语言包目录：项目目录/Lang/<项目分组/>zh-tw/
项目美国英语中文语言包目录：项目目录/Lang/<项目分组/>en-us/

如果有更多语言，可以按照例子依次创建文件或目录即可。
项目多语言实例

下面以一个中英双语的例子来看项目多语言支持的具体实现。

在
项目目录/Lang/zh-cn/ 下创建 common.php 文件，并在内设定简体中文语言定义：

2. return array(
   
3. 'welcome'=>'欢迎使用 ThinkPHP ！',
   
4. 'message'=>'这是一条测试消息！',
   
5. );
   
6. ?>

在 项目目录/Lang/en-us/ 下创建
common.php 文件，并在内设定美国英语语言定义：

2. return array(
   
3. 'welcome'=>'Welcome to ThinkPHP!',
   
4. 'message'=>'This is a test message!',
   
5. );
   
6. ?>

在操作中（如 Index 模块 lang
操作）中：

1. public function lang(){
   
2. $this->assign('message', L('message'));
   
3. $this->display();
   
4. }
   

对应的模板（Tpl/default/Index/lang.html）：

{$Think.lang.welcome}

{$message}

切换到：

当我们访问该操作时，系统会根据当前浏览器语言来自动获取对应的语言包内容。上面的例子中，直接在模板中显示的内容使用
{$Think.lang.welcome} 来输出，而在操作中获取语言包内容时，需要使用 L 快捷方法。当点击 English 链接时，由于 URL 中传入了
l=en-us 参数，系统会获取对应的英语语言包，从而显示：

Welcome to ThinkPHP!
This is a test
message!

L 快捷方法

L 快捷方法用于获取和设置语言定义，语法如下：

L(name,
value)

如果 name 和 value 参数都存在时，表示设定语言变量名 name=value；当 value 省略时，表示获取 name
语言变量对应的值，若 name 未定义时，将 name
以大写返回。
模块定义语言包

当项目比较大时，可能需要按照模块来定义语言包。按照模块定义语言包时，语言包名字就是对应的模块名字（小写）。如给
User 模块定义语言包时，对应的语言包文件为：项目目录/Lang/zh-cn/user.php
。

对模块定义语言包时，使用上与上面普通定义方式完全一致。当模块语言包与普通语言包有相同的语言定义项时，模块语言包的定义会覆盖普通方式的定义。
项目模型里使用语言包

项目多语言支持中除了模板和模块操作要用到语言包之外，在模型类里也可能需要用到语言包（如自动验证的提示信息）。要在项目模型里使用语言包，只需将原来写入验证规则的提示信息更改为：

array('title','require','{%vali_title}',1),

vali_title
是项目语言包里面定义的语言变量，如同例子上面定义 welcome 和 message 一样。如果想测试多语言的效果，可以在表单提交的时候传入 l
参数：

method="post">

注意：在提交表单里不可像前面列子使用 __URL__/insert?l=en-us
这种参数传入形式，否则会导致“表单令牌错误”。

由于 ThinkPHP 具有自动检测浏览器使用语言的功能，因此一般不需要在 URL 中传入 l
参数，当然这不是绝对的，可以根据实际情况来决定。