ThinkPHP内置多语言支持,如果你的应用涉及到国际化的支持,那么可以定义相关的语言包文件。任何字符串形式的输出,都可以定义语言常量。要启用多语言功能,需要配置开启多语言行为(确保你下载的是完整版本,如果不是需要单独下载多语言检测行为扩展),在项目的配置目录下面的行为定义文件tags.php中,添加:
return array(
// 添加下面一行定义即可
'app_begin'=>array('CheckLang')
);
表示在app_begin标签位置执行多语言检测行为。
可以为项目定义不同的语言文件,框架的系统语言包目录在系统框架的Lang目录下面,每个语言都对应一个语言包文件,系统默认只有简体中文语言包文件zh-cn.php ,如果要增加繁体中文 zh-tw或者英文en,只要增加相应的文件。
语言包的使用由系统自动判断当前用户的浏览器支持语言来定位,如果找不到相关的语言包文件,会使用默认的语言。如果浏览器支持多种语言,那么取第一种支持语言。
ThinkPHP的多语言支持已经相当完善了,可以满足应用的多语言需求。这里是指的是模板多语言支持,数据的多语言转换(翻译)不在这个范畴之内。ThinkPHP具备语言包定义、自动识别、动态定义语言参数的功能。并且可以自动识别用户浏览器的语言,从而选择相应的语言包(如果有定义)。例如:
throw_exception('新增用户失败!');
我们在语言包里面增加了ADD_USER_ERROR 语言配置变量的话,在程序中的写法就要改为:
throw_exception(L('ADD_USER_ERROR'));
也就是说,字符串信息要改成L方法和语言定义来表示。
项目语言包文件位于项目的Lang目录下面,并且按照语言类别分子目录存放,在执行的时候系统会自动加载,无需手动加载。
具体的语言包文件命名规范如下:
语言子目录采用浏览器的语言命名(全部小写)定义,例如English (United States) 可以使用en-us作为目录名。如果项目比较小,整个项目只有一个语言包文件,那可以定义common.php文件,而无需按照模块分开定义。
语言包文件可以按照模块来定义,每个模块单独定义语言包文件,文件名和模块名称相同,例如:
Lang/zh-cn/user.php 表示给User模块定义简体中文语言包文件
Lang/zh-tw/user.php 表示给User模块定义繁体中文语言包文件
语言文件定义
ThinkPHP语言文件定义采用返回数组方式:
return array(
'lan_define'=>'欢迎使用ThinkPHP',
);
要在程序里面设置语言定义的值,使用下面的方式:
L('define2','语言定义');
$value = L('define2');
上面的语言包是指项目的语言包,如果在提示信息的时候使用了框架底层的提示,那么还需要定义系统的语言包,系统语言包目录位于ThinkPHP目录下面的Lang目录。
通常多语言的使用是在Action控制器里面,但是模型类的自动验证功能里面会用到提示信息,这个部分也可以使用多语言的特性。例如:
原来的方式是把提示信息直接写在模型里面定义
array('title','require','标题必须!',1),
如果使用了多语言功能的话(假设,我们在当前语言包里面定义了' lang_var'=>'标题必须!')
还可以这样定义模型的自动验证
array('title','require','{%lang_var}',1),
如果要在模板中输出语言变量不需要在Action中赋值,可以直接使用模板引擎特殊标签来直接输出语言定义的值:
{$Think.lang.lang_var}
可以输出当前选择的语言包里面定义的 lang_var 语言定义
lan_chinese.php:中文文件
//var_dump($_SESSION);die;
$lan = array(
'shouye'=>'首页',
'guanyu'=>'关于UEX',
'dianzishangcheng'=>'电子商城',
'daigoufuwu'=>'代购服务',
'zhifufangshi'=>'支付方式',
'jiaoyitishi'=>'交易提示',
'jiaoyibaozhang'=>'交易保障',
'lianxiwomen'=>'联系我们',
'sheweishouye'=>'设为首页',
'jiarushoucang'=>'加入收藏',
'bangzhu'=>'帮助',
'jiantizhongwen'=>'简体中文',
'fantizhongwen'=>'繁体中文',
'denglu'=>'登陆',
'huiyuanzhongxin'=>'会员中心',
'tuichu'=>'退出',
'zhaohuimima'=>'找回密码',
'wangjimimala'=>'忘记了密码?请输入用户名和注册时填写的邮箱,我们会把重设密码邮件发送到您的邮箱!',
);
?>
?>
前台文件的判断部分(放在head中就行)
switch($_SESSION['lan']){
case 1:
include './lan_chinese.php';
break;
case 2:
include './lan_chineseFt.php';
break;
case 3:
include './lan_english.php';
break;
default:include './lan_chinese.php';
}
下面是在页面输出的被翻译后的文字
{ $lan['下标名称']}
例:
{ $lan['shouye']}输出的是“首页” 中文
{ $lan['shouye']}输出的是“Home”英文