1

大家好，我试图消除在生成 swagger.json 时仍然存在的这个错误，错误说：

[警告] [语法错误] 预期值，在 \App\Http\Controllers 中得到“@”...在我的代码中，OHH iM WORKING WITH LUMEN。

/**
 * @SWG\Put(
 *   path="/v1/resource/{id1}/rsc/{id2}",
 *   summary="Update ...",
 *   operationId="update",
 *   tags={"Update"},  
 *
 *
 *   @SWG\Response(response=200, description="Json [client] "),
 *   @SWG\Response(response=404, description="Recurso no encontrado"),
 *   @SWG\Response(response=500, description="[error] Error interno del servidor"),
 *   @SWG\Parameter(
 *     name="id1",
 *     in="path",
 *     description="Id1.",
 *     required=true,
 *     type="integer"
 *   ),
 *   @SWG\Parameter(
 *     name="id2",
 *     in="path",
 *     description="Id2",
 *     required=true,
 *     type="integer"
 *   ),
 *   @SWG\Parameter(
 *     name="JSON update body",
 *     in="body",
 *     description="Request.",
 *     required=true,
 *     @SWG\Schema(type="array",@Model(type=vendor\LibModel\DAO\src\Model\Hospital))
 *   )
 *  )
 */
 public function update($id1,$id2, Request $request){...}

当我检查 json 不生成定义 - >“定义”：{}。我的模型以下列方式定义它，我不知道问题是否在于我的模型位于不同的命名空间下，因为它被定义为供应商或我缺少的声明性内容：

/**
 * Class Hospital
 *
 *
 * @SWG\Definition(
 *   definition="Hospital"
 * )
 *
 */
class Hospital extends Model
{

    /**
     * @SWG\Property(format="string")
     * @var string
     */
    protected $name;

    /**
     * @SWG\Property(format="string")
     * @var string
     */
    protected $email;

..在我看来，swagger m 出现了一个错误...我认为这是因为它没有加载模型的值，这要感谢谁能帮助我

4

1 回答 1

0

教义解析器抱怨@Model哪个不是swagger-php 的一部分。

swagger-php 表示法是：

 * @SWG\Parameter(
 *     name="JSON update body",
 *     in="body",
 *     description="Request.",
 *     required=true,
 *     @SWG\Schema(
 *         type="array",
 *         @SWG\Items(ref="#/definitions/Hospital")
 *     )
 * )

我不想使用NelmioApiDocBundle（它使用该@Model注释）检查他们的指南以了解如何设置它。

于 2018-04-12T22:10:42.897 回答