如何在 Laravel 5.4 中使用 Swagger？

Question

我在 Laravel 5.,4 上有一个 Web 服务，但我需要有关它的文档。我一直在寻找选项，似乎 Swagger 是最好的选择之一（如果您有任何其他建议，请告诉我）。但是，我可以看到它的很多版本，我正在查看官方页面，但我不确定我需要实现什么。

如果您能提供一些建议或示例，我将不胜感激。

Answer 1

1. 安装darkaonline/l5-swagger：

   作曲家需要“darkaonline/l5-swagger:~5.0”

2. 为 swagger 编写正确的 phpdoc 注释（例如：https://github.com/zircote/swagger-php/tree/master/Examples/petstore.swagger.io）

3. 然后运行：

   php artisan l5-swagger:发布

4. http://yourhost.dev/api/documentation 将向您展示 swagger-ui