Блог веб-разработчика

Начинаю цикл статей по организации мультиязычности в Symfony. Мультиязычность достигается с помощью интернационализации и локализации.

Часть 1.1: интернационализация (I18n) — введение

Немного теории (источник Википедия).

Интернационализа́ция (англ. internationalization) — процесс адаптации продукта, такого как программное или аппаратное обеспечение, к языковым и культурным особенностям региона (регионов), отличного от того, в котором разрабатывался продукт. В английском языке для слова «internationalization» принято сокращение «i18n». При этом число 18 означает количество пропущенных между «i» и «n» букв.

Локализа́ция (англ. localization) — перевод и адаптация элементов интерфейса, вспомогательных файлов и документации. В английском языке для слова «localization» иногда применяется сокращение «l10n». При этом число 10 означает количество пропущенных между «l» и «n» букв.

Собственно хорошая поддержка интернационализации в Symfony на фоне других систем, а также многие другие возможности помогли мне остановиться на этом замечательном фреймворке :).

Хочу поделиться моим небольшим опытом и достигнутыми результатами упрощения организации работы с I18n в Symfony. Весь материал разбил на несколько частей.

Использовалась Symfony 1.1 и Propel 1.3.

Мои требования к интернационализации (I18n) для фреймворка:
1) Локализация интерфейса сайта
2) Интернационализации данных (новости, статьи, продукция,…)
3) Административная панель: редактирование локализации интерфейса
4) Административная панель: редактирование данных с учетом интернационализации
5) Простота использования, гибкость (возможность легко добавить новый язык), производительность
6) Работать с локализацией через БД (MySQL), в частности через PDO (Propel 1.3), используя открытый коннект к БД

Symfony практически «справляется» со всеми требованиями. Но для некоторых процессов пришлось кое-что изменить, доработать. Добился ли я выполнения поставленных задач? ДА!!!!!

По умолчанию доступен один язык, и его можно активировать через настройки: frontend/config/settings.yml

Листинг 1.1: настройка «культуры» по умолчанию

all:
  .settings:
    default_culture: ru_RU  # или uk_UA

Не забудьте сбросить кеш.

Формат записи (локали): uk_UA — язык и код страны.

Таким образом, мы говорим, какой профиль использовать для интернационализации.
Список всех профилей можно найти в ядре Symfony: /symfony-1.1/lib/i18n/data/

Теперь если использовать Helpers, которые работают с I18n (календарь, список стран, дата…) мы на выходе получим тексты не в английском языке по умолчанию, а в украинском.

Листинг 1.2: получение текущей «культуры»

$culture = $this->getUser()->getCulture();

 

Часть 1.2: организация итернационализации (I18n) контента в Symfony

Сначала расскажу, как организована интернационализация данных, а после вернемся к локализации интерфейса в других частях.

Вначале наши данные без поддержки I18n имеют следующий вид.

Листинг 1.3: схема таблицы «Статьи» (schema.yml)

propel:
  _attributes:          { package: lib.model.article }

  article:
    id:                 ~
    slug:               { type: varchar, size: 255, required: true }
    image_url:          { type: varchar, size: 255, required: true }
    title:              { type: varchar, size: 255, required: true }
    announce:           { type: text, required: true }
    full_text:          { type: text, required: true }
    created_at:         ~

Листинг 1.4: Маршрутизация (routing.yml):

article:
  url: /articles/:year/:month/:day/:slug
  param: { module: article, action: index }

Ссылка на статью имела бы следующий вид: http://tigor.com.ua/articles/2008/10/28/i18n_hello_world

Добавляем интернационализацию.

Листинг 1.4: Маршрутизация с поддержкой I18n (routing.yml)

article:
  url: /:sf_culture/articles/:year/:month/:day/:slug
  param: { module: article, action: index }
  requirements: { sf_culture: (?:ru|uk|en) }

Указываем к примеру 3-и языка: русский, украинский, английский. Если ввести что-то другое вместо языка, то страница будет не найдена, и получим код ошибки 404.

Теперь ссылка будет вот такая:
• http://tigor.com.ua/en/articles/2008/10/28/i18n_hello_world
• http://tigor.com.ua/ru/articles/2008/10/28/i18n_hello_world
• http://tigor.com.ua/uk/articles/2008/10/28/i18n_hello_world

Но контент все еще на одном языке. Делаем правки схемы.

Листинг 1.5: схема с поддержкой I18n (schema.yml)

propel:
  _attributes:          { package: lib.model.article }

  article:
    _attributes:        { phpName: Product, isI18N: true, i18nTable: article _i18n }
    id:                 ~
    slug:               { type: varchar, size: 255, required: true }
    image_url:          { type: varchar, size: 255, required: true }
    created_at:         ~

  article _i18n:
    id:                 { type: integer, required: true, primaryKey: true, foreignTable: article,
       foreignReference: id, onDelete: cascade, onUpdate: cascade }
    culture:            { isCulture: true, type: varchar, size: 7, required: true, primaryKey: true }
    title:              { type: varchar, size: 255, required: true }
    announce:           { type: text, required: true }
    full_text:          { type: text, required: true }

В Листинге 1.5 для таблицы article _i18n сознательно указаны id и culture, чтобы отобразить, что же Symfony вставляет при указании опции isI18N. Эти поля указывать не стоит, дабы не совершать ошибки. Но в исключительных это может понадобиться.

Листинг 1.6: Небольшие примеры работы с объектом Article

// Чтение данных
$article = ProductPeer::retrieveByPk(1);
$title = $article ->getTitle(); // По умолчанию испольщуется текущая культура, или переопределенная через машрутизацию
$title = $article ->getTitle(‘en’); // Явно указываем язык

// Изменение данных
$article = ProductPeer::retrieveByPk(1);
$article->setTitle(‘Мир во всем мире!’, ‘ru’);
$article->save();

Ссылки по теме:
• Symfony: интернационализация (I18n) / часть 2 – редактирование данных в административной панели
• Википедия: Интернационализация
• Википедия: Локализация
• Wikipedia: Internationalization_and_localization
• The Definitive Guide to symfony: Chapter 13 — I18n And L10n

Tags: I18n, Symfony