微信公众号 讲师中心
首页
文章
web3.0 后端开发 web前端 数据库 开发工具 php框架 常见问题 科技 Java 系统教程 电脑教程 硬件教程 手机教程 软件教程 游戏教程 自媒体 新闻
专题
后端开发 web前端 数据库 开发工具 php框架 科技 Java 系统教程 电脑教程 硬件教程 手机教程 软件教程 游戏教程 新闻
AI工具
AI 聊天问答 Agent智能体 AI 文本写作 AI 绘画作图 AI 设计工具 AI 视频创作 AI 音频制作 AI 办公学习 AI 编程开发 Prompt指令
学习
大前端 后端开发 数据库 移动端 运维开发 计算机基础
编程手册
大前端 后端开发 数据库 移动端 运维开发 计算机基础
下载
js特效 网站源码 工具下载 类库下载 网站素材 学习资源 插件扩展 手机/移动开发 手机游戏
最近更新
搜索
web3.0 后端开发 web前端 数据库 开发工具 php框架 常见问题 科技 Java 系统教程 电脑教程 硬件教程 手机教程 软件教程
游戏教程 自媒体 新闻
首页 > php框架 > ThinkPHP > 正文

thinkphp5集成Swagger-PHP（排坑）

藏色散人
发布： 2020-09-07 09:22:53
转载
4232人浏览过

下面由thinkphp教程栏目给大家介绍thinkphp5集成swagger-php（排坑），希望对需要的朋友有所帮助！

thinkphp5集成Swagger-PHP（排坑）

学习 Swagger 过程中发现网上大部份的资料都不是特别全，所以特别发文把自己的排坑历程写出来，希望能对大家有帮助。

1、安装swagger-php2.0

（注：我下载的是swagger-php2.0，本文针对swagger-php2.0）

composer require zircote/swagger-php: 2.0.*
登录后复制

2、下载swagger-ui

立即学习“PHP免费学习笔记（深入）”；

集简云
集简云

软件集成平台，快速建立企业自动化与智能化

集简云 22
查看详情 集简云

去swagger-ui官网下载静态页面，把静态页面放到thinkphp框架目录里，例如public目录。

https://swagger.io/tools/swagger-ui/
登录后复制

3、thinphp框架引入swagger-php，生成swagger.json文件

