在 bootstrap中新增
$app->register(Espier\Swagger\Providers\SwaggerServiceProvider::class);
然后执行命令，将swagger UI的资源拷贝到public目录中.
php artisan api:swagger --setup
如需生成指定目录的swagger API josn文件则使用
php artisan api:swagger --output=[/path/to/project];
默认JSON文件生成目录为Storage的apidocs中，可通过在.env中新增配置改变存储目录名称
SWAGGER_STORAGE_DIR=apidocs
生成API JSON文件后通过路由访问
http://example.com/api-doc
如果需改变路由名称则可以通过.env配置
SWAGGER_DOCS_ROUTER=api-doc
如果需要使用mock server 则必须安装PHP的Yaml扩展，并且启动mock server服务
php artisan api:swagger --mock-server-start
在开发阶段因为团队中每个人的环境配置不一致，API需要绑定不同的访问地址。
那么则不能用API中定义的host和basePath作为测试地址。
以便于个人开发测试，那么则可以通过.env配置个人的host和basePath。
SWAGGER_API_HOST=
SWAGGER_API_BASE_PATH=