thinkphp升级需“隔离变更、验证先行、回滚有据”：先校验php版本与扩展，备份依赖与数据；再开发分支精准升级框架，删除runtime并适配代码；最后预发布验证、优化缓存、锁文件打标与自动备份保障回滚。
ThinkPHP部署后更新项目，不是简单改个版本号再上线。核心是“隔离变更、验证先行、回滚有据”——升级动作必须脱离主发布流程，所有改动需经人工确认和自动化验证，失败时能秒级恢复。
升级前必须做的三件事
别跳过这步，90%的线上故障源于此处疏漏：
- 用
php -v查 CLI 版本，再建一个info.php（内容为<?php phpinfo(); ?>）访问确认 Web SAPI 版本一致，且都是目标 PHP 版本（如 TP8 要求 ≥8.0） - 执行
composer show > composer-before.txt导出当前依赖快照，同时备份数据库和整个项目目录（含runtime/和public/.htaccess等隐藏配置） - 检查必需扩展是否启用：
mbstring、openssl、pdo_mysql、json、curl、zip、fileinfo，缺一不可
安全升级操作流程
禁止在生产环境直接运行 composer update。正确路径是：
- 在开发分支（如
feature/upgrade-tp8）中修改composer.json，只调整"topthink/framework": "^8.0"，其他包不主动升级 - 运行
composer update topthink/framework --with-all-dependencies --dry-run预览变更，确认无意外升级（如psr/log升到 v3） - 执行实际升级：
composer update topthink/framework --with-all-dependencies，若报依赖冲突，手动升相关包（如monolog/monolog），不跳过 - 立刻删除整个
runtime/目录（不是清空子目录），避免缓存干扰新逻辑 - 将
application/改名为app/，同步更新public/index.php引导代码为 TP8 标准写法
代码与配置适配要点
升级后常见报错基本集中在这几类，提前扫一遍能省半天调试时间：
- 废弃调用：删掉所有
Request::instance()、Cookie::get()等静态单例，统一改为门面think\facade\Request或依赖注入 - 路由迁移：把
route/route.php移到app/Route.php，语法保持Route::get('user', 'index/user/index')即可，无需大改 - 配置路径：确保
config/app.php、config/database.php存在且格式正确，旧版Conf/目录已弃用 - 第三方扩展：运行
composer show -t | grep think-检查think-swoole、think-multi-app是否支持目标版本，不支持的先移除或找替代方案
上线与回滚保障机制
上线不是终点，而是验证开始：
- 预发布环境跑全量测试：重点验证路由加载、数据库 CRUD、会话登录、文件上传、验证码生成等核心链路
- 上线前执行
php think optimize:schema优化模型缓存，提升首屏性能 - 每次成功部署后，立即提交当前
composer.lock并打 tag（如lock-v8.0.2-20260708） - CI 脚本中加入自动备份：
cp composer.lock /tmp/lock-bak-$(date +%s)；回滚时只需cp /tmp/lock-bak-xxx composer.lock && composer install
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
