核心要點(diǎn)

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

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

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

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

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

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

Poedit分析網(wǎng)站的源代碼，根據(jù)我們在軟件中設(shè)置的一種或多種模式提取要翻譯的字符串。它將字符串保存在擴(kuò)展名為.po（Portable Object）的單個(gè)文件中，該軟件（或等效軟件）會將其編譯成二進(jìn)制.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);

// 設(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");
?>

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

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

什麼是Audero Shared Gettext

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

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

// 指示此會話將使用哪種語言
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");
?>

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

“偉大的Aurelio！”，你在想，“但是這樣我的文件夾就會因?yàn)檫@些複製而膨脹。”沒錯(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會將庫安裝到您項(xiàng)目的vendor/audero目錄中。

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

php composer.phar install

您擁有的最後一個(gè)選項(xiàng)是訪問存儲庫並將其下載為存檔。

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

您是否遇到過此問題？您是如何解決的？不要害羞，在評論中發(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等工具打開這些文件並檢查是否存在任何語法錯(cuò)誤。此外，您可以在代碼中使用gettext函數(shù)來檢查翻譯是否正在正確獲取。如果該函數(shù)返回原始字符串，則表示找不到翻譯。

我可以在WordPress中使用Gettext嗎？

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

如何更新我的Gettext翻譯？

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

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

此錯(cuò)誤通常發(fā)生在您的服務(wù)器正在使用的存儲庫中沒有該軟件包時(shí)。您可以嘗試使用sudo apt-get update命令更新您的軟件包列表。如果錯(cuò)誤仍然存在，您可能需要添加其他存儲庫或手動(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)製文件。它們在運(yùn)行時(shí)由Gettext用於獲取翻譯。

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