php 的 OpenApi 无法正确呈现枚举值

Question

我正在使用 OpenApi 和 Swagger 构建一些文档，但由于 js 错误我无法对其进行测试。

我想定义一个接受特定值的参数，所以我在 schema 属性中添加了 enum。我在这样的 GET 请求中定义 orderBy 参数

*     @OA\Parameter(in="query", name="orderBy", required=false, allowEmptyValue=true, description="Sort type of results", examples={"asc", "desc"}, schema={"type": "string", "enum": {"asc", "desc"}, "default": "asc"})

生成文档时出现以下错误

开发者工具

Answer 1

删除了 examples 属性并正确呈现。

*     @OA\Parameter(in="query", name="orderBy", required=false, allowEmptyValue=true, description="Sort type of results", examples={"asc", "desc"}, schema={"type": "string", "enum": {"asc", "desc"}, "default": "asc"})

php 的 OpenApi 无法正确呈现枚举值

OpenApi for php doesn't render enum values correctly

php

swagger-ui

openapi