Debian下Laravel如何升级

在 Debian 系统下升级 Laravel，一般可以按下面几个层次来操作，取决于你是升级小版本还是跨大版本。整体流程与操作系统无关，但在 Debian 上需要留意 PHP 版本和 系统依赖。

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

1️⃣ 备份项目

cp -r /var/www/your-project /var/www/your-project-backup

2️⃣ 确认当前版本

php artisan --version

3️⃣ 检查 PHP 版本是否满足目标 Laravel 要求

不同 Laravel 版本对 PHP 的要求：

查看 PHP 版本：

php -v

如果 PHP 版本不够，先升级 PHP（Debian 常见方式）：

sudo apt update
sudo apt install php8.2 php8.2-cli php8.2-common php8.2-mysql php8.2-mbstring php8.2-xml php8.2-curl

二、使用 Composer 升级 Laravel（推荐方式）

1️⃣ 进入项目目录

cd /var/www/your-project

2️⃣ 查看当前依赖

composer show laravel/framework

3️⃣ 升级 Laravel（示例）

✅ 升级到 Laravel 10

composer require laravel/framework:^10.0

✅ 升级到 Laravel 11

composer require laravel/framework:^11.0

⚠️ 跨大版本（如 9 → 10 或 10 → 11）不建议直接 require，应先查看官方升级指南。

三、跨大版本升级（推荐流程）

1️⃣ 参考官方升级文档

• Laravel 9 → 10
  https://laravel.com/docs/10.x/upgrade
• Laravel 10 → 11
  https://laravel.com/docs/11.x/upgrade

2️⃣ 修改 composer.json

例如从 10 → 11：

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

并升级常用依赖：

"require": {
    "guzzlehttp/guzzle": "^7.8",
    "laravel/sanctum": "^4.0"
}

3️⃣ 更新依赖

composer update

四、升级后必须执行的操作

1️⃣ 清理缓存

php artisan optimize:clear

2️⃣ 检查配置是否需要更新

php artisan config:cache
php artisan route:cache

⚠️ 升级大版本后，不要立即缓存配置，先测试。

3️⃣ 检查是否有废弃功能

php artisan route:list
php artisan view:cache

五、常见问题（Debian 特有）

❌ 1. Composer 内存不足

COMPOSER_MEMORY_LIMIT=-1 composer update

❌ 2. PHP 扩展缺失

常见错误：

ext-gd, ext-zip, ext-intl missing

安装：

sudo apt install php8.2-gd php8.2-zip php8.2-intl

❌ 3. 权限问题

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

六、升级建议总结

✅ 小版本升级

composer update laravel/framework

✅ 大版本升级

1. 看官方升级文档
2. 升级 PHP
3. 修改 composer.json
4. 执行 composer update
5. 修复废弃 API

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

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

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