Nelmio Api Doc / Swagger-PHP: маршрут не отображается в интерфейсе Swagger - PullRequest
0 голосов
/ 26 апреля 2019

Я пытаюсь с Nelmio Api Doc 3.4, который использует Swagger. Я только хочу создать собственный маршрут Api для действия в моем контроллере:

/**
     * @Operation(
     *     path="/product/{portal}/{code}",
     *     method="GET",
     *     tags={"Product Api"},
     *     summary="Returns a collection of products",
     *     @SWG\Response(
     *         response="200",
     *         description="Returned when successful",
     *         @SWG\Schema(
     *              type="array",
     *              @Model(type=AppBundle\Model\Api\ProductList::class)
     *         )
     *     ),
     *     @SWG\Parameter(
     *         name="portal",
     *         in="query",
     *         type="string",
     *         default="de",
     *         required=true,
     *         description="The portal"
     *     ),
     *     @SWG\Parameter(
     *         name="code",
     *         in="query",
     *         type="string",
     *         default="",
     *         format="\d+",
     *         required=true,
     *         description="The code"
     *     )
     * )
     *
     * @param Request $request
     * @return ProductList
     */
public function getProductByBookingCode(Portal $portal, string $code)
    {
        dump($portal);die;
    }

Но мой маршрут не отображается в моем API-интерфейсе, также нет тега. Но когда я пишу @Route("/product/{portal}/{code}", methods={"GET"}) поверх @Operation, отображается маршрут, но затем с параметрами 2 portal и 2 codes. Разве нельзя использовать форму path param @Operation, чтобы сделать мой маршрут видимым?

...