Вторая часть статьи о локализации веб-проектов с помощью gettext и Zend Framework. В первой части статьи мы определились с выбором адаптера.

Наш выбор пал на Gettext – быстрое и грамотное решение с набором инструментария для облегчения реализации. Итак, вторая часть будет описывать Zend_Translate и работу с ним, чтобы уяснить себе четко нюансы программирования в PHP.

Следующая часть расскажет нам, как подготовить файлы переводов, покажет основные приемы и самое главное решит одну очень важную проблему, но об этом потом. Сейчас нас интересует программинг. Что-же, приступим!

Бутстрап файл

В бутстрапе мы должны инициализировать Zend_Translate, передав ему нужные параметры: адаптер, папку с переводами, текущую локаль и некоторые специфические настройки. Самое главное определится с структурой каталогов. У меня, например, в новой версии моей CMS, ядро системы, плагины и модули имеют папку «locale», где и хранятся переводы. Zend_Translate находит переводы по имени файла, например, «ru.mo».

Есть разные типы автоматического нахождения файлов Zend'ом:

1. В каждой папке, например, «en», «ru», есть отдельный набор файлов переводов. Т.е. по названию папки (Zend_Translate::LOCALE_DIRECTORY);
2. По названию файла (Zend_Translate::LOCALE_FILENAME):

• По всему имени файла, например, «ru.mo», где «ru» - локаль (мой выбор)
• По расширению файла, например, «core.ru»
• По структуре имени файла и приоритетах разделителей, например, «core_ru.mo», «core.ru.mo», «core-ru.mo». Если в имени файла встречаются несколько разделителе одновременно, то приоритет следующий: «.», «_», «-».

Для себя я выбрал вариант «по всему имени файла», чтобы не путаться. Структуру каталогов поменять, если что успеете. Поэтому потренируйтесь с вариантом, который выбрал я.

Итак, код инициализации Zend_Translate:

