Debian上Laravel如何升级

在 Debian 上升级 Laravel，通常分为系统依赖准备、项目级升级和注意事项三部分。下面按常见场景说明。

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

1. 备份

cp -r /var/www/your-project /var/www/your-project-backup
mysqldump -u user -p dbname > db-backup.sql

2. 查看当前 Laravel 版本

php artisan --version

3. 检查 PHP 版本（Debian）

Laravel 对 PHP 有要求，例如：

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

php -v

如 PHP 版本不够，可：

sudo apt update
sudo apt install php8.2 php8.2-cli php8.2-fpm php8.2-mysql

二、项目内升级 Laravel（最常见）

方式一：小版本升级（如 10.10 → 10.20）

cd /var/www/your-project
composer update
php artisan migrate

方式二：大版本升级（如 Laravel 9 → 10 / 11）

1. 修改 composer.json

例如升级到 Laravel 11：

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

2. 更新依赖

composer update

3. 按官方升级指南修改代码

官方文档（必须看）：

https://laravel.com/docs/11.x/upgrade

常见改动：

• config/ 文件结构变化
• app/Http/Kernel.php 调整
• 路由、中间件变化

4. 清理缓存

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

5. 执行迁移

php artisan migrate --force

三、Debian 服务相关（如 Nginx + PHP-FPM）

重启 PHP-FPM

sudo systemctl restart php8.2-fpm

重启 Nginx

sudo systemctl restart nginx

设置正确权限

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

四、常见问题

1. composer 内存不足

COMPOSER_MEMORY_LIMIT=-1 composer update

2. 依赖冲突

composer why-not laravel/framework:^11.0

3. 使用 Laravel Installer（新项目）

composer global require laravel/installer

五、推荐升级流程总结

1. 备份代码 + 数据库
2. 升级 Debian PHP
3. 修改 composer.json
4. composer update
5. 按官方文档改代码
6. 清缓存 + 迁移
7. 重启服务

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

• 当前 Laravel 版本
• 目标版本
• Debian 版本（如 Debian 11 / 12）

我可以给你精确升级命令。