ThinkPHP 8.0是基于PHP 8.0+重写的全新架构，非6.0升级版，需全面升级PHP环境至≥8.0.0、显式声明依赖、调整模型继承、中间件类型约束、路由绑定方式及配置加载路径，并注意软删除、时间戳和模板函数等兼容性变更。
从ThinkPHP 6.0项目直接执行composer update升级到8.0，大概率会触发PHP反射弃用警告、ORM类找不到、路由白屏或中间件失效等连锁报错，根本原因是8.0不是6.0的增强版，而是基于PHP 8.0+重写的全新架构，连容器底层都已替换。
PHP运行环境与反射机制彻底重构
ThinkPHP 6.0在PHP 8.0+环境下会持续抛出Deprecated警告，典型错误是Method ReflectionParameter::getClass() is deprecated，这是因为TP6的容器重度依赖已被PHP 8.0废弃的反射方法；TP8则完全改用$param->getType()->getName()等现代反射API实现依赖注入。
必须将服务器、CLI终端、Web服务器（如php-fpm）三处的PHP版本全部升级至【>=8.0.0】，仅修改其中一处会导致环境不一致，升级后部分功能在命令行能跑、网页却报错。
不要试图用@符号压制TP6中的反射警告——压制后容器解析行为不可靠，可能出现服务注册失败但无提示的静默故障。
立即学习“PHP免费学习笔记（深入）”；
composer.json依赖声明规则强制变更
TP8不再兼容TP6的隐式依赖推导逻辑，以下四项必须显式写入require区块，缺一不可：
方法一：手动编辑composer.json
将原6.0配置中仅有的"topthink/framework": "^6.0"替换为完整依赖块：
"require": {<br> "php": ">=8.0.0",<br> "topthink/framework": "^8.0",<br> "topthink/think-orm": "^3.0",<br> "topthink/think-filesystem": "^2.0"<br>}
方法二：使用命令行覆盖（推荐用于快速验证）
先删除现有composer.lock文件→执行composer require topthink/framework:^8.0 topthink/think-orm:^3.0 topthink/think-filesystem:^2.0 --update-with-dependencies→Composer会自动补全php版本约束。
【务必删掉旧composer.lock再更新】，否则lock文件会锁死TP6时代的老依赖，导致update命令形同虚设。
核心组件与命名空间行为变化
第一步：模型类必须继承think\Model而非think\db\Query
TP6中Db::table()返回查询对象，TP8中统一由ORM驱动，所有数据操作需通过模型实例进行，Db::name('user')->where(...)->find()在TP8里默认返回think\model\Pivot实例，若需数组结果必须显式调用->toArray()。
第二步：中间件构造函数参数类型必须严格声明
TP6允许public function __invoke($request, \Closure $next)，TP8要求明确标注\think\contract\MiddlewareInterface或具体类型，否则PHP 8.1+严格模式下会触发TypeError。
第三步：路由绑定方式改为显式声明
TP6支持在middleware.php中全局附加中间件，TP8必须在路由定义时用Route::get('login', 'Index/login')->middleware(AllowCrossDomain::class)，否则中间件不会生效。
第四步：配置文件加载路径扁平化
TP6默认只加载config/根目录下的app.php、database.php等预设文件，原config/api/v1.php这类嵌套路径配置将被忽略，必须移至config/根目录并调用Config::load('api_v1.php', 'apiv1')显式载入。
代码兼容性与静默变更点
TP8对软删除字段的处理逻辑已变更：原TP6中delete_time字段为NULL时自动视为未删除，TP8默认要求该字段值为0或NULL且需在模型中显式开启protected $softDelete = true;，否则查询时仍会返回已“删除”记录。
时间戳字段（create_time、update_time）在TP8中默认启用自动写入，但仅当数据库字段类型为datetime或timestamp且允许NULL时才生效；若字段类型为int，需在模型中设置protected $type = ['create_time' => 'timestamp']，否则时间值写入为0。
视图模板中{:dump($data)}仍可用，但{:input('id')}助手函数在TP8中已被标记为废弃，应改用Request::instance()->param('id')或依赖注入think\Request实例。
