ThinkPHP内置通过\think\Lang类提供多语言支持,如果你的应用涉及到国际化的支持,那么可以定义相关的语言包文件。任何字符串形式的输出,都可以定义语言常量。
是用户定义的,一般情况下每一种语言对应一种语言包,所谓语言包其实就是一个文件(PHP文件),其中定义了一些变量,不同语言包中变量的值语言不同**
例子一:
'汉语',
'logintitle'=>'后台网站管理系统',
'loginname'=>'请输入用户名',
'loginpassword'=>'请输入密码',
'logincode'=>'请输入密码',
'loginbtn'=>'登陆',
'copyright'=>'版权信息'
];
?>
例子二: en-us 英文信息包
'Endlish',
'logintitle'=>'Management System',
'loginname'=>'Please input menber id',
'loginpassword'=>'Please enter a password',
'logincode'=>'verify code',
'loginbtn'=>'LOGIN',
'copyright'=>'CopyRight : xxxxxx',
];
?>
默认情况下,系统载入的是配置的默认语言包,并且不会自动侦测当前系统的语言。
默认语言由default_lang配置参数设置,系统默认设置为:
// 默认语言
'default_lang' => 'zh-cn',
要启用语言自动侦测和多语言自动切换,需要开启多语言切换,在应用的公共配置文件添加:
**// 开启语言切换
'lang_switch_on' => true,**
开启后,系统会自动检测当前语言(主要是指浏览器访问的情况下)会对两种情况进行检测:
是否有
$_GET['lang']
通过浏览器是可以设置默认信息,在设置时,可以同时设置多个,php是通过识别$_SERVER['HTTP_ACCEPT_LANGUAGE']
中的第一个语言,因为这里获取的是一个语言列表字符串,如:zh-CN en-US;q=0.8,en’q =0 .7 zh;q=0.5,zh-TW;q=0.3,zh-HK;1=0.2
检测到任何一种情况下采用Cookie缓存
(1)、如果检测到的语言在允许的语言列表内认为有效,否则使用默认设置的语言
(2)、如果不希望浏览器自动侦测语言,请关闭lang_switch_on
后设置默认语言。
(3)、如果在自动侦测语言的时候,希望设置允许的语言列表,不在列表范围的语言则仍然使用默认语言,可以使用:
// 设置允许的语言
Lang::setAllowLangList(['zh-cn','en-us']);
语言变量的定义,只需要在需要使用多语言的地方,写成:
Lang::get('add user error');
// 使用系统封装的助手函数
lang('add user error');
也就是说,字符串信息要改成Lang::get方法来表示。
语言定义一般采用英语来描述。
语言文件定义
系统会默认加载下面三个语言包:
框架语言包: thinkphp\lang\当前语言.php
应用语言包: application\lang\当前语言.php
模块语言包: application\模块\lang\当前语言.php
如果你还需要加载其他的语言包,可以在设置或者自动检测语言之后,用load方法进行加载:
Lang::load(APP_PATH . 'common\lang\zh-cn.php');
ThinkPHP语言文件定义采用返回数组方式:
return [
'hello thinkphp' => '欢迎使用ThinkPHP',
'data type error' => '数据类型错误',
];
也可以在程序里面动态设置语言定义的值,使用下面的方式:
Lang::set('define2','语言定义');
$value = Lang::get('define2');
通常多语言的使用是在控制器里面,但是模型类的自动验证功能里面会用到提示信息,这个部分也可以使用多语言的特性。例如原来的方式是把提示信息直接写在模型里面定义:
**['title','require','标题必须!',1],
如果使用了多语言功能的话(假设,我们在当前语言包里面定义了' lang_var'=>'标题必须!'),就可以这样定义模型的自动验证
['title','require','{%lang_var}',1],
如果要在模板中输出语言变量不需要在控制器中赋值,可以直接使用模板引擎特殊标签来直接输出语言定义的值:
{$Think.lang.lang_var}
可以输出当前语言包里面定义的 lang_var语言定义。
变量传入支持
语言包定义的时候支持传入变量,有两种方式
使用命名绑定方式,例如:
'file_format' => '文件格式: {:format},文件大小:{:size}',
在模板中输出语言字符串的时候传入变量值即可:
{:lang('file_format',['format' => 'jpeg,png,gif,jpg','size' => '2MB'])}
第二种方式是使用格式字串,如果你需要使用第三方的翻译工具,建议使用该方式定义变量。
'file_format' => '文件格式: %s,文件大小:%d',
在模板中输出多语言的方式更改为:
{:lang('file_format',['jpeg,png,gif,jpg','2MB'])}****