如何在Swagger中为GET请求生成模型/示例值部分

如何在Swagger中为GET请求生成模型/示例值部分,swagger,swagger-php,Swagger,Swagger Php,我关心的是如何使用Swagger为我的GET请求生成模型/示例值部分。 官方的例子完美地展示了这一部分 在正式文档中,它是使用现有模型生成的: * @SWG\Schema(ref="#/definitions/User") 我没有这样的选项,因为我的属性是由REST生成的 我试过以下方法: /** * @SWG\Get( ... * @SWG\Response( * response="200", * description="

我关心的是如何使用Swagger为我的GET请求生成模型/示例值部分。 官方的例子完美地展示了这一部分

在正式文档中,它是使用现有模型生成的:

     *     @SWG\Schema(ref="#/definitions/User")
我没有这样的选项,因为我的属性是由REST生成的

我试过以下方法:

/**
 * @SWG\Get(
...
 *     @SWG\Response(
 *         response="200",
 *         description="Ok",
 *         @SWG\Schema(
 *             type="array",
 *             @SWG\Property(property="firstname", type="string", example="Steven")
 *         ),
 *     ),
 * )
 */
它不起作用,并回答:

获取资源列表:http://localhost/dist/swagger.json; 请稍候。


非常感谢您的帮助。提前感谢。

示例之一中生成了
GET/pet/findByStatus

代码段无法工作的原因是您正在向
数组
类型添加属性,这是不受支持的

要描述数组的内容,您需要
@SWG\Items
注释:

...
 *         @SWG\Schema(
 *             type="array",
 *             @SWG\Items(
 *                 type="object",
 *                 @SWG\Property(property="firstname", type="string", example="Steven")
 *             )
 *         ),
...

谢谢你的回答。虽然成功了,但没有项目,只需将类型从数组更改为对象即可。