ThinkPHP 6.1.5 升级到 8.0 是架构级重构，需满足 PHP ≥ 8.0，重写多模块隔离机制、目录结构、命名空间、路由绑定、配置加载、模型行为及插件命令等。
确认升级前提与路径合理性
ThinkPHP 6.1.5 升级到 8.0 不是版本号替换，而是架构级重构。TP8 要求 PHP ≥ 8.0，且底层已弃用大量 TP6 的兼容层。若项目为多模块（如 admin、api、home），需特别注意模块隔离机制在 TP8 中已被彻底重写——它不再依赖目录自动识别，而改由 app/multi.php 显式声明，并配合路由分组绑定应用名。
目录结构与命名空间重映射
TP8 统一使用 app/ 作为应用根目录，废除 application/。多模块项目原结构如：
- application/admin/controller/Index.php
- application/api/controller/User.php
需改为：
- app/admin/controller/Index.php，命名空间改为 appdmincontroller
- app/api/controller/User.php，命名空间改为 apppicontroller
所有模块控制器继承类需从 thinkController 改为 thinkcontrollerBase；模型类统一继承 thinkModel（注意：TP8 中 thinkModel 是 ORM 核心类，无需再 alias）。
立即学习“PHP免费学习笔记（深入）”；
PHP 8.5.12 RC 1
下载
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
多模块路由与中间件显式绑定
TP8 不再支持全局中间件配置文件（middleware.php），每个模块的路由必须在对应 app/{module}/route.php 中定义，并显式绑定中间件：
- 删除旧版 Route::get('admin/index', 'admin/index/index') 字符串式写法
- 改用数组或闭包：Route::get('index', [ppdmincontrollerIndex::class, 'index'])->middleware([ppdminmiddlewareAuth::class])
- 若启用多应用模式，需在 app/multi.php 中声明：return ['admin', 'api', 'home'];
- 跨模块跳转需用 url('admin/index/index')，而非 url('index/index')，否则无法解析目标应用
配置加载与数据库模型适配
TP8 的 config/ 目录必须扁平化，禁止子目录嵌套。原 config/admin/database.php 需拆为 config/database_admin.php，并在模块路由初始化前手动加载：
- 在 app/admin/bootstrap.php 中加入：Config::load('database_admin', 'database');
- Db 查询返回值默认为模型实例，如需数组需显式调用 ->toArray()
- 软删除行为变更：Model::find($id) 不再自动过滤 deleted_at 非空记录，需主动加 ->withTrashed() 或 ->onlyTrashed()
- 模型验证禁用闭包规则，改用 validate 方法：$model->validate(true)->save($data)
插件与命令迁移要点
多模块项目常含自定义插件（如 admin 模块专用日志插件），升级后易失效：
- 检查 composer.json 的 autoload.psr-4 是否映射到插件真实路径，例如："app\admin\plugin\": "app/admin/plugin/"
- 插件内所有 $this->app->make() 替换为 $this->app->get()
- 控制台命令（如 php think admin:sync）必须在 config/console.php 的 'commands' 数组中注册完整类名
- 若插件含数据库迁移，确保使用 topthink/think-migration:^4.0，并运行 php think migrate:run --connection=database_admin 指定模块专属连接
缓存清理与环境双验
升级后白屏、500 或路由 404，90% 源于残留缓存或环境错位：
- 删掉 runtime/、vendor/、composer.lock
- 执行 composer install --no-dev && composer dump-autoload -o
- 确认 CLI 和 Web SAPI 使用同一 PHP 版本（如 php -v 与 phpinfo() 一致）
- 检查 public/.htaccess（Apache）或 nginx.conf 是否仍指向 application/ 路径，需更新为 app/
