API 平台 - 实体翻译，Doctrine Translatable

Question

我正在尝试在我的 API 平台项目中的一个实体上添加 KnpLabs Doctrine Behaviors - 准确地说是 Translatable Behavior。

这是我到目前为止所做的：

    namespace App\Entity;

    use Doctrine\ORM\Mapping as ORM;
    use Knp\DoctrineBehaviors\Model as ORMBehaviors;
    use ApiPlatform\Core\Annotation\ApiResource;

    /**
    * @ORM\Entity(repositoryClass="App\Repository\ArticleRepository")
    * @ApiResource
    */
    class Article
    {
        use ORMBehaviors\Translatable\Translation,
            ORMBehaviors\Timestampable\Timestampable
        ;

        /**
        * @ORM\Id
        * @ORM\GeneratedValue
        * @ORM\Column(type="integer")
        */
        protected $id;

        /**
         * Get id
         *
         * @return int
         */
         public function getId()
         {
             return $this->id;
         }
    }

这是实体翻译：

    namespace App\Entity;

    use Doctrine\ORM\Mapping as ORM;
    use Knp\DoctrineBehaviors\Model as ORMBehaviors;
    use ApiPlatform\Core\Annotation\ApiResource;
    use App\Traits as CustomTraits;

    /**
     * @ORM\Entity(repositoryClass="App\Repository\ArticleTranslationRepository")
     * @ApiResource
     */
     class ArticleTranslation
     {
          use ORMBehaviors\Translatable\Translatable;

          /**
           * @var string
           * 
           * @ORM\Column(name="someFieldToTranslate", type="string", length=255, nullable=true)
           */
           private $someFieldToTranslate;

           public function getSomeFieldToTranslate(){...}
           public function setSomeFieldToTranslate($someFieldToTranslate){...}
     }

这是根据文档使可翻译行为工作的基本“配置”。

当我尝试更新数据库架构时出现问题：我收到此错误：

没有为实体“App\Entity\ArticleTranslation”指定标识符/主键。每个实体都必须有一个标识符/主键。 （从“/Sites/bookshop-api/config/routes/api_platform.yaml”导入）。确保有一个
支持“api_platform”类型的加载器。

然而，在 Translatable Traits 中，已经有一个 ID 和文档明确指出 Translation Entity 应该只包含我们想要翻译的字段...

无论如何，我已经为这个 ArtcleTranslation 实体添加了一个 ID 以消除错误：

    namespace App\Entity;

    use Doctrine\ORM\Mapping as ORM;
    use Knp\DoctrineBehaviors\Model as ORMBehaviors;
    use ApiPlatform\Core\Annotation\ApiResource;
    use App\Traits as CustomTraits;

    /**
     * @ORM\Entity(repositoryClass="App\Repository\ArticleTranslationRepository")
     * @ApiResource
     */
     class ArticleTranslation
     {
          use ORMBehaviors\Translatable\Translatable;

          /**
           * @ORM\Id
           * @ORM\GeneratedValue
           * @ORM\Column(type="integer")
           */
           protected $id;


          /**
           * @var string
           * 
           * @ORM\Column(name="content", type="string", length=255, nullable=true)
           */
           private $content;

           public function getContent(){...}
           public function setContent($someContent){...}
     }

从这里，当我更新数据库架构时没有错误。完美的 ！ 现在我可以看看 Swagger 文档：

一切看起来都很好！但是当我查看数据库时：

在文章表中：

• 没有“本地”字段
• 没有“空”字段

在文章翻译表中：

• 没有“translatable_id”字段
• 没有“currentLocal”
• 没有“defaultLocal”

我猜它必须是链接的，但在招摇的 POST 选项卡中，模型也不同。

article_translation 模型

我只在这两个实体上尝试了 /GET 和 /POST 方法，它们都在工作（我可以在 DB 中看到它），但它们之间没有任何关系。

我希望我的帖子不会太长，但我尽量说得更具体！

提前致谢

Answer 1

