当前仅ThinkPHP v6.3和v7.0处于活跃维护状态；v5.x系列已停止安全更新，v6.0–6.2仅修复严重漏洞，需通过composer show与GitHub Release页核验版本状态。
怎么看当前ThinkPHP版本是否还在维护
直接查官方仓库的 laravel/framework 风格维护表不适用，ThinkPHP 没有统一的 LTS 标注，得看实际分支和发布记录。5.0 和 5.1 已于 2020 年停止安全更新；5.2 仅对商业授权用户开放补丁；6.0 是首个真正语义化版本，但 6.0.x 系列在 6.3 发布后就不再接收非严重漏洞修复；目前只有 thinkphp v6.3 和 v7.0（2024 年初发布）是活跃维护状态。
实操建议：
- 运行
composer show topthink/think查看精确版本号，再对照 GitHub Release 页面 确认该 tag 是否标有 “security support ended” 或已归档 - 检查
composer.json中"topthink/think"的约束是否宽泛如"^5.1"—— 这类写法在composer update时大概率会锁死在废弃分支 - 旧项目若含
extend/目录且大量覆盖核心类（比如重写thinkApp），升级路径基本不可自动化，得逐个比对 v6+ 的容器绑定、生命周期钩子变更
Controller 和 Model 层迁移最常卡在哪
不是语法报错，而是行为隐式变化：v5 默认单例控制器，v6+ 改为每次请求新建实例；v5 的 Db::name() 返回的是查询器对象，v6+ 同名方法返回的是 Query 实例，但默认不带连接池复用逻辑，高并发下容易触发 MySQL “Too many connections”。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
-
Call to undefined method thinkdbQuery::whereTime()—— 因为whereTime是 v6.2+ 新增，旧项目若用自定义封装的查询基类，可能误判方法存在性 - 模型中
protected $autoWriteTimestamp = true在 v6 下失效 —— 实际需配合protected $createTime = 'create_time'显式声明字段名，否则时间戳不自动写入 - 使用
$this->assign()在控制器里传值，模板里却收不到 —— v6 默认关闭了模板自动注入，需手动调用$this->view->assign()或启用template.auto_display配置
Composer autoload 和服务提供者怎么不动手改就崩
v5 时代靠 app/common.php 或 common/function.php 加载全局函数，v6+ 强制走 PSR-4 自动加载，且禁止在 config/app.php 里写 'common' => APP_PATH . 'common.php' 这类路径映射。
实操建议：
- 把旧项目的
common/函数文件拆成独立命名空间包，例如AppCommonHelper，并在composer.json中添加："autoload": { "psr-4": { "App\Common\": "app/common/" } }然后执行composer dump-autoload - v5 的服务提供者写在
app/provider.php，v6+ 必须注册到app/provider.php（同名但结构不同）或通过config/app.php的'providers'数组显式引入，漏掉就会导致Class not found - 注意
thinkRoute在 v6 中已被移入think acadeRoute，所有静态调用必须加use think acadeRoute;，否则Route::get()直接报错
Redis 和日志配置升级后为啥更慢了
v6 默认启用 thinkcachedriverRedis 的连接池，但池大小默认是 20；如果旧项目 Redis 配置没设 host 而只写了 socket，v6+ 会静默降级为 file 缓存，根本连不上 —— 表象是接口响应变长，实际是缓存失效后全走 DB。
性能影响点：
- 日志驱动从
File切到Trace或Syslog后，若未配'level' => ['error']，v6+ 的 debug 模式会默认记录所有 SQL，单次请求日志体积暴涨 10 倍以上 -
cache.redis.prefix在 v5 是字符串，在 v6+ 必须是数组才能生效，写成'prefix' => 'tp5'会导致所有 key 不带前缀，和其他项目冲突 - 使用
think-queue时，v6.3+ 要求队列连接必须用redis://协议格式，127.0.0.1:6379会被当成 TCP 地址忽略密码参数，结果消费者起不来
重写成本真正的复杂点不在语法转换，而在于旧项目里那些没文档、没测试、靠“试出来”的中间层胶水代码——它们往往绕过框架约定，直操作 PDO 或写死路径，升级时既没法扫描，也很难验证是否等价。这类代码越深，评估就越不能只看 composer 版本号。
