ThinkPHP內(nèi)置多語言支持,如果你的應(yīng)用涉及到國際化的支持,那么可以定義相關(guān)的語言包文件。任何字符串形式的輸出,都可以定義語言常量。
要啟用多語言功能,需要配置開啟多語言行為,在應(yīng)用的配置目錄下面的行為定義文件tags.php中,添加:
~~~
return array(
// 添加下面一行定義即可
'app_begin' => array('Behavior\CheckLangBehavior'),
);
~~~
表示在`app_begin`標(biāo)簽位置執(zhí)行多語言檢測行為。
要開啟語言包功能,需要開啟
~~~
'LANG_SWITCH_ON' => true, // 開啟語言包功能
~~~
其他的配置參數(shù)包括:
~~~
'LANG_AUTO_DETECT' => true, // 自動(dòng)偵測語言 開啟多語言功能后有效
'LANG_LIST' => 'zh-cn', // 允許切換的語言列表 用逗號分隔
'VAR_LANGUAGE' => 'l', // 默認(rèn)語言切換變量
~~~
可以為項(xiàng)目定義不同的語言文件,框架的系統(tǒng)語言包目錄在系統(tǒng)框架的Lang目錄下面,每個(gè)語言都對應(yīng)一個(gè)語言包文件,系統(tǒng)默認(rèn)只有簡體中文語言包文件zh-cn.php和英文語言包en-us.php ,如果要增加繁體中文zh-tw或者其他語言支持,只要增加相應(yīng)的語言定義文件。
語言包的使用由系統(tǒng)自動(dòng)判斷當(dāng)前用戶的瀏覽器支持語言來定位,如果找不到相關(guān)的語言包文件,會(huì)使用默認(rèn)的語言。如果瀏覽器支持多種語言,那么取第一種支持語言。
ThinkPHP的多語言支持是指的是模板多語言支持,數(shù)據(jù)的多語言轉(zhuǎn)換(翻譯)不在這個(gè)范疇之內(nèi)。ThinkPHP具備語言包定義、自動(dòng)識別、動(dòng)態(tài)定義語言參數(shù)的功能。并且可以自動(dòng)識別用戶瀏覽器的語言,從而選擇相應(yīng)的語言包(如果有定義)。例如:
~~~
throw_exception('新增用戶失?。?#039;);
~~~
我們在語言包里面增加了`ADD_USER_ERROR`語言配置變量的話,在程序中的寫法就要改為:
~~~
throw_exception(L('ADD_USER_ERROR'));
~~~
也就是說,字符串信息要改成L方法和語言定義來表示。
應(yīng)用語言包文件位于應(yīng)用公共模塊下的Lang目錄,并且按照語言類別分子目錄存放,在執(zhí)行的時(shí)候系統(tǒng)會(huì)自動(dòng)加載,無需手動(dòng)加載。
具體的語言包文件命名和位置如下:
| 語言包 | 語言文件位置 |
|-----|-----|
| 應(yīng)用語言包 | 應(yīng)用公共目錄/Lang/語言文件.php |
| 模塊語言包 | 模塊目錄/Lang/語言文件.php |
| 控制器語言包 | 模塊目錄/Lang/語言目錄/控制器名(小寫).php |
以當(dāng)前模塊為Home、當(dāng)前語言為zh-cn為例,我們可以讀取語言包的順序如下(如果沒有定義則不讀?。?
~~~
ThinkPHP/Lang/zh-cn.php 框架底層語言包
Application/Common/Lang/zh-cn.php 應(yīng)用公共語言包
Application/Home/Lang/zh-cn.php Home模塊語言包
Application/Home/Lang/zh-cn/user.php Home模塊的User控制器語言包
~~~
語言子目錄采用瀏覽器的語言命名(全部小寫)定義,例如English (United States) 可以使用en-us作為目錄名。如果項(xiàng)目比較小,整個(gè)項(xiàng)目只有一個(gè)語言包文件,那可以定義應(yīng)用的公共語言文件即可,而無需按照模塊分開定義。
## 語言文件定義
ThinkPHP語言文件定義采用返回?cái)?shù)組方式:
~~~
return array(
'lan_define'=>'歡迎使用ThinkPHP',
);
~~~
也可以在程序里面動(dòng)態(tài)設(shè)置語言定義的值,使用下面的方式:
~~~
L('define2','語言定義');
$value = L('define2');
~~~
通常多語言的使用是在控制器里面,但是模型類的自動(dòng)驗(yàn)證功能里面會(huì)用到提示信息,這個(gè)部分也可以使用多語言的特性。例如原來的方式是把提示信息直接寫在模型里面定義:
~~~
array('title','require','標(biāo)題必須!',1),
~~~
如果使用了多語言功能的話(假設(shè),我們在當(dāng)前語言包里面定義了' lang_var'=>'標(biāo)題必須!'),就可以這樣定義模型的自動(dòng)驗(yàn)證
~~~
array('title','require','{%lang_var}',1),
~~~
如果要在模板中輸出語言變量不需要在控制器中賦值,可以直接使用模板引擎特殊標(biāo)簽來直接輸出語言定義的值:
~~~
{$Think.lang.lang_var}
~~~
可以輸出當(dāng)前選擇的語言包里面定義的 `lang_var`語言定義。
## 變量傳入支持
語言包定義的時(shí)候支持傳入變量,例如:
~~~
'FILE_FORMAT' => '文件格式: {$format},文件大?。簕$size}',
~~~
在模板中輸出語言字符串的時(shí)候傳入變量值即可:
~~~
{:L('FILE_FORMAT',array('format' => 'jpeg,png,gif,jpg','maximum' => '2MB'))}
~~~
- 序言
- 基礎(chǔ)
- 獲取ThinkPHP
- 環(huán)境要求
- 目錄結(jié)構(gòu)
- 入口文件
- 自動(dòng)生成
- 模塊
- 控制器
- 開發(fā)規(guī)范
- 配置
- 配置格式
- 配置加載
- 讀取配置
- 動(dòng)態(tài)配置
- 擴(kuò)展配置
- 批量配置
- 架構(gòu)
- 模塊化設(shè)計(jì)
- URL模式
- 多層MVC
- CBD模式
- 命名空間
- 自動(dòng)加載
- 應(yīng)用模式
- 項(xiàng)目編譯
- 系統(tǒng)流程
- 路由
- 路由定義
- 規(guī)則路由
- 正則路由
- 靜態(tài)路由
- 閉包支持
- 實(shí)例說明
- 控制器
- 控制器定義
- 前置和后置操作
- Action參數(shù)綁定
- 偽靜態(tài)
- URL大小寫
- URL生成
- AJAX返回
- 跳轉(zhuǎn)和重定向
- 輸入變量
- 請求類型
- 空操作
- 空控制器
- 插件控制器
- 操作綁定到類
- 模型
- 模型定義
- 模型實(shí)例化
- 字段定義
- 連接數(shù)據(jù)庫
- 切換數(shù)據(jù)庫
- 分布式數(shù)據(jù)庫支持
- 連貫操作
- WHERE
- TABLE
- ALIAS
- DATA
- FIELD
- ORDER
- LIMIT
- PAGE
- GROUP
- HAVING
- JOIN
- UNION
- DISTINCT
- LOCK
- CACHE
- COMMENT
- RELATION
- USING
- fetchSql
- TOKEN
- STRICT
- INDEX
- 命名范圍
- CURD操作
- 數(shù)據(jù)創(chuàng)建
- 數(shù)據(jù)寫入
- 數(shù)據(jù)讀取
- 數(shù)據(jù)更新
- 數(shù)據(jù)刪除
- ActiveRecord
- 字段映射
- 查詢語言
- 查詢方式
- 表達(dá)式查詢
- 快捷查詢
- 區(qū)間查詢
- 組合查詢
- 統(tǒng)計(jì)查詢
- SQL查詢
- 動(dòng)態(tài)查詢
- 子查詢
- 自動(dòng)驗(yàn)證
- 自動(dòng)完成
- 參數(shù)綁定
- 虛擬模型
- 模型分層
- 視圖模型
- 關(guān)聯(lián)模型
- 高級模型
- Mongo模型
- 視圖
- 模板定義
- 模板主題
- 模板賦值
- 模板渲染
- 獲取模板地址
- 獲取內(nèi)容
- 模板引擎
- 模板
- 變量輸出
- 系統(tǒng)變量
- 使用函數(shù)
- 默認(rèn)值輸出
- 使用運(yùn)算符
- 標(biāo)簽庫
- 模板繼承
- 修改定界符
- 三元運(yùn)算
- 包含文件
- 內(nèi)置標(biāo)簽
- Volist標(biāo)簽
- Foreach標(biāo)簽
- For標(biāo)簽
- Switch標(biāo)簽
- 比較標(biāo)簽
- 范圍判斷標(biāo)簽
- IF標(biāo)簽
- Present標(biāo)簽
- Empty標(biāo)簽
- Defined標(biāo)簽
- Assign標(biāo)簽
- Define標(biāo)簽
- 標(biāo)簽嵌套
- import標(biāo)簽
- 使用PHP代碼
- 原樣輸出
- 模板注釋
- 模板布局
- 模板替換
- 調(diào)試
- 調(diào)試模式
- 異常處理
- 日志記錄
- 頁面Trace
- Trace方法
- 變量調(diào)試
- 性能調(diào)試
- 錯(cuò)誤調(diào)試
- 模型調(diào)試
- 緩存
- 數(shù)據(jù)緩存
- 快速緩存
- 查詢緩存
- 靜態(tài)緩存
- 安全
- 輸入過濾
- 表單合法性檢測
- 表單令牌
- 防止SQL注入
- 目錄安全文件
- 保護(hù)模板文件
- 上傳安全
- 防止XSS攻擊
- 其他安全建議
- 擴(kuò)展
- 類庫擴(kuò)展
- 驅(qū)動(dòng)擴(kuò)展
- 緩存驅(qū)動(dòng)
- 數(shù)據(jù)庫驅(qū)動(dòng)
- 日志驅(qū)動(dòng)
- Session驅(qū)動(dòng)
- 存儲驅(qū)動(dòng)
- 模板引擎驅(qū)動(dòng)
- 標(biāo)簽庫驅(qū)動(dòng)
- 行為擴(kuò)展
- 標(biāo)簽擴(kuò)展
- Widget擴(kuò)展
- 應(yīng)用模式
- 部署
- PATH_INFO支持
- URL重寫
- 模塊部署
- 域名部署
- 入口綁定
- 替換入口
- 專題
- SESSION支持
- Cookie支持
- 多語言支持
- 數(shù)據(jù)分頁
- 文件上傳
- 驗(yàn)證碼
- 圖像處理
- RESTFul
- RPC
- SAE
- IP獲取和定位
- 附錄
- 常量參考
- 配置參考
- 升級指導(dǎo)
- 鳴謝
