牛骨文教育服务平台(让学习变的简单)

多语言

ThinkPHP内置通过 hinkLang类提供多语言支持,如果你的应用涉及到国际化的支持,那么可以定义相关的语言包文件。任何字符串形式的输出,都可以定义语言常量。

开启和加载语言包

默认情况下,系统载入的是配置的默认语言包,并且不会自动侦测当前系统的语言。
默认语言由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方法来表示。

语言定义一般采用英语来描述。

语言文件定义

系统会默认加载下面三个语言包:

框架语言包: thinkphplang当前语言.php
应用语言包: applicationlang当前语言.php
模块语言包: application模块lang当前语言.php

如果你还需要加载其他的语言包,可以在设置或者自动检测语言之后,用load方法进行加载:

Lang::load(APP_PATH . "commonlangzh-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"])}