ThinkPHP Linux版如何更新

Linux 下 ThinkPHP 更新步骤

一 准备与环境检查

• 确认当前版本与依赖
  • 查看框架版本：在项目根目录执行命令：php think version
  • 查看核心包版本：查看 composer.json 中的 topthink/framework 字段，或用命令：composer show topthink/framework
• 准备升级环境
  • 安装或升级 Composer（Linux）：执行
    • curl -sS https://getcomposer.org/installer | php
    • mv composer.phar /usr/local/bin/composer
  • 建议使用国内镜像加速：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
  • 如运行在面板（如宝塔），需放行被禁用的函数：putenv、pcntl_signal、proc_open、passthru
• 重要提醒
  • 自 ThinkPHP 6.0 起，必须通过 Composer 安装与更新，不再支持直接 Git 下载安装方式。

二 标准升级流程

• 备份与分支
  • 完整备份项目代码与数据库；使用 Git 的建议创建升级分支：git checkout -b feature/upgrade-thinkphp
• 在应用根目录执行更新
  • 更新核心框架包：composer update topthink/framework
  • 如需指定版本（示例：6.0.x）：composer require topthink/framework:^6.0
  • 存在依赖冲突时：composer update topthink/framework --with-dependencies
• 更新后验证
  • 查看新版本：php think version
  • 本地运行：php think run，访问 http://localhost:8000 验证是否正常运行
• 目录与影响说明
  • 更新操作会删除并重装框架目录（如 thinkphp/），但不会覆盖你的应用目录（如 app/ 或 application/），因此请勿在核心框架目录中放置业务代码。

三 不同版本与升级路径

• ThinkPHP 5.x
  • 推荐在应用根目录执行：composer update topthink/framework
  • 升级前阅读 5.x → 5.(x+1) 的官方升级说明，重点留意配置结构、废弃方法与路由变化
• ThinkPHP 6.x
  • 必须通过 Composer 管理：更新命令同上；如需安装开发版可用：composer create-project topthink=6.0.x-dev tp
• 跨大版本（如 5.x → 6.x 或 6.x → 8.x）
  • 不建议跨多版本直接升级；按官方升级指南逐步迁移
  • 可能需要调整目录结构（如 application → app）、入口引导、配置目录与中间件注册方式，并替换已弃用 API。

四 常见问题与处理

• 依赖冲突或不兼容
  • 使用：composer update topthink/framework --with-dependencies
  • 同步升级相关扩展包；必要时回退部分扩展版本
• 类/函数被废弃或命名空间变更
  • 按官方升级指南逐项替换；关注门面、中间件注册、模型时间戳等常见变更点
• 运行报错或访问异常
  • 开启调试：APP_DEBUG=true（在 .env 或环境变量中设置），查看报错堆栈定位问题
  • 本地验证：php think run；确保 Web 服务器将请求指向 public/ 目录
• 服务器环境限制
  • 如 putenv、pcntl_signal、proc_open、passthru 被禁用，需在面板或 php.ini 中解除禁用后再执行 Composer/框架命令。

五 上线与回滚建议

• 预发布验证
  • 在预发布环境完整回归核心业务（路由、数据库、缓存、上传、验证码等）
  • 必要时执行：php think optimize:schema 优化性能
• 上线与回滚
  • 选择低峰期发布，保留可回滚方案（代码与数据库备份、Git 回退分支）
  • 若出现异常，优先回滚到升级前备份或 Git 分支，再按问题点逐步修复后重跑升级流程。