多語言

ThinkPHP內置通過\think\Lang類提供多語言支持，如果你的應用涉及到國際化的支持，那么可以定義相關的語言包文件。任何字符串形式的輸出，都可以定義語言常量。

開啟和加載語言包

默認情況下，系統(tǒng)載入的是配置的默認語言包，并且不會自動偵測當前系統(tǒng)的語言。
默認語言由default_lang配置參數設置，系統(tǒng)默認設置為：

// 默認語言
'default_lang'           => 'zh-cn',

要啟用語言自動偵測和多語言自動切換，需要開啟多語言切換，在應用的公共配置文件添加：

// 開啟語言切換
'lang_switch_on' => true,

開啟后，系統(tǒng)會自動檢測當前語言（主要是指瀏覽器訪問的情況下）會對兩種情況進行檢測：

如果不希望瀏覽器自動偵測語言，請關閉lang_switch_on后設置默認語言。

如果在自動偵測語言的時候，希望設置允許的語言列表，不在列表范圍的語言則仍然使用默認語言，可以使用：

// 設置允許的語言
Lang::setAllowLangList(['zh-cn','en-us']);

語言變量的定義，只需要在需要使用多語言的地方，寫成：

Lang::get('add user error');
// 使用系統(tǒng)封裝的助手函數
lang('add user error');

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

語言定義一般采用英語來描述。

系統(tǒng)會默認加載下面三個語言包：

框架語言包: 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' => '數據類型錯誤',
];

也可以在程序里面動態(tài)設置語言定義的值，使用下面的方式：

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

文檔最后更新時間：2018-04-26 10:52:50

← Cookie 分頁 →