open api

 * @OA\Get(path="/my-type",
 *   tags={"MyType"},
 *   operationId="getCampaignTypes",
 *   summary="Список всех типов ",
 *   @OA\Parameter(name="is_active",
 *     in="query",
 *     required=false,
 *     description="Активность записи. Если не указать, будут выгружены все.",
 *     @OA\Schema(type="boolean")
 *   ),
 *   @OA\Response(
 *		response="200",
 *      description="OK",
 *      @OA\MediaType(
 *          mediaType="application/json",
 *          @OA\Schema(
 *              type="array",
 *              @OA\Items(
 *                  type="object",

Например для zircote/swagger-php:

JsonParseException: Unrecognized token 'openapi'

В ответ на команду:

java -jar swagger-codegen-cli.jar generate -i /var/www/myproject/openapi.yaml -l  php

При этом файл (openapi.yaml), который генератор должен парсить выглядит так:

openapi: 3.0.0
info:
  title: 'API'
  version: 1.0.0
paths:
  /v1/api/campaign-types:
    get:
      operationId: getUserByName
      responses:
        '200':
          description: 'Список типов компаний'

Решение

Ошибка вида:

An exception has been thrown during the rendering of a template [Semantical Error] The annotation ... in class ... was never imported. Did you maybe forget to add a use statement for this annotation? in .... (which is being imported from .../config/routes/annotations.yaml). Make sure annotations are installed and enabled)

Решение

В качестве решения можно использовать в любом стартовом файле проекта ( в symfony 4 можно использовать config/bootstrap.php) код, вида: