Swagger PHP 安全架构引用不佳答案

【问题标题】：Swagger PHP Security Schema referenced poorlySwagger PHP 安全架构引用不佳
【发布时间】：2017-06-27 14:16:06
【问题描述】：

我正在使用此 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 警告/错误？

【问题讨论】：

标签： swagger-php

【解决方案1】：

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

想要的输出是：

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

可以通过以下方式生成：

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

（注意额外的括号）

【讨论】：

非常感谢，成功了！