核心要點(diǎn)

• Gettext是PHP網(wǎng)站翻譯管理的流行方法，但它有一個(gè)顯著缺點(diǎn)：Apache緩存翻譯，這意味著除非重新啟動(dòng)引擎，否則翻譯文件的更新將不可見。這在共享主機(jī)上尤其成問題，因?yàn)橥ǔo法獲得管理員權(quán)限。
• Audero Shared Gettext是一個(gè)PHP庫(kù)，允許開發(fā)者繞過Apache對(duì)通過gettext()函數(shù)加載的翻譯的緩存。該庫(kù)使用一個(gè)簡(jiǎn)單的技巧，創(chuàng)建翻譯文件的鏡像副本，從而欺騙Apache將其視為新的、不相關(guān)的翻譯，從而避免緩存問題。
• Audero Shared Gettext可以通過Composer、Git或從存儲(chǔ)庫(kù)下載存檔來安裝。安裝后，開發(fā)者可以使用Composer的自動(dòng)加載器動(dòng)態(tài)加載類并創(chuàng)建SharedGettext實(shí)例。
• 該庫(kù)由于使用了命名空間，因此需要PHP 5.3或更高版本，并根據(jù)CC BY-NC 4.0許可證發(fā)布，可以免費(fèi)使用。它的兩個(gè)主要方法是updateTranslation()，它創(chuàng)建翻譯文件的鏡像副本，以及deleteOldTranslations()，它刪除選定翻譯文件夾中除最新鏡像副本以外的所有副本。

許多公司最終都會(huì)將目標(biāo)市場(chǎng)轉(zhuǎn)向全球。這一目標(biāo)將帶來將公司網(wǎng)站翻譯成一種或多種語(yǔ)言的需求。即使您不為大公司工作，您也可能需要以您的母語(yǔ)（假設(shè)您不是英語(yǔ)母語(yǔ)人士）推出新服務(wù)以瞄準(zhǔn)當(dāng)?shù)厥袌?chǎng)，并以英語(yǔ)面向全球市場(chǎng)。作為開發(fā)者，我們的職責(zé)不是翻譯文本，而是準(zhǔn)備網(wǎng)站以支持翻譯。在PHP中，最流行的方法是通過Gettext。這是一種很棒的方法，因?yàn)樗试S將翻譯與應(yīng)用程序分離，從而實(shí)現(xiàn)流程的并行化。問題在于，Apache緩存翻譯，因此，除非您可以重新啟動(dòng)引擎，否則翻譯文件的任何更新都將不會(huì)顯示。如果您在共享主機(jī)上工作并且沒有管理員權(quán)限，那么這一事實(shí)尤其令人惱火。在本文中，我將詳細(xì)描述此問題并解釋我找到的解決方案以避免此問題。

注意：如果您不熟悉I18N、翻譯和Gettext的概念，我強(qiáng)烈建議您在進(jìn)一步探索本文之前閱讀本系列文章。它將為您提供比您在此處找到的簡(jiǎn)要概述更詳細(xì)的信息，并幫助您更好地理解這些主題。

環(huán)境設(shè)置

在PHP中使用翻譯有很多方法。我能回憶起的最簡(jiǎn)單的一種方法是擁有一個(gè)包含所有翻譯字符串的關(guān)聯(lián)數(shù)組，然后使用鍵來檢索正確的字符串。正如您可能猜到的那樣，此解決方案的擴(kuò)展性不佳，除非您正在處理一個(gè)非常非常小的項(xiàng)目（也許不超過5行代碼），否則應(yīng)避免使用此解決方案。對(duì)于嚴(yán)肅的翻譯，我們可以使用Gettext。這種方法使我們能夠?yàn)槊總€(gè)目標(biāo)語(yǔ)言擁有不同的文件，這有助于維護(hù)業(yè)務(wù)邏輯、表示層和翻譯（我們可以將其視為表示層的附加組件）之間的分離。使用Gettext，我們可以并行化流程，因?yàn)樵谖覀兲幚砭W(wǎng)站的某些功能時(shí)，翻譯人員仍然可以使用Poedit等軟件進(jìn)行翻譯。

