php swagger3 创建response公共模板并且可以重写复用

在Swagger 3中，您可以使用`@OA\Response()`注释来定义API的响应信息，并使用`response()`方法生成响应。如果您想要创建一个公共的响应模板以便于重用和覆盖，可以使用Swagger 3的组件功能来实现。

首先，您需要定义一个响应模板并将其存储在Swagger 3的组件中。下面是一个示例：

/**
 * @OA\Response(
 *     response="MyResponse",
 *     description="My custom response",
 *     @OA\JsonContent(
 *         type="object",
 *         @OA\Property(property="success", type="boolean"),
 *         @OA\Property(property="message", type="string")
 *     )
 * )
 */

// 将响应模板存储在Swagger 3的组件中
/**
 * @OA\Schema(
 *     schema="MyResponse",
 *     @OA\Property(property="success", type="boolean"),
 *     @OA\Property(property="message", type="string")
 * )
 */

在上面的示例中，我们定义了一个名为`MyResponse`的响应模板，并将其存储在Swagger 3的组件中。这个响应模板包括一个`success`属性和一个`message`属性，它们的类型分别为`boolean`和`string`。

接下来，您可以在API的响应中使用`MyResponse`模板。如果您想要覆盖这个模板，可以使用`@OA\Response()`注释的`$ref`参数来引用新的模板。下面是一个示例：

/**
 * @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\JsonContent(
 *             $ref="#/components/schemas/MyResponse"
 *         )
 *     )
 * )
 */

在上面的示例中，我们定义了一个`401`未授权响应，并使用`MyResponse`模板作为响应的内容。如果您想要覆盖这个模板，可以在覆盖的响应注释中使用`$ref`参数来引用新的模板。

需要注意的是，Swagger 3的组件功能还提供了其他一些功能，例如定义模型、参数、安全方案等。您可以查看Swagger 3官方文档以获取更详细的信息。