ThinkPHP内置通过\think\facade\Lang
类提供多语言支持,如果你的应用涉及到国际化的支持,那么可以定义相关的语言包文件。任何字符串形式的输出,都可以定义语言常量。
默认系统会加载默认语言包,但如果需要多语言自动侦测及自动切换,你需要在全局的中间件定义文件中添加中间件定义:
'think\middleware\LoadLangPack',
默认情况下,系统载入的是配置的默认语言包,并且不会自动侦测当前系统的语言。多语言相关的设置在lang.php
配置文件中进行设置。
默认语言由default_lang
配置参数设置,系统默认设置为:
// 默认语言
'default_lang' => 'zh-cn',
启用中间件后,系统会自动侦测和多语言自动切换,可以在配置文件设置自动侦测的多语言变量名:
// 自动侦测的GET变量名
'detect_var' => 'lang',
开启自动侦测后会会首先检查请求的URL或者Cookie中是否包含语言变量,然后根据HTTP_ACCEPT_LANGUAGE
自动识别当前语言(并载入对应的语言包)。
V6.0.3+
版本开始支持通过Header方式自动侦测多语言
如果在自动侦测语言的时候,希望设置允许的语言列表,不在列表范围的语言则仍然使用默认语言,可以配置:
// 设置允许的语言
'allow_lang_list' => ['zh-cn', 'en-us']
如果希望使用Cookie
保存语言,可以设置
// 使用Cookie保存
'use_cookie' => true,
// Cookie保存变量
'cookie_var' => 'think_lang',
设置后,自动检测的语言会通过Cookie
记录下来,下次则直接通过Cookie
判断语言。
语言变量的定义,只需要在需要使用多语言的地方,写成:
Lang::get('add user error');
// 使用系统封装的助手函数
lang('add user error');
也就是说,字符串信息要改成Lang::get
方法来表示。
语言定义一般采用英语来描述。
自动加载的应用语言文件位于:
// 单应用模式
app\lang\当前语言.php
// 多应用模式
app\应用\lang\当前语言.php
语言包文件支持多种格式,包括php数组、
yaml
格式及json
格式(V6.0.4+
)。
如果你还需要加载其他的语言包,可以通过extend_list
设置,例如:
'extend_list' => [
'zh-cn' => [
app()->getBasePath() . 'lang\zh-cn\app.php',
app()->getBasePath() . 'lang\zh-cn\core.php',
],
]
目前核心框架仅内置
zh-cn
语言包,如果需要其它语言的提示,可以通过扩展语言包的方式自行加载。
ThinkPHP语言文件定义采用返回数组方式:
return [
'hello thinkphp' => '欢迎使用ThinkPHP',
'data type error' => '数据类型错误',
];
通常多语言的使用是在控制器里面,但是模型类的自动验证功能里面会用到提示信息,这个部分也可以使用多语言的特性。
如果使用了多语言功能的话(假设,我们在当前语言包里面定义了' lang_var'=>'标题必须!'),就可以使用下面的字符串来替代原来的错误提示。
{%lang_var}
如果要在模板中输出语言变量不需要在控制器中赋值,可以直接使用模板引擎特殊标签来直接输出语言定义的值:
{$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'])}
首先你需要在lang.php配置文件中开启语言分组,
// 开启多语言分组
'allow_group' => true
然后你可以在定义多语言的时候使用分组定义
return [
'user' => [
'welcome' => '欢迎回来',
'login' => '用户登录',
'logout' => '用户登出',
]
];
然后使用下面的方式获取多语言变量
Lang::get('user.login');
lang('user.login');