use Swagger\Annotations as SWG;
class Index
{
public function index()
{
$swagger=\Swagger\scan(__DIR__);
$res=$swagger->saveAs('./swagger.json');
}
登录后复制

4、文档注释部分

/**
* @SWG\Swagger(
* schemes={"http"},
* host="www.tp.com.cn/",
* basePath="/",
* @SWG\Info(
* title="API文档",
* version="1.0.0",
* )
* ),
*/
登录后复制

详细关于Swgger-php的使用说明请访问

https://www.kancloud.cn/chengguang/swagger-php#/catalog
登录后复制

以上就是thinkphp5集成Swagger-PHP（排坑）的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！

下载
来源：segmentfault网
收藏 点赞
上一篇：搞定ThinkPHP验证码不显示的问题 下一篇：使用Container类实现ThinkPHP核心框架
本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系admin@php.cn
作者最新文章
最新问题
thinkphp日志文件在哪里以及如何查看 ThinkPHP日志默认存储在项目根目录/runtime/log/年_月/日.log文件中，可通过服务器命令行查看文件内容，需确保配置开启日志功能并设置正确级别，日志包含错误、警告、调试信息及时间戳和URL，开发环境可结合工具直接查看，生产环境应避免暴露runtime目录。
2025-10-09 20:25:01
790
thinkphp如何清除项目编译缓存和数据缓存 清除缓存可解决ThinkPHP开发中因缓存未更新导致的问题，需分别清理编译缓存和数据缓存；编译缓存位于runtime/temp，可通过删除该目录文件或执行\think\facade\Cache::clear(’temp’)清除；数据缓存存储在runtime/cache，可用\think\facade\Cache::clear(’cache’)或按标签清除；开发时推荐使用phpthinkclear命令一键清除所有缓存，包括日志等运行时文件，提升调试效率。
2025-10-09 14:20:02
712
thinkphp助手函数的使用技巧和汇总 ThinkPHP助手函数提升开发效率，涵盖调试dump()、日志trace()、环境变量env()、配置config()、路径app_path()等基础函数；输入处理input()、请求request()、参数param()、会话cookie()与session()；模板view()、跳转redirect()、数据返回json()/xml()及响应response()；支持在app/common.php自定义助手函数并自动加载，合理使用可增强代码可读性与项目可维护性。
2025-10-08 15:50:02
881
thinkphp路由无效或404错误怎么排查 首先确认是否开启路由功能，检查config/app.php中'url_route_on'是否为true；接着验证路由定义位置及语法正确性，确保route/route.php中规则无误；然后检查URL访问模式，确保入口文件index.php正确指向public目录；若隐藏index.php需配置服务器重写规则，Apache启用mod_rewrite或Nginx添加rewrite规则；最后开启调试模式查看日志或使用phpthinkroute:list命令排查路由匹配情况。
2025-10-07 19:15:01
540
thinkphp如何配置和使用Redis缓存 ThinkPHP支持Redis缓存，需安装Redis扩展并配置cache.php，设置type为redis及连接参数，使用Cache::set/get等方法操作缓存，注意服务运行、密码配置、key前缀和持久连接。
2025-10-03 19:23:02
868
thinkphp如何配置伪静态隐藏index.php 答案：隐藏ThinkPHP入口文件需配置服务器伪静态规则。1.Apache通过.htaccess启用rewrite模块重定向请求；2.Nginx在配置文件中使用try_files或rewrite规则；3.确保框架路由开启；4.访问URL不带index.php且正常响应即生效。
2025-10-02 17:49:02
287
thinkphp数据库迁移和数据填充怎么用 ThinkPHP通过集成Phinx实现数据库迁移与数据填充，首先安装think-phinx并初始化生成配置文件；接着创建迁移文件定义表结构，使用migrate命令执行变更，rollback回滚；再创建Seeder类编写测试数据，通过seed:run插入数据；注意命名匹配、避免生产环境随意回滚，结合模型时慎用事件，确保数据库变更可版本化管理。
2025-10-01 21:14:02
868
thinkphp查询作用域(scope)如何简化查询 答案：ThinkPHP的查询作用域通过定义scope方法封装常用查询条件，支持无参、带参及默认全局作用域，可组合调用或链式使用，有效减少重复代码，提升模型可维护性。
2025-09-29 23:26:03
539
thinkphp session无法保存或跨控制器失效怎么办 ThinkPHP中session无法保存或跨控制器失效，主要因session未正确开启、配置不当或调用时机错误。1.确保在Base控制器构造函数中调用session_start()或Session::init()，或在config/session.php中设置'auto_start'=>true；2.若涉及多模块或子域名，需在session配置中设置'domain'=>'.yourdomain.com'以共享session；3.避免在session_start()前有任何输出，检查文件BOM、空
2025-09-27 10:37:01
302
thinkphp6和thinkphp5的主要区别是什么 ThinkPHP6相比ThinkPHP5在架构设计、依赖管理、核心组件和性能优化上均有显著提升。TP6全面支持PSR标准，重构容器并原生支持依赖注入，应用结构更清晰，便于测试与解耦；通过Composer进行依赖管理，实现框架与项目分离，符合现代PHP开发规范；数据库层拆分Query与Model，职责明确，修复链式操作问题，提升类型安全；路由系统支持缓存与动态编译，性能更强，中间件贴近PSR-15标准，整体更适配高并发场景。从TP5到TP6不仅是版本升级，更是向现代化工程实践的跨越。
2025-09-27 09:11:01
885
相关专题
更多>
热门推荐
开源免费商场系统广告
热门教程
更多>
相关推荐
热门推荐
最新课程
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新 English
php中文网：公益在线php培训，帮助PHP学习者快速成长！
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号

  • PHP学习

  • 技术支持

  • 返回顶部