PHP gettext 多語系國際化（i18n）完整實作教學

工具鏈

• xgettext：從原始碼萃取字串 → .pot（範本）
• msginit：依 .pot 建立語系 .po（翻譯檔）
• msgfmt：編譯 .po → .mo（二進位，給程式讀取）
• gettext / _()：執行時翻譯

步驟實作

1. 原始碼標記可翻譯字串

<?php
// home.php
$str = _('home'); // 或 gettext('home')
echo "<a href='#'>{$str}</a>";

2. 產生 .pot 範本

xgettext -a home.php -o home.pot

產生 home.pot，包含 msgid "home" 待翻譯。

3. 建立語系 .po 檔

export LANG=zh_TW.UTF-8
msginit -l zh_TW.UTF-8 -i home.pot

產生 zh_TW.po，編輯 msgstr "首頁"。

4. 編譯 .mo 二進位檔

msgfmt zh_TW.po -o zh_TW.mo

5. 部署 .mo 到正確路徑

mkdir -p locale/zh_TW/LC_MESSAGES
cp zh_TW.mo locale/zh_TW/LC_MESSAGES/home.mo

6. PHP 程式設定語系與域

<?php
putenv('LANG=zh_TW.UTF-8');
setlocale(LC_ALL, 'zh_TW.UTF-8');

bindtextdomain('home', './locale');  // 指定 .mo 根目錄
textdomain('home');                  // 設定預設域

echo _("home"); // 輸出：首頁

目錄結構

project/
├── home.php
├── locale/
│   ├── zh_TW/
│   │   └── LC_MESSAGES/
│   │       └── home.mo
│   ├── en_US/
│   │   └── LC_MESSAGES/
│   │       └── home.mo
│   └── ja_JP/
│       └── LC_MESSAGES/
│           └── home.mo

切換語系

<?php
$lang = $_GET['lang'] ?? 'zh_TW';
putenv("LANG={$lang}");
setlocale(LC_ALL, $lang);
bindtextdomain('home', './locale');
textdomain('home');

常見問題

進階：複數形式

// .po
msgid "%d file"
msgid_plural "%d files"
msgstr[0] "%d 個檔案"
msgstr[1] "%d 個檔案"  // 中文無複數變化

// PHP
echo ngettext("%d file", "%d files", $count);