我做了另一个答案，因为第一个问题是解决一个错误，而不是解释我如何将 Knp Labs Doctrine Translations 与 Api Platform 集成。

总结：

我们有一个实体Article，它在ArticleTranslation 中翻译了一些字段。我们想通过 Api platform 检索实体及其翻译，并且我们想通过 api 添加或更新翻译。

我做了什么：

1 - Article 实体有一个 use ORMBehaviors\Translatable\Translatable。如果我们查看这个trait 的内部，它有两个属性：$translations 和$newTranslations。我们需要在Article 实体中公开这些属性：

class Article {
    use ORMBehaviors\Translatable\Translatable;

    protected $translations;
    protected $newTranslations;
}

现在我们有了一个新属性translations，当我们从api 获得一些Article 时，它会自动从ArticleTranslation 填充

2 - 现在我们要添加/编辑一些翻译：当我们发送到 api 时，我们需要在 Article 中填充 newTranslations 属性：

"newTranslations": {
    "en": {
      "description": "Firstname"
    },
    "fr": {
      "description": "Prénom"
    }
}

现在我们正在接收新的 api 翻译，但它没有持久化，因为我们必须调用函数 mergeNewTranslations()。这个函数只是获取属性$newTranslations中的所有翻译并将其与$translations属性合并以保持它。

3 - 我创建了一个新的trait，我称之为TranslatableOverride。我将它直接导入到ORMBehaviors\Translatable\Translation 旁边的我的实体上：

trait TranslatableOverride
{

    /**
     * Set collection of new translations.
     *
     * @return ArrayCollection
     */
    public function setNewTranslations($newTranslations)
    {
        if ($newTranslations) {
            foreach ($newTranslations as $locale => $translations) {
                foreach ($translations as $key => $value) {
                    $tr = $this->translate($locale);
                    $setter = 'set' . ucfirst($key);
                    if (method_exists($tr, $setter)) {
                        $tr->{$setter}($value);
                    }
                }
            }

            $this->mergeNewTranslations();
        }
    }
}

我不确定它是否漂亮，但它对api-platform 的作用就像一个魅力。

我没想过一次只翻译一份。目前，我用一大堆翻译来检索我的实体，这绝对不是有效的。我想我会在我的覆盖trait 中为getTranslations 添加一个覆盖。

Answer 2

我认为你做错了。你有一个实体Article，应该是translatable，你想翻译一些字段，这将是translations？

所以你应该做相反的事情，把use ORMBehaviors\Translatable\Translatable放在Article上，把use ORMBehaviors\Translatable\Translation放在ArticleTranslation上

Article 实体的修复：

namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;
use Knp\DoctrineBehaviors\Model as ORMBehaviors;
use ApiPlatform\Core\Annotation\ApiResource;

/**
* @ORM\Entity(repositoryClass="App\Repository\ArticleRepository")
* @ApiResource
*/
class Article
{
    use ORMBehaviors\Translatable\Translatable,
        ORMBehaviors\Timestampable\Timestampable
    ;

    /**
    * @ORM\Id
    * @ORM\GeneratedValue
    * @ORM\Column(type="integer")
    */
    protected $id;

    /**
     * Get id
     *
     * @return int
     */
     public function getId()
     {
         return $this->id;
     }
}

以及您的 ArticleTranslation 实体的修复：

    namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;
use Knp\DoctrineBehaviors\Model as ORMBehaviors;
use ApiPlatform\Core\Annotation\ApiResource;
use App\Traits as CustomTraits;

/**
 * @ORM\Entity(repositoryClass="App\Repository\ArticleTranslationRepository")
 * @ApiResource
 */
 class ArticleTranslation
 {
      use ORMBehaviors\Translatable\Translation;

      /**
       * @var string
       * 
       * @ORM\Column(name="someFieldToTranslate", type="string", length=255, nullable=true)
       */
       private $someFieldToTranslate;

       public function getSomeFieldToTranslate(){...}
       public function setSomeFieldToTranslate($someFieldToTranslate){...}
 }

如果一切正常，请告诉我。