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