ThinkPHP系统升级完整教程-ThinkPHP-PHP中文网

thinkphp 6→8跨大版本升级需严格校验php环境（cli与fpm同版本≥8.0）、限定更新范围（仅topthink/framework）、清理runtime/、迁移application/为app/、替换废弃调用（如request::instance()）、启用warning日志捕获deprecated提示。

thinkphp系统升级完整教程

ThinkPHP 跨大版本升级（比如 6 → 8）不是改个 composer.json 就能跑通的事——环境不一致、依赖未对齐、缓存没清、Facade 调用写法过时，任何一个环节出错都会导致 Class 'think\App' not found 或路由 404/500。

确认 PHP 环境和 CLI/Web SAPI 是否一致

很多升级失败根本卡在第一步：你以为 PHP 是 8.1，其实 CLI 和 php-fpm 是两个版本。执行 php -v 看命令行版本，再用 phpinfo() 或 php -r "echo PHP_SAPI;" 查 Web 运行模式。ThinkPHP 8.0 要求 PHP ≥ 8.0.0，且 CLI 和 FPM（或 CGI）必须同版本。常见陷阱是 Nginx 用 php7.4-fpm，而你本地 composer update 是在 php8.2 下运行的，结果依赖装上了，一访问就报错。

检查必需扩展是否启用：mbstring、openssl、pdo_mysql、json、curl
若项目用了 topthink/think-swoole 或 topthink/think-multi-app，这些在 TP8 中已废弃或需单独适配，先查 GitHub 仓库是否支持
建议用 docker run --rm -v $(pwd):/app -w /app php:8.2-apache composer install 快速验证干净环境能否通过

只更新 topthink/framework，别全量 composer update

直接运行 composer update 会强行升级所有包，比如把 psr/log 升到 v3、league/flysystem 升到 v3，而 TP6 内部日志调用和文件系统扩展并不兼容它们——结果就是白屏或 Call to undefined method。必须限定范围。

btpanel phpsite 宝塔面板PHP网站

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

下载

确保当前目录是应用根目录（含 composer.json 和可执行文件 think），可用 ls -la | grep "composer.json\|think$" 验证
修改 composer.json 中的版本约束："topthink/framework": "^8.0"（不是 "^6.0"）
执行 composer update topthink/framework --with-all-dependencies，加 --with-all-dependencies 是为解决子依赖冲突，比如 topthink/think-orm 版本不匹配
如果提示 your requirements could not be resolved，说明其他包（如 monolog/monolog）太旧，得手动升它们，不要跳过

删 runtime/、重调目录结构、替换废弃调用

升级后残留的 runtime/ 缓存会导致配置、路由、模板仍读旧逻辑；TP8 彻底废弃 application/ 目录，也移除了 Request::instance() 这类静态单例方法。

升级命令执行完，立刻删除整个 runtime/ 目录（别只清子目录）
把原 application/ 改名为 app/，public/index.php 中引导代码要同步改为 require __DIR__.'/../vendor/autoload.php'; + (new \think\App())->run()->send();
config/ 目录必须存在且统一放配置文件，旧版分散在 application/config/ 的内容全挪进去
替换硬编码调用：Request::instance() → think\facade\Request 或注入 think\Request；Db::name('user') 仍可用，但推荐改用模型操作，避免绕过事件
自定义函数文件若放在 app/common.php，TP8 默认不自动加载，需在 app/Helper.php 中显式引入，或在 composer.json 的 autoload.files 中声明

测试前先开 warning 日志，盯住废弃提示

很多问题不会立刻报错，而是静默降级或行为偏移。TP8 对大量旧写法打了 @deprecated，但默认日志等级是 error，这些警告根本看不到。

临时把 config/log.php 中的 'level' => 'error' 改成 'level' => 'warning'
完整走一遍核心流程（登录、列表页、表单提交、文件上传），观察 runtime/log/ 下是否有 Deprecated: 开头的日志行
重点关注：路由定义是否从 route/route.php 移到了 app/Route.php；中间件注册语法是否从 ->middleware() 改为 ->middleware([...])；模型时间戳字段是否仍用 protected $autoWriteTimestamp = true（TP8 推荐 $createTime/$updateTime 显式声明）
第三方 SDK（如微信支付、阿里云 OSS）若基于旧版 TP 封装，大概率需重写适配层，别指望自动兼容