doctrine-orm - Api-Platform + Swagger：通过 Doctrine 或 ApiPlatform 映射对操作/实体进行分组

Question

我有config/packages/api_platform.yaml：

api_platform:
    mapping:
        paths: 
            - '%kernel.project_dir%/src/Entity'
            - '%kernel.project_dir%/old/Entity'

在这两个名称空间中，我都有同名的实体。我必须做什么才能将它们/docs分组显示为不同的映射，而不是仅按实体类名称显示。

如何为每个命名空间配置“全局”前缀？

Answer 1

API 平台现在不提供此配置，您将不得不OpenApiFactory像这样装饰

大摇大摆的文档按他们的tags

<?php
// src/OpenApi/OpenApiFactory.php

namespace App\OpenApi;

use ApiPlatform\Core\OpenApi\Factory\OpenApiFactoryInterface;
use ApiPlatform\Core\OpenApi\OpenApi;
use ApiPlatform\Core\OpenApi\Model;

final class OpenApiFactory implements OpenApiFactoryInterface
{
    private $decorated;

    public function __construct(OpenApiFactoryInterface $decorated)
    {
        $this->decorated = $decorated;
    }

    public function __invoke(array $context = []): OpenApi
    {
        $openApi = $this->decorated->__invoke($context);

        $paths = $openApi->getPaths()->getPaths();

        $filteredPaths = new Model\Paths();
        foreach ($paths as $path => $pathItem) {
            // Here you can check the tags for each Operations
            // Add custom logic with the snippet below
        }

        return $openApi->withPaths($filteredPaths);
    }
}

脏的部分来了，标签将是EntityName而不是完整的命名空间名称我会列出所有旧实体，过滤当前标签并更改为旧的或新的（下面是伪代码）

$OldEntityList = ['entity1', 'entity2', ...]
foreach ($Operations as $op) {
  if (in_array($op->getTags(), $OldEntityList) {
     $op->withTags('old');
  } else {
     $op->withTags('new');
  }
}