laravel-5 - 如何在 Laravel 5.4 中使用 Swagger？

Question

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

Answer 1

安装darkaonline/l5-swagger:

Composer 需要“darkaonline/l5-swagger:~5.0”

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

然后运行:

php artisan l5-swagger:publish

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