ThinkPHP 內建強大的多語言機制,透過語言包與行為擴展即可輕鬆實現網站國際化。本文詳細記錄從配置啟用、語言檢測行為、語言包建立到視圖調用的完整流程,適用於 ThinkPHP 3.x 版本。
在 Home/Conf/config.php 中加入以下設定:
<?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', // 語言切換變數名稱
);
?>
在 Home/Conf/tags.php 中掛載 CheckLang 行為:
<?php
return array(
'app_begin' => array('CheckLang'),
);
?>
將框架 Extend/Behavior/CheckLangBehavior.class.php 複製至 Home/Lib/Behavior/ 目錄(若無完整包請自行建立)。該類負責:
LANG_AUTO_DETECT 判斷是否自動偵測?l= > Cookie think_language > HTTP_ACCEPT_LANGUAGELANG_LIST 白名單LANG_SET 並依序載入框架、專案、分組、模組語言包在 Home/Lang/ 下建立三個語言資料夾:zh-cn、en-us、zh-tw,各放入 common.php:
<?php // zh-cn/common.php
return array(
'welcome' => '歡迎使用 ThinkPHP',
);
?>
<?php // en-us/common.php
return array(
'welcome' => 'Welcome to use ThinkPHP',
);
?>
<?php // zh-tw/common.php
return array(
'welcome' => '歡迎使用 ThinkPHP',
);
?>
在 Tpl/Index/index.html 中使用 {$Think.lang.welcome} 輸出,並提供切換連結:
<div>切換語言:
<a href="?l=zh-cn">簡體中文</a> |
<a href="?l=zh-tw">繁體中文</a> |
<a href="?l=en-us">英文</a>
</div>
<div class="result">{$Think.lang.welcome}</div>
在 PHP 程式碼中透過 L() 函數獲取:
public function index() {
echo L('add_user_error'); // 需在對應語言包定義
$this->display();
}
完成上述步驟即可實現無縫語言切換,ThinkPHP 會自動記住用戶選擇(Cookie 有效期 1 小時)。