Debian系统下 ThinkPHP 版本升级指南
一 升级前准备
- 备份与版本确认：备份整个项目与数据库，建议使用 Git 提交当前状态；确认当前版本（查看 composer.json 的 topthink/framework 字段，或在代码中调用 \think\App::VERSION）。
- 升级策略：优先采用小步升级（如 5.0 → 5.1 → 6.0），避免跨大版本跳跃；全程遵循官方升级说明与变更日志。
- 运行环境：确认 Debian 上的 PHP 版本满足目标 ThinkPHP 的要求，并预留可回滚窗口与回滚方案。
二 标准升级步骤
- 方式A（Composer 管理，推荐）：在项目根目录执行指定版本升级，例如
- 升级到 ThinkPHP 6：运行命令：composer require topthink/framework:^6.0
- 升级到 ThinkPHP 5.1：运行命令：composer require topthink/framework:^5.1
完成后执行：composer update，确保依赖一致。
- 方式B（非 Composer 或老项目）：下载目标版本框架包，替换项目中的框架目录（常见为 thinkphp/ 或 vendor/topthink/framework），务必保留你的应用目录（如 application/ 或 app/）与配置文件。
- 配置与代码调整：根据目标版本的升级说明，调整配置文件结构与代码用法，重点留意函数废弃、配置结构变化、路由规则调整与第三方扩展兼容性。
- 数据库与缓存：如升级涉及数据结构变更，使用迁移脚本或手工变更；完成后清理 runtime/ 缓存并重启 PHP-FPM（如：sudo systemctl restart php-fpm）。
三 常见版本差异与注意事项
- 大版本差异：从 3.2 → 5.0 属于颠覆式重构，URL 路由、模型、控制器、命名空间与配置加载等均有明显变化，通常需要较大改造，不建议直接跨级升级。
- 5.x 内部升级要点：
- 5.0RC4 → 5.0：路由定义后原 URL 禁止访问；环境变量改用 .env（INI 格式）；模型 save() 返回受影响记录数；部分驱动与默认行为调整。
- 5.0 → 5.0.1：扩展配置参数 extra_config_list 废弃；查询构造器优先使用命名参数绑定；file_get_contents(‘php://input’) 改为 Request::getInput()；File 类 md5()/sha1() 改为 hash(‘md5’)/hash(‘sha1’)。
- 5.0.1 → 5.0.2：部分模型属性/方法由静态改为动态；join/view 方法第一个参数规范化；空操作方法 _empty 无需参数。
四 验证与回滚
- 功能与回归测试：对关键业务、数据库操作、路由与第三方扩展逐项回归测试；关注 PHP 错误日志 与框架日志，必要时使用框架命令（如 php think version）核对版本。
- 快速回滚：若使用 Git，直接切回升级前提交并恢复依赖（如 composer install）；若采用替换法，用备份覆盖框架目录并恢复配置与数据库。
