Symfony 2. Мультиязычность контента

Недавно передо мной стояла задача сделать мультиязычность контента у сайта, написанного с использованием фреймворка symfony 2. Из мануалов было ясно, что встроенная мультиязычность подходит только для перевода интерфейсов. Мне нужна возможность определения у каких полей сущностей будет перевод, а у каких не будет перевода.

Нашел библиотеку Doctrine2 Behaviors от KnpLabs. В документации есть инструкция по использованию с анотациями. Но у меня сущности описываются в yml файлах. С yml файлами, как оказалось тоже все работает, главное — правильно описать.

Установить Doctrine2 Behaviors можно следующей командой:



composer require knplabs/doctrine-behaviors:~1.1

composer require knplabs/doctrine-behaviors:~1.1

После установки нужно подключить бандл в файле app/AppKernel.php



class AppKernel
{
    function registerBundles()
    {
        $bundles = array(
            //...
            new Knp\DoctrineBehaviors\Bundle\DoctrineBehaviorsBundle(),
            //...
        );

        //...

        return $bundles;
    }
}

class AppKernel

{

function registerBundles()

{

$bundles = array(

//...

new Knp\DoctrineBehaviors\Bundle\DoctrineBehaviorsBundle(),

//...

);

//...

return $bundles;

}

И импортировать сервисы в файле app/config/config.yml



# app/config/config.yml
    imports:
        - { resource: ../../vendor/knplabs/doctrine-behaviors/config/orm-services.yml }

# app/config/config.yml

imports:

- { resource: ../../vendor/knplabs/doctrine-behaviors/config/orm-services.yml }

Установка завершена. Можно приступать к работе с библиотекой.

Создадим сущность Page. Для этого нам понадобится файл Page.yml



AppBundle\Entity\Page:
    type: entity
    table: Page
    repositoryClass: AppBundle\Entity\Repository\PageRepository
    id:
        id:
            type: integer
            id: true
            generator:
                strategy: AUTO
    fields:
        title:
            type: string
            length: 255
        text:
            type: text
    lifecycleCallbacks: {  }

AppBundle\Entity\Page:

type: entity

table: Page

repositoryClass: AppBundle\Entity\Repository\PageRepository

id:

type: integer

id: true

generator:

strategy: AUTO

fields:

title:

type: string

length: 255

text:

type: text

lifecycleCallbacks: { }

Сущность с переводом всегда называется также как и оригинальная сущность, только с суффиксом Translation. В нашем случае это будет PageTranslation. Создадим для нее файл PageTranslation.yml



AppBundle\Entity\PageTranslation:
    type: entity
    table: PageTranslation
    fields:
        title:
            type: string
            length: 255
            nullable: true
        text:
            type: text
            nullable: true
    lifecycleCallbacks: {  }

AppBundle\Entity\PageTranslation:

type: entity

table: PageTranslation

fields:

title:

type: string

length: 255

nullable: true

text:

type: text

nullable: true

lifecycleCallbacks: { }

Далее выполним в консоли команду для генерации классов сущностей:



php app/console doctrine:generate:entities AppBundle

php app/console doctrine:generate:entities AppBundle

И команду для создания таблиц в базе данных:



php app/console doctrine:schema:update --force

php app/console doctrine:schema:update --force

Теперь нужно внести изменения в файлы классов. В файл Page.php добавим следующие строки:



<?php

namespace AppBundle\Entity;

use Doctrine\ORM\Mapping as ORM;
use Knp\DoctrineBehaviors\Model as ORMBehaviors;

class Page
{
    use ORMBehaviors\Translatable\Translatable;

    /**
     * @ORM\Column(type="string", length=255)
     */

    protected $someFieldYouDoNotNeedToTranslate;

<?php

namespace AppBundle\Entity;

use Doctrine\ORM\Mapping as ORM;

use Knp\DoctrineBehaviors\Model as ORMBehaviors;

class Page

{

use ORMBehaviors\Translatable\Translatable;

/**

* @ORM\Column(type="string", length=255)

protected $someFieldYouDoNotNeedToTranslate;

В класс PageTranslation добавим следующие строки:



<?php

namespace AppBundle\Entity;

use Doctrine\ORM\Mapping as ORM;
use Knp\DoctrineBehaviors\Model as ORMBehaviors;

class PageTranslation
{
    use ORMBehaviors\Translatable\Translation;

<?php

namespace AppBundle\Entity;

use Doctrine\ORM\Mapping as ORM;

use Knp\DoctrineBehaviors\Model as ORMBehaviors;

class PageTranslation

{

use ORMBehaviors\Translatable\Translation;

Теперь создание страницы с переводами на английском и французском языках будет выглядеть так:



<?php

  $page = new Page();

  $page->setTitle('Заголовок на русском языке');
  $page->setText('Текст на русском языке');

  $page->translate('en')->setTitle('Заголовок на английском языке');
  $page->translate('fr')->setTitle('Заголовок на французском языке');

  $page->translate('en')->setText('Текст на английском языке');

  $em = $this->get('doctrine.orm.entity_manager');
  $em->persist($page);

  // Метод mergeNewTranslations() нужно вызывать до метода flush()
  $page->mergeNewTranslations();

  $em->flush();

<?php

$page = new Page();

$page->setTitle('Заголовок на русском языке');

$page->setText('Текст на русском языке');

$page->translate('en')->setTitle('Заголовок на английском языке');

$page->translate('fr')->setTitle('Заголовок на французском языке');

$page->translate('en')->setText('Текст на английском языке');

$em = $this->get('doctrine.orm.entity_manager');

$em->persist($page);

// Метод mergeNewTranslations() нужно вызывать до метода flush()

$page->mergeNewTranslations();

$em->flush();

Получение перевода осуществляется тоже через метод translate()



<?php

  $id = 1;

  $page = $this->getDoctrine()
            ->getRepository('ContentBundle:Page')
            ->find($id);

  $title_ru = $page->getTitle();
  $title_en = $page->translate('en')->getTitle();
  $title_fr = $page->translate('fr')->getTitle();

<?php

$id = 1;

$page = $this->getDoctrine()

->getRepository('ContentBundle:Page')

->find($id);

$title_ru = $page->getTitle();

$title_en = $page->translate('en')->getTitle();

$title_fr = $page->translate('fr')->getTitle();

Данный способ переводов проверен на версиях symfony 2.6 и symfony 2.7

Спасибо за внимание.

Добавить комментарий Отменить ответ