ThinkPHP8.0新特性详解与升级指南【新手必看】-ThinkPHP-PHP中文网

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动词匹配。

thinkphp8.0新特性详解与升级指南【新手必看】

想把老项目升级到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.”字样，说明尚未升级，需先完成环境准备再进入下一步。

安装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）。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

第三步：将$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', )。