ThinkPHP6 swagger文档

下载swagger-ui:git clone https://github.com/swagger-api/swagger-ui.git

复制swagger-ui目录下dist文件到thinkphp项目public目录下

composer require zircote/swagger-php

composer require uniadmin/uniadmin-apidoc dev-master

修改dist下inedx.html文件的url

swagger文档:http://192.168.88.12:8081/dist/index.html

uniadmin-apidoc:http://192.168.88.12:8081/doc

### ThinkPHP 集成 Swagger 教程 #### 一、安装依赖包 为了在ThinkPHP中集成Swagger,可以借助`thinkphp-apidoc`这个扩展来实现API文档的自动生成。该工具能够解析注释并生成相应的API文档。 对于ThinkPHP项目的开发者来说,可以通过Composer安装此库[^2]: ```bash composer require hg/thinkphp-apidoc ``` #### 二、配置路由与控制器 完成上述操作之后,在应用内创建一个新的控制器用于处理API请求,并按照官方指南编写对应的接口方法以及必要的注解说明参数含义等内容。例如: ```php <?php namespace app\controller; use think\Controller; /** * @SWG\Post( * path="/example", * tags={"Example"}, * summary="This is an example API.", * operationId="postExample", * consumes={"application/json"}, * produces={"application/json"}, * @SWG\Parameter( * name="body", * in="body", * required=true, * description="The data to be sent as the body of the request", * type="string" * ), * @SWG\Response(response=200,description="successful operation"), * ) */ class Example extends Controller { public function index(){ // Your code here... } } ``` 这段代码展示了如何利用`@SWG`标签定义一个POST类型的HTTP请求路径及其相关信息[^3]。 #### 三、部署Swagger UI 为了让用户更方便地浏览和测试这些API接口,还需要引入Swagger UI组件。这一步骤涉及下载swagger-ui资源并将它们放置于合适的位置以便浏览器可以直接加载显示出来。具体做法如下所示[^4]: 1. 下载最新版本的Swagger UI源码; 2. 将其解压后的文件夹复制到网站根目录下的`public`子目录里; 3. 修改位于其中的`index.html`文件内的JavaScript初始化脚本部分,设置好指向本地生成好的JSON格式描述文件的具体URL地址; 以上就是关于怎样把Swagger融入到基于ThinkPHP框架构建的应用程序当中去的大致流程介绍。值得注意的是,实际开发过程中可能还会遇到其他细节上的调整需求,因此建议参考相关资料深入学习掌握更多技巧。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值