Question

我正在尝试使用Swagger的Nelmio Api Doc 3.4。我只想为控制器中的操作创建自定义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参数表格@Operation来显示我的路线？

Nelmio Api Doc / Swagger-PHP：路线未在Swagger用户界面中显示

0 个答案: