一个简单的swagger-PHP的注释实例_米醋屋个人技术博客

swagger-php3.0对于新手还不是特别友好，然而2.0的文档又不全，这里我使用swagger写了一个简单的实例提供给大家参考。

建议：tags标签都写上

```
    /**
     * @OA\Post(path="/user",
     *   tags={"代用车"},
     *   summary="Create user",
     *   description="This can only be done by the logged in user.",
     *   operationId="createUser",
     *   @OA\RequestBody(
     *       required=true,
     *       description="Created user object",
     *       @OA\MediaType(
     *           mediaType="multipart/form-data",
     *           @OA\Schema(ref="#/components/schemas/test")
     *       )
     *   ),
     *   @OA\Response(response="default", description="successful operation")
     * )
     *
     *  @OA\Schema(
     *     schema="test",
     *     @OA\Property(property="vin",type="string",description="车架号",example=520),
     *     @OA\Property(property="sku_id",type="integer",description="商品SKU编码",example=22016),
     *     @OA\Property(property="goods_name",type="string",description="商品名称",example="商品名称747"),
     *     @OA\Property(property="brand_name",type="string",description="品牌-中文描述",example="品牌139"),
     *  ),
     */
```

展现效果如下：
[![](https://micuu.com/data/upload/20210625/60d54b7a91ed5.png)](https://micuu.com/data/upload/20210625/60d54b7a91ed5.png)

注:原创不易,转载请注明出处( https://micuu.com/new/1676.html )，本站所有资源来源于网络收集，如有侵权请联系QQ245557979进行清除。