ThinkPHP內置通過`\think\facade\Lang`類提供多語言支持，如果你的應用涉及到國際化的支持，那么可以定義相關的語言包文件。任何字符串形式的輸出，都可以定義語言常量。 ## 開啟和加載語言包 默認系統會加載默認語言包，但如果需要多語言自動偵測及自動切換，你需要在全局的中間件定義文件中添加中間件定義： ``` 'think\middleware\LoadLangPack', ``` 默認情況下，系統載入的是配置的默認語言包，并且不會自動偵測當前系統的語言。多語言相關的設置在`lang.php`配置文件中進行設置。 默認語言由`default_lang`配置參數設置，系統默認設置為： ~~~ // 默認語言 'default_lang' => 'zh-cn', ~~~ 啟用中間件后，系統會自動偵測和多語言自動切換，可以在配置文件設置自動偵測的多語言變量名： ~~~ // 自動偵測的GET變量名 'detect_var' => 'lang', ~~~ 開啟自動偵測后會會首先檢查請求的URL或者Cookie中是否包含語言變量，然后根據`HTTP_ACCEPT_LANGUAGE`自動識別當前語言（并載入對應的語言包）。 > `V6.0.3+`版本開始支持通過Header方式自動偵測多語言 如果在自動偵測語言的時候，希望設置允許的語言列表，不在列表范圍的語言則仍然使用默認語言，可以配置： ~~~ // 設置允許的語言 'allow_lang_list' => ['zh-cn', 'en-us'] ~~~ 如果希望使用`Cookie`保存語言，可以設置 ``` // 使用Cookie保存 'use_cookie' => true, // Cookie保存變量 'cookie_var' => 'think_lang', ``` 設置后，自動檢測的語言會通過`Cookie`記錄下來，下次則直接通過`Cookie`判斷語言。 ## 語言變量定義 語言變量的定義，只需要在需要使用多語言的地方，寫成： ~~~ Lang::get('add user error'); // 使用系統封裝的助手函數 lang('add user error'); ~~~ 也就是說，字符串信息要改成`Lang::get`方法來表示。 語言定義一般采用英語來描述。 ## 語言文件定義 自動加載的應用語言文件位于： ~~~ // 單應用模式 app/lang/當前語言.php // 多應用模式 app/應用/lang/當前語言.php ~~~ > 語言包文件支持多種格式，包括php數組、`yaml`格式及`json`格式（`V6.0.4+`）。 如果你還需要加載其他的語言包，可以通過`extend_list`設置，例如： ~~~ 'extend_list' => [ 'zh-cn' => [ app()->getBasePath() . 'lang/zh-cn/app.php', app()->getBasePath() . 'lang/zh-cn/core.php', ], ] ~~~ > 目前核心框架僅內置`zh-cn`語言包，如果需要其它語言的提示，可以通過擴展語言包的方式自行加載。 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'])} ~~~ ## 語言分組 首先你需要在lang.php配置文件中開啟語言分組， ``` // 開啟多語言分組 'allow_group' => true ``` 然后你可以在定義多語言的時候使用分組定義 ~~~ return [ 'user' => [ 'welcome' => '歡迎回來', 'login' => '用戶登錄', 'logout' => '用戶登出', ] ]; ~~~ 然后使用下面的方式獲取多語言變量 ~~~ Lang::get('user.login'); lang('user.login'); ~~~