翻譯應(yīng)存儲(chǔ)在具有固定結(jié)構(gòu)的路徑中。首先，我們將有一個(gè)根據(jù)您的喜好命名的根文件夾（例如“l(fā)anguages”）。在其中，我們必須為每個(gè)目標(biāo)語(yǔ)言創(chuàng)建一個(gè)文件夾，其名稱必須符合ISO 3166標(biāo)準(zhǔn)。因此，意大利語(yǔ)翻譯的有效名稱可以是“it_IT”（意大利語(yǔ)意大利語(yǔ)）、“it_CH”（意大利語(yǔ)瑞士語(yǔ)）、“en_US”（美國(guó)英語(yǔ)）等等。在具有語(yǔ)言代碼的文件夾中，我們必須有一個(gè)名為“LC_MESSAGES”的文件夾，最后，我們將在其中存儲(chǔ)翻譯文件。

Poedit分析網(wǎng)站的源代碼，根據(jù)我們?cè)谲浖性O(shè)置的一種或多種模式提取要翻譯的字符串。它將字符串保存在擴(kuò)展名為.po（Portable Object）的單個(gè)文件中，該軟件（或等效軟件）會(huì)將其編譯成二進(jìn)制.mo文件。后者是我們和PHP的gettext()函數(shù)感興趣的格式。.mo文件是我們必須放置在我們之前創(chuàng)建的“LC_MESSAGES”目錄中的文件。

使用gettext()的示例代碼如下（代碼已添加注釋，以便您快速了解其作用）：

<?php
// 包含翻譯文件的根文件夾的名稱
$translationsPath = 'languages';
// 要翻譯到的語(yǔ)言
$language = 'it_IT';
// 翻譯文件的名稱（在gettext中稱為域）
$domain = 'audero';

// 指示此會(huì)話將使用哪種語(yǔ)言
putenv("LANG=" . $language);
setlocale(LC_ALL, $language);

// 設(shè)置當(dāng)前域的路徑
bindtextdomain($domain, $translationsPath);
// 指定字符編碼
bind_textdomain_codeset($domain, 'UTF-8');

// 選擇域
textdomain($domain);

// 調(diào)用gettext()函數(shù)（它有一個(gè)名為_()的別名）
echo gettext("HELLO_WORLD"); // 等效于echo _("HELLO_WORLD");
?>

將之前的代碼保存在頁(yè)面中并在瀏覽器中加載后，如果gettext()能夠找到翻譯文件，您將在屏幕上看到您進(jìn)行的翻譯。

到目前為止，一切順利。壞消息是，一旦加載翻譯，Apache就會(huì)對(duì)其進(jìn)行緩存。因此，除非我們可以重新啟動(dòng)引擎，否則翻譯文件的任何更新都將不會(huì)顯示。如果我們?cè)诠蚕碇鳈C(jī)上工作并且沒有管理員權(quán)限，那么這尤其令人惱火。如何解決此問題？Audero Shared Gettext來救援！

什么是Audero Shared Gettext

Audero Shared Gettext是一個(gè)PHP庫(kù)（實(shí)際上只是一個(gè)類，但讓我做夢(mèng)吧），它允許您繞過通過gettext()函數(shù)加載的翻譯被Apache緩存的問題。該庫(kù)采用了一種簡(jiǎn)單而有效的方法，因此您將始終使用最新的翻譯。Audero Shared Gettext需要PHP 5.3或更高版本，因?yàn)樗褂妹臻g，并且存在上一節(jié)中描述的結(jié)構(gòu)。它有兩個(gè)主要方法：updateTranslation()和deleteOldTranslations()。前者是庫(kù)的核心，也是實(shí)現(xiàn)此技巧的方法。但是這個(gè)技巧是什么呢？讓我們看看它的代碼，以了解更多信息。為了充分理解它，值得強(qiáng)調(diào)的是，類的構(gòu)造函數(shù)接受存儲(chǔ)翻譯的路徑、要翻譯到的語(yǔ)言以及翻譯文件的名稱（域）。

<?php
// 包含翻譯文件的根文件夾的名稱
$translationsPath = 'languages';
// 要翻譯到的語(yǔ)言
$language = 'it_IT';
// 翻譯文件的名稱（在gettext中稱為域）
$domain = 'audero';

// 指示此會(huì)話將使用哪種語(yǔ)言
putenv("LANG=" . $language);
setlocale(LC_ALL, $language);

// 設(shè)置當(dāng)前域的路徑
bindtextdomain($domain, $translationsPath);
// 指定字符編碼
bind_textdomain_codeset($domain, 'UTF-8');

