Ubuntu 下 ThinkPHP 如何升级

在 Ubuntu 下升级 ThinkPHP（无论是 5.x 升级到 6.x，还是小版本升级），一般可以按下面步骤来。下面以 Composer 安装的 ThinkPHP 为主（官方推荐方式）。

一、升级前准备（非常重要）

1. 备份项目

cp -r /var/www/your_project /var/www/your_project_backup

同时备份数据库：

mysqldump -u user -p dbname > db_backup.sql

2. 查看当前版本

cat composer.json | grep thinkphp
# 或
php think version

3. 检查 PHP 版本

ThinkPHP 版本对 PHP 有要求：

TP 5.1 → PHP ≥ 7.1
TP 6.0 → PHP ≥ 7.2.5
TP 6.1 → PHP ≥ 7.2.5

查看 PHP 版本：

php -v

二、使用 Composer 升级（推荐）

1. 进入项目目录

cd /var/www/your_project

2. 更新 Composer（可选）

composer self-update

3. 升级 ThinkPHP

小版本升级（如 6.0.x → 6.0.y）

composer update topthink/framework

大版本升级（如 5.1 → 6.0）

⚠️ 不能直接升级，需要手动迁移

通常需要：

修改 composer.json
调整目录结构
修改配置文件
修改代码（命名空间、废弃方法）

示例（升级到 TP6）：

"require": {
    "php": ">=7.2.5",
    "topthink/framework": "^6.0"
}

然后执行：

composer update

三、清除缓存（Ubuntu 下很重要）

php think clear
# 或手动删除
rm -rf runtime/cache/*
rm -rf runtime/log/*

如果是 Nginx + PHP-FPM：

sudo systemctl reload php8.1-fpm
sudo systemctl reload nginx

四、检查运行是否正常

php think run
# 或访问网站
curl http://localhost

查看错误日志：

tail -f runtime/log/*.log

五、非 Composer 安装（不推荐）

如果你是用 源码包 安装的：

下载新版本
覆盖 thinkphp/ 目录
手动对比 config/、application/
极易出问题，不建议

六、常见升级问题

1. 权限问题

sudo chown -R www-data:www-data /var/www/your_project
sudo chmod -R 755 /var/www/your_project

2. Composer 内存不足

COMPOSER_MEMORY_LIMIT=-1 composer update

3. 旧代码不兼容

Controller 不再自动加载
路由方式变化
配置目录结构调整

七、推荐升级路线

TP5.0 → TP5.1（小升级）
TP5.1 → TP6.0（大升级，需重构）
TP6.0 → TP6.1（小升级）

如果你能告诉我：

当前 TP 版本
PHP 版本
是否是 Composer 安装

我可以给你精确的升级命令和注意事项。