OpenApi 3.0 + swagger-php：PHP属性全局安全配置正确语法

针对你使用PHP属性生成OpenAPI YAML时的全局BearerAuth安全配置问题，以下是对应security: - BearerAuth: []的正确PHP属性写法（以主流的zircote/swagger-php库为例）：

use OpenApi\Attributes as OA;

// 全局OpenAPI配置属性，通常加在配置类或入口控制器上
#[OA\OpenApi(
    security: [
        ['BearerAuth' => []]
    ]
)]
class GlobalApiConfig
{
    // 你的接口定义或配置逻辑
}

关键说明： #

• 这里的security参数是二维数组：外层数组对应YAML中的列表项（-），内层关联数组['BearerAuth' => []]对应YAML里的BearerAuth: []，完全匹配手动编写的YAML结构。
• 常见错误原因是数组结构不匹配，比如直接写['BearerAuth']或括号嵌套错误，导致生成的YAML语法不符合OpenAPI规范。

这个写法会自动生成你需要的全局security配置，无需手动修改YAML文件。

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