Swagger 选择一个工具来记录RESTAPI

实际上，我使用Doxygen来记录我的php REST应用程序，我刚刚发现Apariy&Swagger似乎是记录API的好工具……我想知道是否有一种方法可以根据代码注释使用其中一种工具（Apariy或Swagger）自动生成文档

使用

swagger-php

可以从使用注释记录的php脚本集合中自动生成文档

这里详细记录了Swagger PHP： 可以在github上找到一个工作示例：

---

关于包含文档的json文件的生成，请检查我的回答：

我已经回答了on-RAML在这方面与Swagger类似。非常感谢@Mark，我将在您的unswer中看到示例。您对apiDoc有何看法？嗨@Betty，最后是

Swagger

，

RAML

，

blueprint

和

apiDoc

用于定义API。在工具覆盖率和特定语言集成方面，我认为

swagger

是最好的。它具有对主要语言（php、java、js等）、代码生成器（即swagger codegen）、文档生成器（即swagger php）和可视化工具（即swagger ui）的注释支持。此外，它是社区驱动的，在Github上的开发非常积极。好吧，非常感谢@Mark.。但是我还没有找到足够的文档来说明如何实现这些工具，因为即使我在Github中看到了示例，我也不能不幸地将其用于我的项目中。。你能帮我吗？