php - Swagger Doctrine/zircote持有者授权码

Question

我正在尝试使用 swagger zircote 创建 swagger ui json。对于我的应用程序，我使用 JWT，并且我需要在 json 中包含以下 swagger 代码:

"securityDefinitions": {
    "Bearer": {
      "in": "header",
      "type": "accessToken",
      "name": "Authorization"
    }
},

但我不知道如何使用 swaggers zircote 创建该代码。我尝试过以下代码:

 * @SWG\Swagger(
 *     schemes={"https"},
 *     @SWG\SecurityDefinitions(
 *         bearer={
 *             type="apiKey",
 *             name="Authorization",
 *             in="header"
 *         }
 *     ),

但这会导致以下错误:

The annotation "@Swagger\Annotations\SecurityDefinitions" in .\index.php on line 2 does not exist, or could not be auto-loaded.

有人可以帮助我，我找不到任何关于此的好的文档，也许它很具体，但我希望有人可以帮助我。

谢谢!

也在 github 上发布了这个... https://github.com/zircote/swagger-php/issues/366

Answer 1

使用@SWG\SecurityScheme而不是@SWG\SecurityDefinitions。

 * @SWG\Swagger(
 *     schemes={"https"},
 *     @SWG\SecurityScheme(
 *         securityDefinition="Bearer",
 *         type="apiKey",
 *         name="Authorization",
 *         in="header"
 *     ),

可用注释的列表可以在 vendor/zircote/swagger-php/src/Annotations 中找到。