多語言配置文件對比：哪些鍵值未翻譯？

M66 2025-06-06

在開發多語言支持的Web應用時，我們常常會有多個語言的配置文件（比如en.php , fr.php , de.php等），每個配置文件包含了對應語言的翻譯內容。在實際開發中，可能會遇到一些鍵值未被翻譯的情況，或者某些鍵在某個語言的配置文件中缺失。那麼，如何使用PHP程序自動化對比多個語言的配置文件，找出這些未翻譯的鍵值呢？

本文將展示如何編寫一個PHP腳本，通過對比多個語言配置文件，識別出哪些鍵值未被翻譯，幫助開發者更好地進行多語言管理。

1. 配置文件結構

假設我們有以下的多語言配置文件：

en.php (英文)

 return [
    'welcome_message' => 'Welcome to our website!',
    'login' => 'Login',
    'register' => 'Register',
];

fr.php (法文)

 return [
    'welcome_message' => 'Bienvenue sur notre site!',
    'login' => 'Se connecter',
];

de.php (德文)

 return [
    'welcome_message' => 'Willkommen auf unserer Website!',
    'register' => 'Registrieren',
];

如上所示，不同語言的配置文件包含了一些相同的鍵（如welcome_message ），但是也有一些鍵只在某些語言中出現（如login只在英文和法文中出現，但德文缺少該鍵）。

2. PHP腳本邏輯

為了對比這些配置文件，我們可以編寫一個PHP腳本，加載各語言的配置文件並對比它們，找出哪些鍵在某些語言的文件中缺失或未翻譯。

步驟1：加載配置文件

首先，我們需要編寫一個函數來加載配置文件。可以使用include或者require來加載這些文件，假設這些配置文件都是返回一個關聯數組。

 function loadLangFile($langCode) {
    $filePath = __DIR__ . "/$langCode.php";
    if (file_exists($filePath)) {
        return include $filePath;
    }
    return [];
}

步驟2：找出所有鍵

我們需要從所有配置文件中找出所有的鍵。為了方便起見，假設我們已經知道所有支持的語言代碼（比如en 、 fr 、 de等）。我們可以遍歷每個語言配置文件，並把它們的鍵合併到一起。

 $langCodes = ['en', 'fr', 'de'];
$allKeys = [];

foreach ($langCodes as $langCode) {
    $langData = loadLangFile($langCode);
    $allKeys = array_merge($allKeys, array_keys($langData));
}

$allKeys = array_unique($allKeys);  // 去重，避免重複鍵

步驟3：對比並找出未翻譯的鍵

接下來，我們將遍歷所有的鍵，檢查它們是否在每個語言配置文件中都有對應的值。如果某個鍵在某個語言的配置文件中缺失或為空值，我們就可以認為該鍵未被翻譯。

 $missingKeys = [];

foreach ($allKeys as $key) {
    foreach ($langCodes as $langCode) {
        $langData = loadLangFile($langCode);
        if (!isset($langData[$key]) || empty($langData[$key])) {
            $missingKeys[$langCode][] = $key;
        }
    }
}

步驟4：輸出結果

最後，我們可以輸出未翻譯的鍵，幫助開發者快速定位哪些鍵未完成翻譯。

 echo "未翻譯的鍵：\n";
foreach ($missingKeys as $langCode => $keys) {
    echo "\n在語言 $langCode 中缺少以下鍵：\n";
    foreach ($keys as $key) {
        echo "- $key\n";
    }
}

3. 完整代碼示例

將所有的代碼合併在一起，最終的PHP腳本如下所示：

 function loadLangFile($langCode) {
    $filePath = __DIR__ . "/$langCode.php";
    if (file_exists($filePath)) {
        return include $filePath;
    }
    return [];
}

$langCodes = ['en', 'fr', 'de'];
$allKeys = [];

foreach ($langCodes as $langCode) {
    $langData = loadLangFile($langCode);
    $allKeys = array_merge($allKeys, array_keys($langData));
}

$allKeys = array_unique($allKeys);  // 去重，避免重複鍵

$missingKeys = [];

foreach ($allKeys as $key) {
    foreach ($langCodes as $langCode) {
        $langData = loadLangFile($langCode);
        if (!isset($langData[$key]) || empty($langData[$key])) {
            $missingKeys[$langCode][] = $key;
        }
    }
}

echo "未翻譯的鍵：\n";
foreach ($missingKeys as $langCode => $keys) {
    echo "\n在語言 $langCode 中缺少以下鍵：\n";
    foreach ($keys as $key) {
        echo "- $key\n";
    }
}

4. 總結

通過上述PHP腳本，我們能夠快速對比多個語言的配置文件，找出哪些鍵值未翻譯。這對於多語言應用的維護和更新非常有幫助，能夠減少遺漏翻譯的情況，從而提升用戶體驗。

array_diff_assoc