ThinkPHP 8.0升级需先确认PHP≥8.1、Composer≥2.5，再通过composer create-project安装并内置think-orm 3.0；旧Model类已废弃，须重写模型、改用数组传field、空安全操作符判空，并启用route.php中'rest_action_as_method'=>true以支持RESTful动词匹配。
想把老项目升级到ThinkPHP 8.0却卡在环境报错、模型找不到、接口404？不是你代码写错了，而是TP8彻底重构了底层依赖、强制要求PHP 8.1+、废弃旧Model类、改用独立think-orm 3.0包，连路由匹配逻辑都变了——不按新规则走，框架根本启动不了。
确认环境是否达标
执行php -v，输出必须是【PHP 8.1.0 或更高版本】；若显示8.0.x，构造函数属性提升和联合类型语法会直接导致解析失败，页面白屏且无明确错误提示。
运行composer --version，确保为2.5.0+；低于此版本无法正确解析think-orm 3.0的依赖约束，后续install/update可能拉取错误版本。
检查当前项目是否为TP6：在项目根目录执行php think version，若输出含“6.”字样，说明尚未升级，需先完成环境准备再进入下一步。
立即学习“PHP免费学习笔记（深入）”；
安装ThinkPHP 8.0并引入think-orm 3.0
执行命令：composer create-project topthink/think tp8，这会新建一个干净的TP8项目结构。
进入tp8目录后，运行php think version，输出应为ThinkPHP v8.x.x；此时框架已内置think-orm 3.0，【不要执行 composer require topthink/think-orm】，否则引发Db类与Model类行为不一致。
验证ORM是否加载成功：在app/controller/Index.php中添加return json(\think\facade\Db::query('SELECT 1'));，访问对应路由，返回{"data":[{"1":1}]}即表示底层驱动已通。
重写模型类以适配think-orm 3.0
第一步：删除原app/model/User.php中的use think\Model;声明。
第二步：改为use think\model\Pivot;（仅多对多中间表）或直接继承think\Model（注意：此Model已是think-orm 3.0提供的全新类，路径为vendor/topthink/think-orm/src/Model.php）。
第三步：将$this->field('id,name')->select()替换为$this->field(['id','name'])->select()；think-orm 3.0的field()方法不再接受字符串参数，传入字符串会静默忽略字段限制，导致全字段查询泄露敏感数据。
第四步：把find(123)的返回值判断从if($user)改为if($user?->id)；因为think-orm 3.0在查无结果时严格返回null，而PHP 8.1+的空安全操作符能避免“Trying to get property 'id' of null”错误。
启用RESTful资源路由
很多开发者写完Route::resource('users', 'UserController')却发现PUT/DELETE请求404，问题不在代码，而在配置缺失。
必须打开config/route.php中的'rest_action_as_method' => true——这是ThinkPHP 8区分HTTP动词的核心开关，关闭时框架只认路径，不认方法。
纯API场景只需5条规则：index、save、read、update、delete；create和edit是为后台表单设计的，应主动忽略或不实现。
若需版本控制（如/v1/users），要用分组前缀：Route::prefix('v1')->group(function () { Route::resource('users', 'UserController'); });，不要拼接字符串写Route::resource('v1/users', )。
更新后必须清空缓存并重跑schema优化
ThinkPHP 8.0的配置、路由、ORM元数据全部缓存到runtime/目录下。即使composer update成功，旧缓存仍会生效，导致新特性不触发、修复无效、甚至白屏。
务必在更新后立即执行：php think clear——清除所有缓存（包括模板、日志、配置）。
php think optimize:schema——重新生成ORM模型结构缓存（尤其重要：V8.0.1之前版本在子目录模型下会崩溃，必须重跑）。
