README

翻译

翻译 CRUD

实体应如下所示：实现 TranslatableEntityInterface 并定义方法 getTranslatableFields。可以使用 PrivateDev\Utils\Entity\TranslationEntityTrait 来添加字段 $translation。之后，在使用 PrivateDev\Utils\Controller\CRUD(L)Controller 时，所有翻译都将保存在关联的实体 PrivateDev\Utils\Entity\Translation 中。

namespace PageBundle\Entity;


use PrivateDev\Utils\Entity\TranslatableEntityInterface;
use PrivateDev\Utils\Entity\Translation;
use Doctrine\ORM\Mapping as ORM;
use PrivateDev\Utils\Entity\EnableEntityTrait;
use PrivateDev\Utils\Entity\TimestampEntityTrait;
use PrivateDev\Utils\Entity\TranslationEntityTrait;
use Swagger\Annotations\Definition;
use Swagger\Annotations\Property;

/**
 * @Definition()
 *
 * @ORM\Table(name="pages")
 * @ORM\Entity(repositoryClass="PageBundle\Repository\PageRepository")
 * @ORM\HasLifecycleCallbacks()
 */
class Page implements TranslatableEntityInterface
{
    use TimestampEntityTrait;
    use EnableEntityTrait;
    use TranslationEntityTrait;

    public function getTranslatableFields()
    {
        return ['title'];
    }
    
    /**
     * 
     * @var string
     *
     * @Property()
     *
     */
    private $title;   // не должна быть @ORM\Column все переводы сохраняются для локали в Translation
    
    /**
     * Set title
     *
     * @param string $title
     *
     * @return Page
     */
    public function setTitle($title, $language = null)
    {
        if ($language) {
            //метод в TranslationEntityTrait устанавливает перевод для поля вTranslation
            $this->setTranslationForField('title', $title, $language);    
        } else {
            $this->title = $title;
        }

        return $this;
    }

    /**
     * Get title
     *
     * @param null $language
     *
     * @return string
     */
    public function getTitle($language = null)
    {
        if ($language) {
            //метод в TranslationEntityTrait достает перевод для поля из Translation
            $title = $this->getTranslationForField('title', $language);
        } else {
            $title = $this->title;
        }

        return $title;
    }
    
}

翻译转换器

对于转换器，需要实现 TranslatableTransformerInterface，然后在使用 PrivateDev\Utils\JsonøTransformableJsonResponseBuilder 时，当前语言将被设置到转换器中。可以使用 PrivateDev\Utils\Fractal\TranslatableTransformerTrait 来定义 $language 及其访问器。

    <?php
    
    namespace PageBundle\Transformer;
    
    use PageBundle\Entity\Page;
    use PrivateDev\Utils\Fractal\TransformerAbstract;
    use PrivateDev\Utils\Fractal\TranslatableTransformerInterface;
    use PrivateDev\Utils\Fractal\TranslatableTransformerTrait;
    
    class PageTransformer extends TransformerAbstract implements TranslatableTransformerInterface
    {
        use TranslatableTransformerTrait;
    
        /**
         * @param Page $page
         *
         * @return array
         */
        public function transform($page) : array
        {
            return [
                'id'        => $page->getId(),
                // передаем текущий язык в нужный метод
                'title'     => $page->getTitle($this->getLanguage())
            ];
        }
    
        /**
         * @return string
         */
        public function getResourceKey() : string
        {
            return 'page';
        }
    }