核心要點

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

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

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

環(huán)境設置

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

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

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

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

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

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

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

// 選擇域
textdomain($domain);

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

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

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

什么是Audero Shared Gettext

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

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

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

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

// 選擇域
textdomain($domain);

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

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

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

現(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;
}

然后運行安裝命令以解析和下載依賴項：

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

Composer會將庫安裝到您項目的vendor/audero目錄中。

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

php composer.phar install

您擁有的最后一個選項是訪問存儲庫并將其下載為存檔。

如何使用Audero Shared Gettext

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

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

結(jié)論

本文向您介紹了Audero Shared Gettext，這是一個簡單的庫（嗯……類），它允許您繞過通過gettext()函數(shù)加載的翻譯被Apache緩存的問題。Audero Shared Gettext具有廣泛的兼容性，因為它要求您至少擁有PHP 5.3（已經(jīng)發(fā)布一段時間了），因為它使用了命名空間。隨意使用存儲庫中包含的演示和文件，如果您發(fā)現(xiàn)問題，請?zhí)峤籔ull Request和問題。我已經(jīng)根據(jù)CC BY-NC 4.0許可證發(fā)布了Audero Shared Gettext，因此可以免費使用。

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

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

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

如何在我的共享主機上安裝Gettext？

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

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

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

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

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

我可以在WordPress中使用Gettext嗎？

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

如何更新我的Gettext翻譯？

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

為什么我會收到“無法找到軟件包php-gettext”錯誤？

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

如何在PHP中使用Gettext？

您可以通過使用gettext函數(shù)在PHP中使用Gettext。此函數(shù)將字符串作為參數(shù)，并返回翻譯后的字符串。在您可以使用此函數(shù)之前，您需要使用setlocale函數(shù)設置區(qū)域設置，并使用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文件并自動將其編譯成.mo文件。您也可以使用文本編輯器手動創(chuàng)建.po文件，但是您需要Poedit或msgfmt之類的工具才能將其編譯成.mo文件。

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

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

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