## 版本说明
我们最后来聊聊最新版Swagger-php3.0的内容,最新版废除了一些参数,同时又新增了一些参数,我们以下面这段完整的post注释为例来说说:
```
/**
*
* @OA\SecurityScheme(type="apiKey",securityScheme="apikey",name="apikey")
* @OA\Post(
* tags={"教育模块"},
* path="/index/index/register",
* summary="注册接口",
* @OA\Parameter(name="firstname",in="query",@OA\Schema(type="integer"),description="firstname"),
* security={{"apikey"={}}},
* @OA\RequestBody(required=true,description="body",content={
* @OA\MediaType(mediaType="application/json",
* @OA\Schema(
* @OA\Property(
* property="username",
* type="string"
* ),
* @OA\Property(
* property="password",
* type="string"
* ),
* @OA\Property(
* property="sex",
* type="integer",
* example=0
* ),
* ))}
),
* @OA\Response(
* response=200,
* description="ok",
* )
* )
*/
```
> 属性 `in` 现在新增了值cookie,原先的值body,用 `@OA\RequestBody()`代替,同时JSON的结构也有所变化,` @OA\SecurityScheme()`参数type添加了值http、openIdConnect,删除了原来的`basic`
想体验最新版的小伙伴可以去Swagger-PHP官网去查看最新的更新内容