ThinkPHP各版本核心变化：6.x逐步强化契约化、多应用、PHP8兼容及安全优化；8.x重构路由、剥离模型、统一配置格式并要求严格类型标注。
想快速掌握ThinkPHP各版本核心变化，避开升级踩坑，直接对照日志判断是否该升级或兼容改造。
查看当前项目ThinkPHP版本号
打开项目根目录下的 composer.json 文件，找到 "topthink/framework" 行，其后紧跟着的值就是当前锁定的版本号，例如 "6.1.0" 或 "^8.0"。
如果项目未用 Composer 管理，进入 thinkphp/library/think/App.php，搜索 const VERSION =，等号右侧字符串即为版本号。
ThinkPHP 6.x 主要更新日志与关键优点
方法一：从 v6.0 到 v6.3 的渐进式升级亮点
立即学习“PHP免费学习笔记（深入）”；
① v6.0 引入完全契约化设计，所有核心类（如 Request、Response）强制实现接口，大幅降低框架耦合度；控制器不再继承基类，改用注解或依赖注入获取服务。
② v6.1 新增多应用模式支持，同一入口可运行多个独立应用，路由、配置、中间件完全隔离；【切换前必须清空 runtime 目录】，否则旧缓存会干扰新应用加载。
③ v6.2 开始支持 PHP 8.1+，修复了枚举类型与反射的兼容问题；数据库查询构建器新增 when() 方法，让条件拼接更安全——不用再手动判断变量是否为空再拼 SQL。
④ v6.3 优化了命令行工具（think）的执行速度，首次运行耗时减少约 40%；模板引擎默认启用沙箱模式，禁用原生 PHP 标签，防止模板中执行危险代码。
ThinkPHP 8.x 重大变更与适配要点
v8.0 是一次架构级重构，放弃对 PHP 7.3 及以下版本支持，最低要求 PHP 8.0。
方法一：核心变动速览
• 路由定义方式彻底改变：移除闭包注册方式，全部改用 Route::get/post/any() 静态调用，且必须显式声明中间件组。
• 模型层剥离 ORM 功能，think-model 独立为扩展包，需手动安装；原 Db::table() 查询仍保留，但模型关联必须通过 hasOne 等方法显式定义。
• 配置文件格式统一为 PHP 返回数组，废弃 .env 和 YAML 支持；【.env 中的 DATABASE_URL 等字段将被完全忽略】，迁移时必须把数据库配置写进 config/database.php。
方法二：升级前必做检查
检查项目中是否存在 app\common.php 全局函数文件——v8.0 已移除此机制，所有辅助函数需放入 helper/ 目录并手动引入。
确认所有控制器方法返回值类型：v8.0 要求明确标注 Response|View|Json，否则在严格模式下会触发类型错误。
