多語言

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

開啟和加載語言包

默認(rèn)情況下,系統(tǒng)載入的是配置的默認(rèn)語言包,并且不會(huì)自動(dòng)偵測當(dāng)前系統(tǒng)的語言。
默認(rèn)語言由default_lang配置參數(shù)設(shè)置,系統(tǒng)默認(rèn)設(shè)置為:

// 默認(rèn)語言
'default_lang'           => 'zh-cn',

要啟用語言自動(dòng)偵測和多語言自動(dòng)切換,需要開啟多語言切換,在應(yīng)用的公共配置文件添加:

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

開啟后,系統(tǒng)會(huì)自動(dòng)檢測當(dāng)前語言(主要是指瀏覽器訪問的情況下)會(huì)對(duì)兩種情況進(jìn)行檢測:

  • 是否有$_GET['lang']
  • 識(shí)別$_SERVER['HTTP_ACCEPT_LANGUAGE']中的第一個(gè)語言
  • 檢測到任何一種情況下采用Cookie緩存
  • 如果檢測到的語言在允許的語言列表內(nèi)認(rèn)為有效,否則使用默認(rèn)設(shè)置的語言

如果不希望瀏覽器自動(dòng)偵測語言,請(qǐng)關(guān)閉lang_switch_on后設(shè)置默認(rèn)語言。

如果在自動(dòng)偵測語言的時(shí)候,希望設(shè)置允許的語言列表,不在列表范圍的語言則仍然使用默認(rèn)語言,可以使用:

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

語言變量定義

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

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

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

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

語言文件定義

系統(tǒng)會(huì)默認(rèn)加載下面三個(gè)語言包:

框架語言包: thinkphp\lang\當(dāng)前語言.php
應(yīng)用語言包: application\lang\當(dāng)前語言.php
模塊語言包: application\模\lang\當(dāng)前語言.php

如果你還需要加載其他的語言包,可以在設(shè)置或者自動(dòng)檢測語言之后,用load方法進(jìn)行加載:

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

ThinkPHP語言文件定義采用返回?cái)?shù)組方式:

return [
     'hello thinkphp'  => '歡迎使用ThinkPHP',
     'data type error' => '數(shù)據(jù)類型錯(cuò)誤',
];

也可以在程序里面動(dòng)態(tài)設(shè)置語言定義的值,使用下面的方式:

Lang::set('define2','語言定義');
$value = Lang::get('define2');

通常多語言的使用是在控制器里面,但是模型類的自動(dòng)驗(yàn)證功能里面會(huì)用到提示信息,這個(gè)部分也可以使用多語言的特性。例如原來的方式是把提示信息直接寫在模型里面定義:

['title','require','標(biāo)題必須!',1],

如果使用了多語言功能的話(假設(shè),我們?cè)诋?dāng)前語言包里面定義了' lang_var'=>'標(biāo)題必須!'),就可以這樣定義模型的自動(dòng)驗(yàn)證

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

如果要在模板中輸出語言變量不需要在控制器中賦值,可以直接使用模板引擎特殊標(biāo)簽來直接輸出語言定義的值:

{$Think.lang.lang_var}

可以輸出當(dāng)前語言包里面定義的 lang_var語言定義。

變量傳入支持

語言包定義的時(shí)候支持傳入變量,有兩種方式

使用命名綁定方式,例如:

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

在模板中輸出語言字符串的時(shí)候傳入變量值即可:

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

第二種方式是使用格式字串,如果你需要使用第三方的翻譯工具,建議使用該方式定義變量。

'file_format'    =>    '文件格式: %s,文件大?。?d',

在模板中輸出多語言的方式更改為:

{:lang('file_format',['jpeg,png,gif,jpg','2MB'])}
文檔最后更新時(shí)間:2018-04-26 10:52:50

文檔
目錄

深色
模式

切換
寬度