ThinkPHP 多語言功能完整實現指南（語言包模式）

ThinkPHP 內置強大的多語言支持，通過語言包 + 行為擴展實現零侵入式國際化。本文梳理完整配置流程，助你快速構建多語言應用。

核心配置步驟

1. 開啟多語言開關（Home/Conf/config.php）

return array(
    'LANG_SWITCH_ON'   => true,   // 啟用語言包
    'LANG_AUTO_DETECT' => true,   // 自動偵測瀏覽器語言
    'DEFAULT_LANG'     => 'zh-cn', // 默認語言
    'LANG_LIST'        => 'en-us,zh-cn,zh-tw', // 允許語言列表
    'VAR_LANGUAGE'     => 'l',     // URL 切換變量名
);

2. 掛載語言檢測行為（Home/Conf/tags.php）

return array(
    'app_begin' => array('CheckLang')
);

3. 複製/創建語言檢測行為類

將框架 Extend/Behavior/CheckLangBehavior.class.php 複製至 Home/Lib/Behavior/，或自行創建。核心邏輯：

• 讀取配置判斷是否啟用
• 按優先級確定語言：URL 參數 → Cookie → 瀏覽器 Accept-Language → 默認語言
• 驗證語言合法性（在 LANG_LIST 內）
• 定義常量 LANG_SET
• 按順序加載：框架公共包 → 項目公共包 → 分組公共包 → 模塊包

4. 創建語言包文件

目錄結構：

Home/Lang/
├── zh-cn/common.php
├── en-us/common.php
└── zh-tw/common.php

文件格式（返回鍵值對數組）：

 '歡迎使用 ThinkPHP',
    'login'   => '登錄',
    'logout'  => '退出'
);

// en-us/common.php
return array(
    'welcome' => 'Welcome to ThinkPHP',
    'login'   => 'Login',
    'logout'  => 'Logout'
);

5. 視圖模板中使用

<div class="result">{$Think.lang.welcome}</div>
<a href="?l=zh-cn">簡體中文</a> |
<a href="?l=en-us">English</a> |
<a href="?l=zh-tw">繁體中文</a>

6. 控制器/模型中調用

public function index() {
    echo L('welcome'); // 輸出當前語言對應文本
    $this->display();
}

進階技巧

• 分模塊語言包： Home/Lang/zh-cn/User.php 對應 User 模塊
• 動態參數替換： 語言包定義 'hello' => 'Hello, %s!'，調用 L('hello', 'John')
• 後台語言獨立： 可配置單獨的 ADMIN_LANG_LIST
• JS 多語言： 通過 AJAX 載入語言包生成 JS 變量對象

常見問題排查

1. 語言不生效 → 檢查 LANG_SWITCH_ON、tags.php 掛載、行為類路徑
2. 切換無效 → 確認 VAR_LANGUAGE 參數名一致、Cookie 權限
3. 顯示鍵名 → 語言包文件語法錯誤、編碼非 UTF-8、未正確返回數組

掌握此機制，可輕鬆構建支持多語言的企業級應用，滿足全球化業務需求。