Question

我的Web应用程序不基于Symfony或任何其他开源框架。

如何仍然使用nelmio / api-doc-bundle包从类注释生成API文档？

Answer 1

nelmio-api-doc捆绑包仅是symfony平台，因此没有symfony不能使用它。

如果您只想使用API文档，那么https://swagger.io/swagger-ui/可能会为您提供帮助。 swagger提供了基于ymal和json（注释也是symfony的一部分）的文档，并实现了大多数流行的工作平台。

实际上nelmio-api-doc捆绑包正在使用swagger-ui作为API文档提供程序（在配置设置https://github.com/nelmio/NelmioApiDocBundle中）

Answer 2

您当然可以在lib中要求它，但是由于它是一个Symfony捆绑包，因此会带来很多不必要的膨胀。

为什么不尝试使用PHP Swagger？ https://github.com/zircote/swagger-php

这是您可以使用的类型：

result = 
    date1 < date2 < date3 < date4 ||
    date3 < date4 < date1 < date2 ||
    date4 < date1 < date2 < date3 ||
    date2 < date3 < date4 < date1

这是Swagger UI生成的演示： https://petstore.swagger.io/

如何在没有symfony的情况下使用nelmio / api-doc-bundle？

2 个答案: