# 多語言 ThinkPHP內置通過`\think\facade\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( '../application/common/lang/zh-cn.php'); ``` ThinkPHP語言文件定義采用返回數組方式： ``` return [ 'hello thinkphp' => '歡迎使用ThinkPHP', 'data type error' => '數據類型錯誤', ]; ``` 通常多語言的使用是在控制器里面，但是模型類的自動驗證功能里面會用到提示信息，這個部分也可以使用多語言的特性。 如果使用了多語言功能的話（假設，我們在當前語言包里面定義了' lang\_var'=>'標題必須！'），就可以使用下面的字符串來替代原來的錯誤提示。 ``` {%lang_var} ``` 如果要在模板中輸出語言變量不需要在控制器中賦值，可以直接使用模板引擎特殊標簽來直接輸出語言定義的值： ``` {$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'])} ```