多语言

ThinkPHP内置通过`\think\Lang`类提供多语言支持，如果你的应用涉及到国际化的支持，那么可以定义相关的语言包文件。任何字符串形式的输出，都可以定义语言常量。 ## 开启和加载语言包 默认情况下，系统载入的是配置的默认语言包，并且不会自动侦测当前系统的语言。 默认语言由`default_lang`配置参数设置，系统默认设置为： ~~~ // 默认语言 'default_lang' => 'zh-cn', ~~~ 要启用语言自动侦测和多语言自动切换，需要开启多语言切换，在应用的公共配置文件添加： ~~~ // 开启语言切换 'lang_switch_on' => true, ~~~ 开启后，系统会自动检测当前语言（主要是指浏览器访问的情况下）会对两种情况进行检测： * 是否有`$_GET['lang'] ` * 识别`$_SERVER['HTTP_ACCEPT_LANGUAGE']`中的第一个语言 * 检测到任何一种情况下采用Cookie缓存 * 如果检测到的语言在允许的语言列表内认为有效，否则使用默认设置的语言 如果不希望浏览器自动侦测语言，请关闭`lang_switch_on`后设置默认语言。 如果在自动侦测语言的时候，希望设置允许的语言列表，不在列表范围的语言则仍然使用默认语言，可以使用： ~~~ // 设置允许的语言 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'])} ~~~