swagger-php - Swagger PHP 安全架构引用不佳

Question

我正在使用这个 SecuritySchema 来定义 JWT 安全验证：

/*
     * @SWG\SecurityScheme(
     *   securityDefinition="JWT",
     *   type="apiKey",
     *   in="header",
     *   name="Authenticate"
     * ) */

并将其引用为：

/*
 * @SWG\Post(path="/ap/some/method",
 *   security={"JWT"={}},
 * )

并且规范说我应该参考

{
...
"security":["JWT":[]]
...
}

但事实是 Swagger-PHP 生成：

{
...
"security":{"JWT":[]}
...
}

在 Swagger UI 上显示为验证错误。

问题是： 如何模拟所需的输出以避免 Swagger UI 和 Swagger PHP 警告/错误？

Answer 1

security":["JWT":[]]不是有效的 json，但规范确实需要安全属性的数组。

所需的输出是：

"security":[{"JWT":[]}]

可以通过以下方式生成：

security={{"JWT":{}}}

（注意额外的括号）