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 warnings/errors？

Answer 1

security":["JWT":[]] 无效 json，但规范确实需要一个安全数组属性。

期望的输出是：

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

可以通过以下方式生成：

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

（注意额外的括号）

Swagger PHP 安全架构引用不当

Swagger PHP Security Schema referenced poorly

swagger-php