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'])}
~~~