能否全局定义Security/Response配置，替代逐个端点重复配置？

不需要在每个端点上重复定义security和通用response信息，针对批量相同配置的接口，完全可以通过全局配置来减少重复代码。

一、全局配置安全验证（security） #

直接在项目的全局OpenApi注解中配置默认安全规则，所有接口会自动继承该配置：

/**
 * @OA\OpenApi(
 *     security={{"bearerAuth": {}}},
 *     // 其他全局配置信息
 * )
 */

如果某个接口不需要安全验证，只需在该接口的注解里添加security={}，即可覆盖全局规则。

二、全局复用通用响应（response） #

可以通过定义可复用响应组件的方式，避免每个接口重复写相同的响应配置：

1. 先全局定义响应组件 #

/**
 * @OA\Components(
 *     responses={
 *         "InvalidInput": {
 *             "response": 405,
 *             "description": "Invalid input"
 *         },
 *         "ServerError": {
 *             "response": 500,
 *             "description": "Server error"
 *         }
 *     }
 * )
 */

2. 接口中直接引用组件 #

class TestController extends Controller
{
    /**
     * @OA\Get(
     *     path="/api/test/{locale}/0",
     *     summary="Test",
     *     description="Test",
     *     tags={"Test"},
     *     operationId="Test",
     *     @OA\Parameter(
     *         name="locale",
     *         in="path",
     *         description="test",
     *         required=true,
     *     ),
     *     // 直接引用全局定义的响应组件
     *     @OA\Response(ref="#/components/responses/InvalidInput"),
     *     @OA\Response(ref="#/components/responses/ServerError")
     * )
     */
    public function test_func($locale, $country)
    { 
        // ...
    }
}

另外，如果你使用的是Laravel对应的Swagger包（比如darkaonline/l5-swagger），还可以在包的配置文件中直接设置全局默认响应，进一步简化配置。

内容的提问来源于stack exchange，提问作者AP87