NelmioApiDocBundle 对 swagger 2.0 的支持

Posted

技术标签:

【中文标题】NelmioApiDocBundle 对 swagger 2.0 的支持【英文标题】:NelmioApiDocBundle Support for swagger 2.0 【发布时间】:2017-05-19 20:53:59 【问题描述】:

我使用 NelmioApiDocBundle v2.13.0 处理 symfony 2 项目,该项目转储基于 Swagger 1.2 的 Swagger 兼容 JSON API 定义 女巫是旧版本。 我搜索了很多关于 Swagger 2.0 的 NelmioApiDocBundle 支持,但没有任何好的回应。 这些是我找到的链接:

twitter 1 twitter 2 gitlab

我想知道 NelmioApiDocBundle 是否支持 Swagger 2.0。以及是否有另一个捆绑包可以替换此捆绑包。

【问题讨论】:

【参考方案1】:

从这个link我发现:

我之前曾使用 NelmioApiDocBundle 将 Swagger 与 一个 Symfony 应用程序,它是一个很好的工具来记录你的 现有的 API 代码。但是随着 NelmioApiDocBundle 生成 Swagger 来自带注释的源代码的文件 源必须在 文档。这与我们想要的工作流程不符。更重要的是, NelmioApiDocBundle 的未来似乎有点不确定,因为 当前的维护者威廉·杜兰德(William Durand)考虑弃用 捆绑。

威廉·杜兰德 说:

我正在考虑慢慢弃用#NelmioApiDocBundle (先冻结功能,然后 EOL)。

twit

【讨论】:

以上是关于NelmioApiDocBundle 对 swagger 2.0 的支持的主要内容,如果未能解决你的问题,请参考以下文章

NelmioApiDocBundle 负 path_patterns

Symfony 4.4 / NelmioApiDocBundle 4.0.1 注释问题

如何从 NelmioApiDocBundle 生成的文档中删除 _format URL 后缀?

NelmioApiDocBundle 不起作用“规范中没有定义操作!”

Symfony NelmioApiDocBundle swagger-ui PHP Annotations json对象,对象属性数组未显示

go swag报错,原因:go1.18下载语句出错导致swag未下载