linux laravel怎样升级

在 Linux 服务器上升级 Laravel，通常分为 升级 Laravel 框架本身 和 相关依赖。下面按常见场景给你一个清晰流程和注意事项。

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

1. 备份

# 项目备份
cp -r /var/www/your-project /var/www/your-project-backup

# 数据库备份
mysqldump -u user -p dbname > db_backup.sql

2. 查看当前版本

php artisan --version

3. 检查 PHP 版本要求

不同 Laravel 版本对 PHP 有要求，例如：

Laravel 9 → PHP 8.0+
Laravel 10 → PHP 8.1+
Laravel 11 → PHP 8.2+

php -v

二、通过 Composer 升级（最常用）

1. 进入项目目录

cd /var/www/your-project

2. 更新依赖

composer update

3. 升级到指定 Laravel 版本

例如升级到 Laravel 10：

composer require laravel/framework:^10.0

如果是大版本升级（如 9 → 10）：

composer update laravel/framework

三、按官方升级指南修改代码（关键）

⚠️ 只改 composer 版本通常不够

去官方文档查看对应升级指南：

https://laravel.com/docs/upgrade

常见需要修改的地方：

config/ 配置文件
app/Providers/
废弃的方法（如 Str::random() 变化）
中间件变化

四、清理并重新生成

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

php artisan optimize:clear

五、运行数据库迁移（如有变更）

php artisan migrate --force

六、常见问题排查

1. Composer 内存不足

COMPOSER_MEMORY_LIMIT=-1 composer update

2. PHP 版本不匹配

使用 Laravel 官方推荐方式：

sudo update-alternatives --set php /usr/bin/php8.2

3. 权限问题

chown -R www-data:www-data storage bootstrap/cache
chmod -R 775 storage bootstrap/cache

七、推荐升级方式（最稳妥）

使用 Laravel Shift（官方推荐付费工具）：

https://laravelshift.com/

适合：

大版本升级
生产环境
不想手动改代码

八、示例：Laravel 9 → 10 简要流程

php -v # 确认 PHP 8.1+
composer require laravel/framework:^10.0
# 按官方文档改代码
php artisan optimize:clear
php artisan migrate --force

如果你愿意，可以告诉我：

当前 Laravel 版本
目标版本
是本地还是生产服务器

我可以给你精确到版本的升级步骤。