转储文档 [NelmioApiDocBundle] v3.0答案

【问题标题】：Dump Documentation [NelmioApiDocBundle] v3.0转储文档 [NelmioApiDocBundle] v3.0
【发布时间】：2020-06-03 13:24:19
【问题描述】：

我在我的 symfony 4 项目中使用 NelmioApiDocBundle (v3.0)，我想转储我的 Api 项目的文档。

我发现可以使用此命令处理旧版本的 NelmioApiDocBundle：

php bin/console api:swagger:dump destination_folder

但我收到了这个错误： “api:swagger”命名空间中没有定义命令

我不知道是否仍然可以使用新版本的 NelmioApiDocBundle 转储文档

【问题讨论】：

您要以哪种格式导出？版本 3 似乎还没有这个功能。有command previous code，如果真的需要，可以自己实现。
此功能在版本 4 中添加（参见 github.com/nelmio/NelmioApiDocBundle/blob/master/Command/…）为 nelmio:apidoc:dump，但在 3.x 中尚不可用。

标签： symfony documentation symfony4 openapi nelmioapidocbundle

【解决方案1】：

看到 NelmioApiDocBundle 让我几乎可以确定您正在使用 FOSRestBundle，如果您是，我会更改为 api-platform，您问为什么？首先，默认情况下，您会在 route /api 上获得 API 文档（无论是什么格式等，您总是会获得完整的文档），其次，即使您需要一些自定义功能，例如访问每个操作的属性甚至取决于角色更多here 我在 Symfony 5.0 上尝试过 FOSRestBundle，但它无法提供我想要的功能和配置，然后我发现了 API 平台。如果我错过了您想要的答案，请在评论中告诉我，我会尽我所能提供答案

【讨论】：

使用 FOSRestBundle 绝对不是使用 NelmioApiDocBundle 的必要条件。在我看来，ApiPlatform 并不适合所有人，例如它使得自定义 API 输出变得非常困难，所以我认为手动实现事物仍然有其优势。无论如何，这个问题根本与 ApiPlatform 无关；）