swagger-laravel的使用

laravel先安装

查看文档

https://github.com/DarkaOnLine/L5-Swagger/

用支持laravel 5.3的版本

1
composer require "darkaonline/l5-swagger:4.0.1"

config/app.php,文件的providers部分,增加一段

1
L5Swagger\L5SwaggerServiceProvider::class,

在生成配置文件,和发布swagger所需要的静态资源

1
2
3
4
5
6
php artisan l5-swagger:publish
php artisan l5-swagger:publish-config
php artisan l5-swagger:publish-assets

//低版本增加这一句
php artisan l5-swagger:publish-views

生成api文档

1
php artisan l5-swagger:generate

自动生成

.env文件

1
L5_SWAGGER_GENERATE_ALWAYS=true

一些资料

swagger-php语法
https://blog.csdn.net/weixin_33828101/article/details/88875480

json解析
https://bfanger.nl/swagger-explained/#schemaObject