php swagger3 封装并使用response

在Swagger 3中，可以使用`@OA\Response()`注释来定义API的响应信息。下面是一个使用`@OA\Response()`注释定义API响应的示例：

/**
 * @OA\Get(
 *     path="/users",
 *     summary="Get all users",
 *     @OA\Response(
 *         response="200",
 *         description="Successful operation",
 *         @OA\JsonContent(
 *             type="array",
 *             @OA\Items(ref="#/components/schemas/User")
 *         )
 *     ),
 *     @OA\Response(
 *         response="401",
 *         description="Unauthorized",
 *     )
 * )
 */

在上面的示例中，我们使用`@OA\Response()`注释定义了两个响应：一个是成功响应`200`，另一个是未授权响应`401`。对于成功响应，我们定义了一个`@OA\JsonContent()`注释，它指定了响应的内容类型和响应的数据模型。在这个例子中，我们使用了一个引用到`#/components/schemas/User`的`@OA\Items()`注释，这个引用定义了响应的数据模型。

为了在代码中使用响应，您可以使用`response()`方法来生成响应。下面是一个使用`response()`方法生成响应的示例：

public function getUsers()
{
    $users = User::all();
    if ($users) {
        return response()->json($users);
    } else {
        return response()->json(['message' => 'No users found'], 404);
    }
}

在上面的示例中，我们使用`response()`方法根据查询结果生成不同的响应。如果查询返回结果，则我们返回成功响应`200`，并使用`json()`方法将结果序列化为JSON格式。否则，我们返回`404`未找到响应，并使用`json()`方法将错误消息序列化为JSON格式。

需要注意的是，Swagger 3中的响应注释和响应生成方法都支持更多的选项和参数。您可以查看Swagger 3官方文档以获取更详细的信息。