// 選擇域
textdomain($domain);

// 調(diào)用gettext()函數(shù)（它有一個(gè)名為_()的別名）
echo gettext("HELLO_WORLD"); // 等效于echo _("HELLO_WORLD");
?>

該方法首先要做的是測(cè)試原始的二進(jìn)制翻譯文件（.mo文件）是否存在。如果不存在，則該方法會(huì)引發(fā)異常。然后，它根據(jù)提供給構(gòu)造函數(shù)的參數(shù)和文件的最后修改時(shí)間戳計(jì)算翻譯文件的完整路徑。之后，它創(chuàng)建一個(gè)新的字符串，將原始域與之前計(jì)算的時(shí)間戳連接起來。完成后，這里就是技巧所在，它會(huì)創(chuàng)建翻譯文件的鏡像副本。如果已經(jīng)存在具有此類名稱的文件，則該類足夠智能以避免此復(fù)制。最后，它返回將在bindtextdomain()、bind_textdomain_codeset()和textdomain()中使用的新名稱。這樣做，Apache將看到翻譯就像它與原始翻譯無關(guān)一樣，從而避免了緩存問題。正如我所說，簡(jiǎn)單而有效！

“偉大的Aurelio！”，你在想，“但是這樣我的文件夾就會(huì)因?yàn)檫@些復(fù)制而膨脹。”沒錯(cuò)。這就是我創(chuàng)建deleteOldTranslations()的原因。它刪除了選定翻譯文件夾中除最后一個(gè)以外的所有鏡像副本。

現(xiàn)在您已經(jīng)了解了Audero Shared Gettext是什么以及它可以為您做什么，讓我們看看如何獲得它。

安裝Audero Shared Gettext

您可以通過Composer獲得“Audero Shared Gettext”，將以下幾行添加到您的composer.json中：

/**
 * 創(chuàng)建翻譯文件的鏡像副本
 *
 * @return string 創(chuàng)建的翻譯文件的名稱（在gettext中稱為域）
 *
 * @throws \Exception 如果找不到翻譯文件
 */
public function updateTranslation()
{
    if (!self::translationExists()) {
        throw new \Exception('在給定路徑中找不到翻譯文件。');
    }
    $originalTranslationPath = $this->getTranslationPath();
    $lastAccess = filemtime($originalTranslationPath);
    $newTranslationPath = str_replace(self::FILE_EXTENSION, $lastAccess . self::FILE_EXTENSION, $originalTranslationPath);

    if(!file_exists($newTranslationPath)) {
            copy($originalTranslationPath, $newTranslationPath);
    }

    return $this->domain . $lastAccess;
}

然后運(yùn)行安裝命令以解析和下載依賴項(xiàng)：

"require": {
    "audero/audero-shared-gettext": "1.0.*"
}

Composer會(huì)將庫(kù)安裝到您項(xiàng)目的vendor/audero目錄中。

如果您不想使用Composer（您真的應(yīng)該這樣做），您可以通過運(yùn)行以下命令來通過Git獲得Audero Shared Gettext：

php composer.phar install

您擁有的最后一個(gè)選項(xiàng)是訪問存儲(chǔ)庫(kù)并將其下載為存檔。

如何使用Audero Shared Gettext

假設(shè)您使用Composer獲得了Audero Shared Gettext，您可以依靠其自動(dòng)加載器來動(dòng)態(tài)加載該類。然后，您必須創(chuàng)建一個(gè)SharedGettext實(shí)例并調(diào)用您需要的 method。您可以使用前面提到的方法之一，如下例所示。

git clone https://github.com/AurelioDeRosa/Audero-Shared-Gettext.git

結(jié)論

本文向您介紹了Audero Shared Gettext，這是一個(gè)簡(jiǎn)單的庫(kù)（嗯……類），它允許您繞過通過gettext()函數(shù)加載的翻譯被Apache緩存的問題。Audero Shared Gettext具有廣泛的兼容性，因?yàn)樗竽辽贀碛蠵HP 5.3（已經(jīng)發(fā)布一段時(shí)間了），因?yàn)樗褂昧嗣臻g。隨意使用存儲(chǔ)庫(kù)中包含的演示和文件，如果您發(fā)現(xiàn)問題，請(qǐng)?zhí)峤籔ull Request和問題。我已經(jīng)根據(jù)CC BY-NC 4.0許可證發(fā)布了Audero Shared Gettext，因此可以免費(fèi)使用。

