ThinkPHP8 是基于 PHP 8.0+ 的底层重写，非简单升级；需强制 PHP ≥8.0、重构容器反射逻辑、显式声明 ORM 等依赖、适配路由验证规则、修正软删除与时间戳行为，并全面测试“无报错但结果异常”场景。
ThinkPHP6 和 ThinkPHP8 表面看是“大版本跃迁”，实际是一次基于 PHP 8.0+ 的底层重写，不是简单功能叠加。如果你正从 TP6 升级到 TP8（比如 v6.1.4 → v8.0.1），核心差异不在“用法变没变”，而在于运行时环境、类型系统、依赖链和关键组件的替换逻辑。
PHP 版本与反射机制变化：升级失败最常见原因
TP6 在 PHP 8.0+ 下会直接报错，典型错误是：
Deprecated: Method ReflectionParameter::getClass() is deprecated in .../Container.php on line 443
这是因为 PHP 8 废弃了 ReflectionParameter::getClass()、::isArray()、::isCallable() 等方法，而 TP6 的容器（think\Container）重度依赖它们做依赖注入解析。
TP8 则彻底重构了容器和反射逻辑，全部改用 $param->getType()->getName() 等现代方式，不再触发弃用警告。
立即学习“PHP免费学习笔记（深入）”；
- 必须确认当前 PHP 版本 ≥
8.0.0（推荐8.1+），用php -v检查 - 不要试图在 PHP 8 环境下硬跑 TP6 —— 即使加
@抑制警告，容器行为也不可靠 - 如果项目还混用某些 TP6 时代的第三方扩展（如老版
topthink/think-migration），需确认其是否已适配 PHP 8+ 反射 API
composer.json 关键依赖项必须显式声明
TP8 不再兼容 TP6 的依赖隐式推导逻辑。你不能只写 "topthink/framework": "^8.0" 就完事——以下三项必须手动补全：
-
"topthink/think-orm": "^3.0"（TP8 默认 ORM，TP6 是think-orm ^2.0） -
"topthink/think-filesystem": "^2.0"（TP6 默认不强制引入，TP8 需显式声明，否则Filesystem类找不到） -
"php": ">=8.0.0"（Composer 会据此过滤不兼容包）
"require": {
"php": ">=8.0.0",
"topthink/framework": "^8.0",
"topthink/think-orm": "^3.0",
"topthink/think-filesystem": "^2.0"
},
"require-dev": {
"symfony/var-dumper": ">=4.2",
"topthink/think-trace": "^1.0"
}
- 升级前务必删掉
composer.lock，再执行composer update，否则旧 lock 文件可能锁死 TP6 依赖 - 若项目用了自定义服务提供者或中间件，检查其构造函数参数类型声明是否用了 PHP 8 联合类型（如
string|int），TP6 的反射无法识别，TP8 可以
路由与验证规则的“静默升级”：行为变了但不报错
TP8 的路由匹配和验证类做了语义优化，多数情况下“能跑”，但结果可能和 TP6 不一致：
验证规则新增
startWith、endWith、contain，但老项目若自己写了同名方法，可能被框架覆盖rule配置中正则写法更严格：TP6 允许regex:/^[a-z]+$/，TP8 推荐用regex:^([a-z])+$（去掉了斜杠包裹，避免双重转义）路由变量捕获默认启用严格模式，比如
/:id\d+在 TP6 中可能宽松匹配/123abc，TP8 会截断或拒绝建议升级后重点测试所有带参数的 API 路由（尤其是含正则约束的）
验证类中若用了
filter或callback，确认回调函数返回值类型是否符合 PHP 8 声明（如返回bool但实际返回int会触发严格模式警告）
模型与时间戳行为差异：软删除和自动填充容易漏测
TP8 的 think-orm 3.0 对模型生命周期管理更激进：
softDelete()默认字段名改为delete_time（TP6 是delete_time或可配置，TP8 强制统一）时间戳字段（
create_time/update_time）默认开启自动写入，且类型检测更严：若数据库字段是DATETIME，但 PHP 传的是字符串"2025-12-27"，TP8 可能抛TypeError，TP6 会静默转换关联预加载（
with()）在 TP8 中默认禁用懒加载，load()方法行为有调整，老代码里$user->orders->load('items')可能失效检查模型类中是否显式设置了
protected $deleteTime = false，TP8 下该写法已被忽略，应改用use SoftDeletetrait 并配置常量所有涉及
save()、update()的批量操作，加上dd($model->getChangedData())确认字段是否真被写入
TP8 的升级不是“换包重启”就能搞定的事。最危险的点往往藏在那些「没报错但结果不对」的地方——比如软删除记录还能被查出来、时间字段存成 0000-00-00 00:00:00、验证通过但数据库写入被截断。上线前，务必用真实业务数据跑一遍核心路径，而不是只测 hello world。
