ThinkPHP 6.0.16 升级至 8.0 需深度重构：统一 PHP 8.0+ 环境、重装依赖并锁定子包版本、调整为 app/ 和 config/ 目录结构、重写入口文件、适配路由/ORM/中间件等核心变更。
ThinkPHP 6.0.16 升级到 8.0 不是版本号替换就能完成的迁移，而是基于 PHP 8.0+ 特性的一次深度重构。必须同步调整环境、依赖、目录结构、核心调用方式和运行逻辑，否则极易出现白屏、500 错误或静默失效。
确认并统一 PHP 运行环境
TP8 要求 PHP ≥ 8.0.0，且 CLI 和 Web SAPI（如 php-fpm）版本与配置必须完全一致——这是最常被忽略的致命点。
- 执行
php -v查看 CLI 版本，确保为 8.0.0 或更高（推荐 8.0.30+ 或 8.1.x） - 在
public/下新建info.php，内容为<?php phpinfo(); ?>，通过浏览器访问，核对顶部 PHP 版本、Loaded Configuration File路径是否与 CLI 完全一致 - 检查必需扩展：运行
php -m | grep -E 'mbstring|openssl|pdo|curl|json|zip|fileinfo'，缺一则补装 - 若使用宝塔、PHPStudy 等面板，请切换至对应非线程安全（NTS）版本，并重启 Web 服务与 PHP 进程
重装依赖并锁定关键子包
TP8 对子包有强版本约束，composer update 易引发冲突，必须清空重建。
PHP 8.5.12 RC 1
下载
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
- 删除项目根目录下的
vendor/和composer.lock - 编辑
composer.json的require区块，精确指定以下组合：
"require": {
"php": ">=8.0.0",
"topthink/framework": "^8.0",
"topthink/think-orm": "^3.0",
"topthink/think-view": "^2.0",
"topthink/think-filesystem": "^2.0"
}
- 执行
composer install --no-dev - 立即运行
composer dump-autoload -o，否则命令和类加载会异常 - 手动清空
runtime/目录（残留缓存会导致路由 404、配置读错等隐蔽问题）
调整目录结构与入口文件
TP8 彻底弃用 application/，改为标准 app/ + config/ 结构，且入口引导逻辑变更。
立即学习“PHP免费学习笔记（深入）”；
- 将原
application/重命名为app/，确保其下含controller/、model/、middleware/、route.php等标准子目录 - 更新
public/index.php内容为 TP8 标准写法：
require __DIR__ . '/../vendor/autoload.php'; (new \think\App())->run()->send();
- 把所有配置文件（如
database.php、app.php、cache.php）全部移入config/根目录（不再支持conf/或嵌套子目录） - 若存在自定义配置（如
config/api.php），需显式加载：Config::load('api', 'api');
适配核心代码变更点
路由、ORM、中间件、模型行为等均发生范式级变化，需逐项核查。
-
路由注册：弃用字符串式写法（如
Route::get('index', 'index/index')），改用数组或闭包：Route::get('index', [\app\controller\Index::class, 'index']);
中间件必须显式绑定，不再通过middleware.php全局附加 -
命名空间与类引用：
use think\Controller、use think\Model已废弃；控制器继承think\controller\Base，模型需use think\Model as BaseModel并显式继承 -
数据库查询：链式调用如
Db::table()->where()->find()返回对象实例，需调用toArray()才得数组；软删除find()不再自动过滤已删除记录，需手动加->withTrashed()或->onlyTrashed() -
迁移工具：若使用
topthink/think-migration，TP6 对应^3.0，TP8 必须升级为^4.0，否则命令无法识别
