Управление переводами Gettext на Shared Hosting

Что такое Audero Shared Gettext

Audero Shared Gettext — это PHP-библиотека (на самом деле это всего лишь один класс, но позвольте мне мечтать), которая позволяет обойти проблему переводов, загружаемых с помощью функции gettext() , которые кэшируются Apache. В библиотеке используется простой, но эффективный прием, благодаря которому у вас всегда будет самый актуальный используемый перевод. Для Audero Shared Gettext требуется PHP версии 5.3 или выше, поскольку он использует пространства имен и наличие структуры, описанной в предыдущем разделе. У него есть два основных метода: updateTranslation() и deleteOldTranslations() . Первый — это ядро ​​библиотеки и метод, который реализует трюк. Но что это за хитрость? Давайте посмотрим его код, чтобы узнать больше. Чтобы полностью понять это, стоит подчеркнуть, что конструктор класса принимает путь, в котором хранятся переводы, язык, на который нужно переводить, и имя файла перевода (домена).

 /** * Create a mirror copy of the translation file * * @return string The name of the created translation file (referred as domain in gettext) * * @throws \Exception If the translation's file cannot be found */ public function updateTranslation() { if (!self::translationExists()) { throw new \Exception('The translation file cannot be found in the given path.'); } $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; } 

Первое, что делает метод, это проверяет, существует ли оригинальный двоичный файл перевода (файл .mo). Если он не существует, метод генерирует исключение. Затем он вычисляет полный путь к файлу перевода на основе параметров, заданных конструктору, и отметки времени последней модификации файла. После этого он создает новую строку, объединяющую исходный домен с предварительно рассчитанной временной меткой. После того, как сделано, и вот хитрость, он создает зеркальную копию файла перевода. Класс достаточно умен, чтобы избежать этой копии, если файл с таким именем уже существует. Во-первых, он возвращает новое имя, которое мы будем использовать в bindtextdomain() , bind_textdomain_codeset() и textdomain() . При этом Apache будет видеть перевод так, как будто он не имеет отношения к исходному, избегая проблемы с кэшированием. Как я уже сказал, просто, но эффективно!

«Великий Аурелио!», Вы думаете, «но таким образом мои папки будут раздуты этими репликациями». Верно. Вот почему я создал deleteOldTranslations() . Он удаляет все зеркальные копии, кроме последней, из папки выбранного перевода.

Теперь, когда вы знаете, что такое Audero Shared Gettext и что он может сделать для вас, давайте посмотрим, как его получить.

Установка Audero Shared Gettext

Вы можете получить «Audero Shared Gettext» через Composer, добавив следующие строки в ваш
composer.json :

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

А затем запустите команду install чтобы разрешить и загрузить зависимости:

 php composer.phar install 

Composer установит библиотеку в каталог vendor/audero вашего проекта.

Если вы не хотите использовать Composer (вам действительно нужно), вы можете получить Audero Shared Gettext через Git, выполнив команду:

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

Последний вариант — зайти в хранилище и загрузить его в архив.

Как использовать Audero Shared Gettext

Предполагая, что вы получили Audero Shared Gettext с помощью Composer, вы можете положиться на его автозагрузчик для динамической загрузки класса. Затем вам нужно создать экземпляр SharedGettext и вызвать SharedGettext метод. Вы можете использовать один из ранее процитированных методов, как показано в следующем примере.

 <?php // Include the Composer autoloader require_once 'vendor/autoload.php'; $translationsPath = 'languages'; $language = 'it_IT'; $domain = 'audero'; putenv('LC_ALL=' . $language); setlocale(LC_ALL, $language); try { $sharedGettext = new Audero\SharedGettext\SharedGettext($translationsPath, $language, $domain); // Create the mirror copy of the translation and return the new domain $newDomain = $sharedGettext->updateTranslation(); // Sets the path for the current domain bindtextdomain($newDomain, $translationsPath); // Specifies the character encoding bind_textdomain_codeset($newDomain, 'UTF-8'); // Choose domain textdomain($newDomain); } catch(\Exception $ex) { echo $ex->getMessage(); } ?> 

Выводы

В этой статье вы познакомились с Audero Shared Gettext, простой библиотекой (класс emh…), которая позволяет обойти проблему переводов, загружаемых с помощью функции gettext() , кешируемой Apache. Audero Shared Gettext имеет широкую совместимость, потому что он требует, чтобы у вас был по крайней мере PHP 5.3 (выпущенный на некоторое время) из-за его использования пространств имен. Не стесняйтесь играть с демо-версией и файлами, включенными в репозиторий, отправлять запросы на извлечение и проблемы, если вы их найдете. Я выпустил Audero Shared Gettext под лицензией CC BY-NC 4.0, поэтому его можно использовать бесплатно.

Вы когда-нибудь сталкивались с этой проблемой? Как ты это решил? Не стесняйтесь и оставляйте свои решения в комментариях!