Swagger- PHP OpenAPI вложенный маршрут - PullRequest
Новая
       6

Swagger- PHP OpenAPI вложенный маршрут

3 голосов
/ 09 марта 2020

Контроллер 

use OpenApi\Annotations as OA;

class ApiPersonController
{
    /**
     * @OA\Post(
     *     path="/add",
     *     responses={
     *          @OA\Response(
     *              response=202,
     *              description="Request has been accepted and is being processed"
     *          )
     *     }
     * )
     */
    public function add()
    {

    }
}

Что я должен добавить к комментарию do c ApiPersonController, чтобы чванство. json генерировалось Zircote / Swagger - PHP дает этот вывод? 

openapi: 3.0.0
info:
  title: 'My API'
  version: 1.1.0
paths:
  /person/add:
    post:
      operationId: 'ApiPersonController::add'
      responses:
        '202':
          description: 'Request has been accepted and is being processed'

В частности, как мне получить все маршруты внутри ApiPersonController, чтобы к ним добавлялся /person без указания /person внутри каждого маршрута

Я ищу что-то вроде следующего, но это просто добавляет /person и /add отдельно к моему чванству. json

use OpenApi\Annotations as OA;

/**
 * @OA\PathInfo(path="/person")
 **/
class ApiPersonController
{
    ...
...