您是否遇到過此問題？您是如何解決的？不要害羞，在評(píng)論中發(fā)布您的解決方案！

(以下為FAQ部分，已根據(jù)原文進(jìn)行偽原創(chuàng)，并保持原文大意)

關(guān)于在共享主機(jī)上管理Gettext翻譯的常見問題解答 (FAQ)

如何在我的共享主機(jī)上安裝Gettext？

在共享主機(jī)上安裝Gettext可能有點(diǎn)棘手，因?yàn)槟赡軟]有root訪問權(quán)限。但是，您仍然可以通過cPanel或Plesk安裝它。在cPanel中，您可以在“選擇PHP版本”部分下找到啟用Gettext的選項(xiàng)。在Plesk中，您可以在“PHP設(shè)置”部分下啟用它。如果您找不到這些選項(xiàng)，您可能需要聯(lián)系您的主機(jī)提供商尋求幫助。

為什么我的Gettext翻譯不起作用？

您的Gettext翻譯不起作用可能有幾個(gè)原因。一個(gè)常見的問題是.mo文件沒有正確編譯或文件路徑不正確。確保.mo文件位于正確的目錄中，并且代碼中的文件路徑正確。另一個(gè)問題可能是您使用的區(qū)域設(shè)置不受服務(wù)器支持。您可以使用locale -a命令檢查這一點(diǎn)。

如何調(diào)試Gettext翻譯？

調(diào)試Gettext翻譯可以通過檢查.po和.mo文件中的錯(cuò)誤來完成。您可以使用Poedit等工具打開這些文件并檢查是否存在任何語(yǔ)法錯(cuò)誤。此外，您可以在代碼中使用gettext函數(shù)來檢查翻譯是否正在正確獲取。如果該函數(shù)返回原始字符串，則表示找不到翻譯。

我可以在WordPress中使用Gettext嗎？

是的，您可以在WordPress中使用Gettext。WordPress使用Gettext作為其本地化框架。您可以在WordPress中使用__()和_e()函數(shù)來獲取翻譯。這些函數(shù)在后臺(tái)使用Gettext。

如何更新我的Gettext翻譯？

您可以通過更新.po文件然后將其編譯成.mo文件來更新您的Gettext翻譯。.po文件是一個(gè)純文本文件，您可以使用任何文本編輯器打開它。完成更改后，您可以使用Poedit之類的工具將.po文件編譯成.mo文件。

為什么我會(huì)收到“無法找到軟件包php-gettext”錯(cuò)誤？

此錯(cuò)誤通常發(fā)生在您的服務(wù)器正在使用的存儲(chǔ)庫(kù)中沒有該軟件包時(shí)。您可以嘗試使用sudo apt-get update命令更新您的軟件包列表。如果錯(cuò)誤仍然存在，您可能需要添加其他存儲(chǔ)庫(kù)或手動(dòng)安裝軟件包。

如何在PHP中使用Gettext？

您可以通過使用gettext函數(shù)在PHP中使用Gettext。此函數(shù)將字符串作為參數(shù)，并返回翻譯后的字符串。在您可以使用此函數(shù)之前，您需要使用setlocale函數(shù)設(shè)置區(qū)域設(shè)置，并使用bindtextdomain函數(shù)指定.mo文件的路徑。

我可以在Ubuntu上使用Gettext嗎？

是的，您可以在Ubuntu上使用Gettext。您可以使用sudo apt-get install gettext命令安裝它。安裝后，您可以使用終端中的gettext命令來處理.po和.mo文件。

如何創(chuàng)建.po和.mo文件？

您可以使用Poedit之類的工具創(chuàng)建.po和.mo文件。此工具允許您創(chuàng)建和編輯.po文件并自動(dòng)將其編譯成.mo文件。您也可以使用文本編輯器手動(dòng)創(chuàng)建.po文件，但是您需要Poedit或msgfmt之類的工具才能將其編譯成.mo文件。

.po和.mo文件有什么區(qū)別？

.po文件是包含原始字符串及其翻譯的純文本文件。它們可以使用任何文本編輯器打開和編輯。另一方面，.mo文件是根據(jù).po文件生成的二進(jìn)制文件。它們?cè)谶\(yùn)行時(shí)由Gettext用于獲取翻譯。

以上是管理共享托管上的getText翻譯的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！