【问题标题】:SWAGGER-PHP error when generating .json I can not load the values from my model生成 .json 时出现 SWAGGER-PHP 错误我无法从我的模型中加载值
【发布时间】:2018-03-14 20:16:47
【问题描述】:

大家好,我尝试消除在生成 swagger.json 时仍然存在的此错误,错误提示:

[WARN] [语法错误] 期望值,得到 '@' in \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 出现了一个错误......我认为这是因为它没有加载模型的值,感谢谁能帮助我

【问题讨论】:

    标签: swagger swagger-ui swagger-php


    【解决方案1】:

    原则解析器抱怨@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 注释)查看他们的指南以了解如何设置。

    【讨论】:

      猜你喜欢
      • 2019-11-25
      • 2016-11-24
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 2016-02-16
      • 2022-06-21
      • 1970-01-01
      • 1970-01-01
      相关资源
      最近更新 更多