<?php require_once 'Zend/Translate.php'; $translator = new Zend_Translate( 'gettext', // Адаптер '/bla-bla-bla/locale/', // Папка, где искать переводы 'ru', // Текущая локаль // Специфические опции array( // Тип автоматического определения переводов 'scan'=>Zend_Translate::LOCALE_FILENAME )); /** * Задаем транслятор для Zend_Validate, * чтобы все ошибки валидации выводились * пользователю на нужном языке */ require_once 'Zend/Validate/Abstract.php'; Zend_Validate_Abstract::setDefaultTranslator($translator); ?>

Как видите, все как всегда очень просто . В данном коде мы создали объект Zend_Translate, передав сразу же специфические опции. Эти опции можно передавать еще и функцией setOptions объекта, например, давайте заставим Zend Framework записывать все непереведенные строки в лог-файл:

<?php /** * Объект Zend_Translate уже создан, переменная $translator */ // Создадим экземпляр Zend_Log require_once 'Zend/Log/Writer/Stream.php'; $writer = new Zend_Log_Writer_Stream('/path/to/file.log'); require_once 'Zend/Log.php'; $log = new Zend_Log($writer); // Передадим необходимые параметры в транслятор $translator->setOptions(array( 'log' => $log, // объект Zend_Log 'logMessage' => "Неизвестное сообщение '%message%' в локале '%locale%'", 'logUntranslated' => true // Включение механизма логгинга )); ?>

Алгоритм следующий:

1. Создали объект Zend_Translate, как показывал я
2. Создали объект Zend_Log
3. Передали логгер, шаблон записываемого сообщения и включили механизм логгинга

Еще не забудьте про кеширование, это очень актуально:

<?php /** * Создали кешер */ $cache = Zend_Cache::factory('Core','File',$frontendOptions,$backendOptions); /** * Передали Zend_Translat'у */ Zend_Translate::setCache($cache); ?>

Все, с настройкой вроде бы разобрались. Переходим к использованию.

Использование

В моих разработках каждая отдельная часть системы (ядро, модуль, плагин) имеет свою папку с переводами, поэтому встает вопрос, как заставить Zend_Translate искать не в одной папке, а во всех ну или хотя бы как добавить файлы для загрузки переводов. Для этого существует функция addTranslation объекта Zend_Translate:

<?php /** * Получаем текущую локаль */ $locale = $translator->getLocale(); /** * Файл перевода */ $source = 'plugin_name/locale/'.$locale.'.mo'; /** * Передаем путь к файлу и локаль, к которой он относится */ $translator->addTranslation($source,$locale); ?>

Для перевода строк с помощью Gettext, я рекомендую Вам не использовать ключи, а полноценные строки. Для чего это нужно:

1. Gettext не разрешает дубляж переведенных строк, поэтому при использовании ключей Вам придется подумать, как избежать дубляжа, быть уверенным, что такой ключ нигде еще не используется
2. Если в исходном коде Вы решили поменять переводимую строку, то Вы сразу же увидите, что в файлах переводов есть неточные переводы (в третьей части об этом будет идти речь), а при использовании ключей – предыдущий вариант точно будет удален, а измененный ключ будет отмечен как непереведенный
3. Если перевода какой-то строки не окажется в файлах, то человек увидит нормальное сообщение (только не на нужном языке), а при использовании ключей – абсолютно неинформативный текст

Теперь покажу Вам пример перевода строки:

<?php $translator->_('GetText - мощный инструмент для локализации'); ?>

Нюансы с Zend_View

При использовании переведенных строк в шаблонах Zend_View и инструмента, о котором я расскажу Вам в следующей части, пользоваться встроенным помощником вида translate будет невозможно, потому, что программа не найдет строку, чтобы добавить ее в файл перевода. Все строки, которые будут переводится обязательно должны быть обрамлены таким кодом:

_('Строка для перевода')

Вот как я решил этот вопрос:

<?php // Zend_View $view->translator = $translator; // В шаблоне вида: echo $this->translator->_('Создать пользователя'); ?>

Итог

В данной статье мы с Вами рассмотрели процесс программной реализации локализации переводов. В следующей части я покажу Вам какими инструментами и самое главное как пользоваться для создания каталогов переводов, чтобы достичь максимальной гибкости и удобности в этом процессе.

Спасибо большое. Ждем продолжения. О переводе в Зенде много находил статтей, но только у вас все подробно и понятно.

Вместо прямого назначения транслятора

Zend_Validate_Abstract::setDefaultTranslator($translator);

Можно просто поместить в Zend_Registry объект Zend_Translate

Zend_Registry::set('Zend_Translate', Zend_Translate);

И валидаторы сами будут доставать его и использовать.

Хм... Не знал подобного решения, спасибо, возьму на вооружение. Какие еще компоненты будут брать Zend_Translate с Zend_Registry, не подскажите?

Ну например можно спокойно использовать таким образом Translate помощник Zend_View в скриптах вида.

<div> <?= $this->translate('my_message'); ?> </div>

Да я это знаю, но poEdit при таких раскладах не будет находить строки в скриптах вида, что очень плохо. Ему обязательно нужен такой формат:

_('my_message');

Добрый день!

Спасибо за обширный материал!

Столкнулся с одним затруднением:

<?php echo $this->translator->_('Test);?>

Вызывается только из layout.phtml.

В скриптах вида пишет:

Call to a member function _() on a non-object...

В бутстрапе имею след. код:

protected function _initViewHelpers()
    {

$view = new Zend_View();
        $view->translator = $translator;

...

}

Подскажите пожалуйста, что нужно подправить.

спасибо!

Вы создаете новый объект Zend_View... А Вы попробуйте "взять" Zend_View из Zend_Layout:

$view = Zend_Layout::getMvcInstance()->getView(); $view->translator = $translator;

Спасибо за скорый ответ!

Возможно у меня перегружен метод инициализации ViewHelper, т.к. не помогло :(

Если здесь более менее правильно, значит проблема в другом месте :/

        $view = new Zend_View();
        $view->setEncoding('UTF-8');
        $view->doctype('XHTML1_STRICT');
        $view->headTitle('GM');

$view->addHelperPath("Tinymce/View/Helper","Tinymce_View_Helper");

        $viewRenderer = new Zend_Controller_Action_Helper_ViewRenderer($view);
        $viewRenderer->setView($view);  Zend_Controller_Action_HelperBroker::addHelper($viewRenderer);
        Zend_Layout::startMvc(
            array(
                'layout' => 'layout',
                'layoutPath' => '/application/views/layouts',
                'pluginClass' => 'ZFBlog_Layout_Controller_Plugin_Layout'
            )
        );
        $view = Zend_Layout::getMvcInstance()->getView();
        $view->translator = $translator;       
        $this->bootstrap('layout');
        $layout=$this->getResource('layout');

Не знаю, не подскажу. У меня похожим методом работает, но извините, нету времени вникать болле глубоко в Вашу проблему

Ясно!

Но всёравно спасибо!

Проведите инициализацию переменной вида translator позже в коде и потестируйте работоспособность. Исходя из этого Вы сможете, я уверен, найти стройное решение вопроса.

Не смог сдержаться, чтобы все-таки не попробовать подсказать

Спешу поделиться решением которое подсказали добрые люди:

Внёс $translator в реестр. Помощник вызываю<?php echo $this->translate('Create');?>.

А для того, чтобы PoEdit понимал такую констркуцию, в закладке "ключевые слова" пишем translate

Всё замечательно работает.

Спасибо! Отлично. Видите, мои решения тоже бывают не совершенны

Это в очередной раз подтверждает, что вместе мы сила и можем дойти до офигенно стройного решения

имхо, лучше написать вью хелпер _
и шаблоне писать echo $this->_("текст")

имхо, лучше написать вью хелпер _
и шаблоне писать echo $this->_("текст")

С хелпером у меня возникли траблы, но если переопределить View (в моем случае это и так было сделано), то можно добавить метод:

public function _($messageid = null) { return $this->translate($messageid); }

тогда в шаблонах можно писать $this->_("текст")

Спасибо за интересный ход)))