这个项目可以用php的方式来swagger语法
composer require zircote/swagger-php
这个项目可以让我们很便捷的使用swagger-ui,还有自动刷新功能呢..很赞 👍
当然也建议看下github的文档.说的还是很详细了
composer require "darkaonline/l5-swagger:5.5.*"
php artisan vendor:publish --provider "L5Swagger\L5SwaggerServiceProvider"
php artisan l5-swagger:generate
因为默认是不刷新的,那么我们在.env里面配置
L5_SWAGGER_GENERATE_ALWAYS=true
这点对文档编写调试很有帮助
* @SWG\Get(path="/xia-mi/music/{music}/lyric",
* tags={"虾米音乐"},
* summary="获取歌词",
* description="只能获取到原文歌词",
* operationId="getMyData",
* produces={"application/json"},
* @SWG\Parameter(
* description="ID of pet to fetch",
* format="int64",
* in="path",
* name="id",
* required=true,
* type="integer",
* default=2069544
* ),
参数描述
这个还不知道
参数名称
是否是必须参数
参数类型
参数默认值
请支持跨域