一、什么是SwaggerSwagger是一个标准化的完整框架,用于生成、描述、调用和可视化RESTful风格的Web服务。2、swagger安装composerrequire"darkaonline/l5-swagger"3、配置安装成功后,Laravel配置在app/Providers/AppServiceProvider中添加$this->app->register(\L5Swagger\L5SwaggerServiceProvider::class);或者在config/App.php中添加L5Swagger\L5SwaggerServiceProvider::class,在app\Http\Controllers\Controller.php中写swagger初始代码(不写swagger会报错)/***@OA\Info(title="KIDSERVICE",version="0.1")**/classControllerextendsBaseControllerLaravelpublishesswaggerphpartisanvendor:publish--provider"L5Swagger\L5SwaggerServiceProvider"开始运行(每次修改swagger代码,你必须使用此命令刷新运行)phpartisanl5-swagger:generate在浏览器地址栏输入“域名”+/api/documentation。效果图4.优势总结Swagger作为RESTfulAPI单元测试和文档注释。将企业前后端的API功能测试分开,后端开发团队人员可以快速了解功能方法和参数所表达的含义和意图。缺点:Swagger有自己的一套解释型语言,所以相当于重新学一门解释型语言(不难);会消耗一些开发效率,相当于写了一套单元测试和注释。
