Swagger在Laravel项目中的使用
来源:互联网 发布:360u盘数据恢复软件 编辑:程序博客网 时间:2024/04/29 15:58
本篇讲述在如何快速在Laravel中引入Swagger并开始使用。
安装
首先是使用Laravel的一个composer:L5 Swagger
。
下面是对应的各个版本。
下面的过程全部基于Laravel 5.5.x
在Laravel根目录下执行一下命令 composer require "darkaonline/l5-swagger:5.5.*"
等待安装结束。
之后执行:
- Run
php artisan l5-swagger:publish
来进行初始化 - Run
php artisan l5-swagger:generate
来生成环境变量到.env文件中
现在可以看到在config
目录下有一个l5-swagger.php
,里面就是对应swagger的各个配置。
然后启动项目,访问你的网站地址/api/documentation
就可以看到初始化界面了。
接下来在控制器中写出一个SwaggerController,其中代码如下:
<?phpnamespace App\Http\Controllers;use Swagger\Annotations\Info;/** * @Info( * title="My title", * version="v1.0.0" * ) */class SwaggerController extends Controller{ /** * 假设是项目中的一个API * * @SWG\Get(path="/swagger/my-data", * tags={"project"}, * summary="拿一些神秘的数据", * description="请求该接口需要先登录。", * operationId="getMyData", * produces={"application/json"}, * @SWG\Parameter( * in="formData", * name="reason", * type="string", * description="拿数据的理由", * required=true, * ), * @SWG\Response(response="default", description="操作成功") * ) */ public function getMyData() { }}
这是再访问http://localhost/api/documentation
,可以看到以下画面:
现在,开始尽情使用Swagger吧。
附上Swagger-PHP的demo地址,可以参照其中的示例。
Swagger-PHP demo
阅读全文
0 0
- Swagger在Laravel项目中的使用
- 在项目中使用swagger
- Swagger在WebApi中的使用
- Swagger在android中的使用
- swagger-UI在springMVC结构中的使用
- swagger在springBoot中的使用记录
- laravel(5.2) Swagger UI的使用
- 使用Swagger在SpringBoot项目中管理API文档(使用Oauth2)
- 使用 Intervention/image 对 Laravel 项目中的图片进行处理
- 使用 Intervention/image 对 Laravel 项目中的图片进行处理
- SSM项目使用springfox集成swagger
- 阿里对象存储OSS在laravel框架中的使用
- swagger使用
- Swagger使用
- swagger使用
- 使用 PhpStorm开发Laravel项目
- ANT 在项目中的使用
- lucene 在项目中的使用
- 非常全的23种设计模式详解,收藏了
- ACM周中总结—9月21日
- bzoj 1584 Cleaning Up 打扫卫生 dp
- 使用第三方动态库出现dyld: Library not loaded Reason: image not found
- 简单线性回归的Python实现
- Swagger在Laravel项目中的使用
- 从《命运石之门》浅谈世界线收束理论
- 41 数据结构笔记之四十一图的遍历之深度优先
- 计算机视觉及其与相关领域的异同
- 数据结构
- 吴恩达Coursera深度学习课程 DeepLearning.ai 编程作业(1-2)
- 在不知道第一响应者时取消键盘
- 洛谷用题解AC的题
- 学生考勤管理系统