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'))}
~~~
> 移動端的國際化支持,可以寫一個api返回L() 全部關聯數組和語言,然后前臺實現一個語言的讀取函數,思路和后端差不多
- 序
- 前言
- 內容簡介
- 目錄
- 基礎知識
- 起步
- 控制器
- 模型
- 模板
- 命名空間
- 進階知識
- 路由
- 配置
- 緩存
- 權限
- 擴展
- 國際化
- 安全
- 單元測試
- 拿來主義
- 調試方法
- 調試的步驟
- 調試工具
- 顯示trace信息
- 開啟調試和關閉調試的區別
- netbeans+xdebug
- Socketlog
- PHP常見錯誤
- 小黃鴨調試法,每個程序員都要知道的
- 應用場景
- 第三方登錄
- 圖片處理
- 博客
- SAE
- REST實踐
- Cli
- ajax分頁
- barcode條形碼
- excel
- 發郵件
- 漢字轉全拼和首字母,支持帶聲調
- 中文分詞
- 瀏覽器useragent解析
- freelog項目實戰
- 需求分析
- 數據庫設計
- 編碼實踐
- 前端實現
- rest接口
- 文章發布
- 文件上傳
- 視頻播放
- 音樂播放
- 圖片幻燈片展示
- 注冊和登錄
- 個人資料更新
- 第三方登錄的使用
- 后臺
- 微信的開發
- 首頁及個人主頁
- 列表
- 歸檔
- 搜索
- 分頁
- 總結經驗
- 自我提升
- 進行小項目的鍛煉
- 對現有輪子的重構和移植
- 寫技術博客
- 制作視頻教程
- 學習PHP的知識和新特性
- 和同行直接溝通、交流
- 學好英語,走向國際
- 如何參與
- 瀏覽官網和極思維還有看云
- 回答ThinkPHP新手的問題
- 嘗試發現ThinkPHP的bug,告訴官方人員或者push request
- 開發能提高效率的ThinkPHP工具
- 嘗試翻譯官方文檔
- 幫新手入門
- 創造基于ThinkPHP的產品,進行連帶推廣
- 展望未來
- OneThink
- ThinkPHP4
- 附錄