swagger - 用于预定义示例的 Swagger-PHP 注释

Question

我正在使用 swagger-php 注释来生成我的 REST API 的文档，并且我想使用预定义的示例来描述响应。

下面的 YAML 代码有效：

components:
  examples:
    exampleUser:
      value:
        id: 1
        name:   "Alan Cool"
        email:  "joe@cool.com.br"
        password:   "string"
        status: "string"
        ultimo_acesso:  155850122
        cpf:    "string"
        rg: "string"
        cargo:  "string"
        grupo_id:   7
        empresa_id: 88
        thumbnail_id:   99
        loja_id:    1299

但是，当尝试通过注释生成上面的代码时，我无法让它工作。正在尝试：

/**
 * @OA\Examples(
 *    summary = "exampleUser",
 *    description = "exampleUser",
 *    value = "exampleUser"
 * )
 */

到目前为止，似乎还没有关于 PHP 注释的文档。有什么建议么？