Rest 在nelmio api文档上覆盖@param doc

我有一个REST控制器，使用ParamConverter Symfony的服务，使用nelmio api文档注释：

<?php

    /**
     * @param Plan $plan The plan id
     *
     * @ApiDoc(
     *  description="Returns plan details",
     *  output={
     *      "class"="AppBundle\Entity\Plan",
     *      "groups"={"details"}
     *  }
     * )
     *
     * @return Response
     */
    public function getAction(Plan $plan) // [...]

但现在它向我展示了两个参数：

从api文档中重写或删除

@param

标记的最佳方法是什么？当然没有从评论文档中删除它

---

谢谢你的帮助

奇怪的是，提到这个问题：你不应该有这种行为，你使用哪个版本？最新的dev master checkout。它有点旧，但两个变量名必须相同，要么是plan，要么是plan\id。

<?php

    /**
     * @param Plan $plan The plan id
     *
     * @ApiDoc(
     *  description="Returns plan details",
     *  requirements={
     *      {
     *          "name"="plan_id",
     *          "dataType"="integer",
     *          "requirement"="\d+",
     *          "description"="The plan's id"
     *      }
     *  },
     *  output={
     *      "class"="AppBundle\Entity\Plan",
     *      "groups"={"details"}
     *  }
     * )
     *
     * @return Response
     */
    public function getAction(Plan $plan) // [...]