php重构swagger3,php-swagger 3.0版本

@OA\Get()

/**

* @OA\Get(path="/user/logout",

* tags={"user"},

* summary="Logs out current logged in user session",

* description="",

* operationId="logoutUser",

* parameters={},

* @OA\Response(response="default", description="successful operation")

* )

*/

@OA\Post()

/**

* @OA\Post(path="/user",

* tags={"user"},

* 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/User")

* )

* ),

* @OA\Response(response="default", description="successful operation")

* )

*/

@OA\Put()

/**

* @OA\Put(path="/user/{username}",

* tags={"user"},

* summary="Updated user",

* description="This can only be done by the logged in user.",

* operationId="updateUser",

* @OA\Parameter(

* name="username",

* in="path",

* description="name that need to be updated",

* required=true,

* @OA\Schema(

* type="string"

* )

* ),

* @OA\Response(response=400, description="Invalid user supplied"),

* @OA\Response(response=404, description="User not found"),

* @OA\RequestBody(

* required=true,

* description="Updated user object",

* @OA\MediaType(

* mediaType="multipart/form-data",

* @OA\Schema(ref="#/components/schemas/User")

* )

* ),

* )

*/

@OA\Delete()

/**

* @OA\Delete(path="/user/{username}",

* tags={"user"},

* summary="Delete user",

* description="This can only be done by the logged in user.",

* operationId="deleteUser",

* @OA\Parameter(

* name="username",

* in="path",

* description="The name that needs to be deleted",

* required=true,

* @OA\Schema(

* type="string"

* )

* ),

* @OA\Response(response=400, description="Invalid username supplied"),

* @OA\Response(response=404, description="User not found")

* )

*/