php语言title,多语言 · ThinkPHP 5 简明开发手册 · 看云

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

## 开启和加载语言包

要启用多语言功能，需要配置开启多语言行为，在应用的公共配置文件添加：

~~~

'lang_switch_on' => true, // 开启语言包功能

'lang_list' => ['zh-cn'], // 支持的语言列表

~~~

开启多语言功能后，你可以在项目公共文件中设置要使用的语言，或者选择自动侦测当前语言。

~~~

// 设定当前语言

\think\Lang::range('zh-cn');

// 或者进行自动检测语言

\think\Lang::detect();

~~~

自动检测当前语言(主要是指浏览器访问的情况下)会对两种情况进行检测：

* 是否有`$_GET['lang'] `

* 识别`$_SERVER['HTTP_ACCEPT_LANGUAGE']`中的第一个语言

* 检测到任何一种情况下采用Cookie缓存

* 如果检测到的语言在lang_list配置参数之内认为有效，否则使用默认设置的语言

## 语言变量定义

语言变量的定义，只需要在需要使用多语言的地方，写成：

~~~

\think\Lang::get('add user error');

// 使用系统封装的快捷方法

L('add user error');

~~~

也就是说，字符串信息要改成`Lang::get`方法来表示。

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

## 语言文件定义

系统会默认加载下面两个语言包：

~~~

框架语言包: thinkphp\lang\当前语言.php

模块语言包: application\模块\lang\当前语言.php

~~~

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

~~~

\think\Lang::load(APP_PATH.'common\lang\zh-cn.php');

~~~

ThinkPHP语言文件定义采用返回数组方式：

~~~

return [

'hello thinkphp'=>'欢迎使用ThinkPHP',

'data type error'=>'数据类型错误',

];

~~~

也可以在程序里面动态设置语言定义的值，使用下面的方式：

~~~

\think\Lang::set('define2','语言定义');

$value = \think\Lang::get('define2');

~~~

通常多语言的使用是在控制器里面，但是模型类的自动验证功能里面会用到提示信息，这个部分也可以使用多语言的特性。例如原来的方式是把提示信息直接写在模型里面定义：

~~~

['title','require','标题必须！',1],

~~~

如果使用了多语言功能的话(假设，我们在当前语言包里面定义了' lang_var'=>'标题必须！')，就可以这样定义模型的自动验证

~~~

['title','require','{%lang_var}',1],

~~~

如果要在模板中输出语言变量不需要在控制器中赋值，可以直接使用模板引擎特殊标签来直接输出语言定义的值：

~~~

{$Think.lang.lang_var}

~~~

可以输出当前语言包里面定义的 `lang_var`语言定义。

## 变量传入支持

语言包定义的时候支持传入变量，例如：

~~~

'file_format' => '文件格式: {$format},文件大小：{$size}',

~~~

在模板中输出语言字符串的时候传入变量值即可：

~~~

{:L('file_format',['format' => 'jpeg,png,gif,jpg','maximum' => '2MB'])}

~~~