linux laravel如何升级版本

在 Linux 服务器上升级 Laravel 版本，一般按下面流程来（以 Laravel 9 → 10 / 10 → 11 为例，思路通用）。

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

1. 查看当前版本

php artisan --version

2. 查看 PHP 版本（Laravel 对 PHP 有要求）

php -v

常见要求：

• Laravel 10 → PHP 8.1+
• Laravel 11 → PHP 8.2+

3. 备份项目

cp -r project project_backup
# 或
tar -zcvf project_backup.tar.gz project

4. 备份数据库

mysqldump -u user -p database > db_backup.sql

二、升级 Laravel 核心版本

方式一：使用 Composer（推荐）

1. 修改 composer.json

例如升级到 Laravel 11：

"require": {
    "php": "^8.2",
    "laravel/framework": "^11.0",
    "laravel/sanctum": "^4.0"
}

2. 更新依赖

composer update

或指定升级：

composer require laravel/framework:^11.0

三、执行 Laravel 升级命令（Laravel 8+）

1. 更新框架文件

php artisan upgrade

（Laravel 9+ 支持，自动修改部分配置）

2. 清理缓存

php artisan config:clear
php artisan cache:clear
php artisan route:clear
php artisan view:clear

四、检查配置文件变化（容易踩坑）

1. 对比 config/ 目录

新版本可能新增配置项：

cp vendor/laravel/framework/config/* config/

⚠️ 不要直接覆盖，手动合并

2. 检查 app/Providers/

某些 ServiceProvider 在新版本被移除或改名

五、数据库 & 迁移

php artisan migrate --force

如果是大版本升级，建议先在 测试环境 跑一遍。

六、常见升级问题

1. Composer 版本过低

composer self-update

2. PHP 扩展缺失

常见扩展：

apt install php8.2-mbstring php8.2-xml php8.2-curl

3. 第三方包不兼容

composer why-not laravel/framework:^11.0

七、推荐升级顺序（安全）

1. 本地 / 测试环境
2. Git 分支升级
3. 跑测试
4. 再上生产

八、官方升级文档（必看）

• https://laravel.com/docs/upgrade

如果你告诉我：

• 当前 Laravel 版本
• 目标版本
• 使用的 PHP 版本

我可以给你 精确到命令的升级方案。