萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

ThinkPHP 實作多語言功能完整教學

ThinkPHP 多語言支援實作指南

ThinkPHP 內建強大的多語言機制,透過語言包與行為擴展即可輕鬆實現網站國際化。本文詳細記錄從配置啟用、語言檢測行為、語言包建立到視圖調用的完整流程,適用於 ThinkPHP 3.x 版本。

1. 專案配置啟用多語言

在 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',     // 語言切換變數名稱
);
?>

2. 註冊語言檢測行為

在 Home/Conf/tags.php 中掛載 CheckLang 行為:

<?php
return array(
    'app_begin' => array('CheckLang'),
);
?>

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

將框架 Extend/Behavior/CheckLangBehavior.class.php 複製至 Home/Lib/Behavior/ 目錄(若無完整包請自行建立)。該類負責:

  • 依 LANG_AUTO_DETECT 判斷是否自動偵測
  • 優先順序:URL 參數 ?l= > Cookie think_language > HTTP_ACCEPT_LANGUAGE
  • 驗證語言是否在 LANG_LIST 白名單
  • 定義常數 LANG_SET 並依序載入框架、專案、分組、模組語言包

4. 建立語言包目錄與檔案

在 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',
);
?>

5. 視圖中調用語言變數

在 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>

6. 控制器中使用語言包

在 PHP 程式碼中透過 L() 函數獲取:

public function index() {
    echo L('add_user_error'); // 需在對應語言包定義
    $this->display();
}

完成上述步驟即可實現無縫語言切換,ThinkPHP 會自動記住用戶選擇(Cookie 有效期 1 小時)。

copyright © 萬盛學電腦網 all rights reserved