如何升级Debian的Laravel

在 Debian 上升级 Laravel，通常分为 Laravel 框架升级 和 Debian 系统环境升级 两部分。下面按常见场景给你一个完整、安全的升级流程。

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

1️⃣ 备份项目

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

2️⃣ 确认当前 Laravel 版本

cd /var/www/your_project
php artisan --version

3️⃣ 查看 PHP 版本（Laravel 对 PHP 有要求）

php -v

二、升级 Debian 上的 PHP（如需要）

1️⃣ 添加 Sury PHP 源（推荐）

sudo apt update
sudo apt install -y lsb-release ca-certificates curl
curl -sSLo /tmp/debsuryorg-archive-keyring.deb https://packages.sury.org/debsuryorg-archive-keyring.deb
sudo dpkg -i /tmp/debsuryorg-archive-keyring.deb
echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/sury-php.list

2️⃣ 安装新版 PHP

例如 PHP 8.2：

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

3️⃣ 切换 PHP 版本（如有多版本）

sudo update-alternatives --config php

三、升级 Laravel 框架（核心步骤）

✅ 方法一：使用 Composer（最常见）

1️⃣ 进入项目目录

cd /var/www/your_project

2️⃣ 查看当前依赖

composer show laravel/framework

3️⃣ 修改版本要求

nano composer.json

示例（升级到 Laravel 10）：

"require": {
    "laravel/framework": "^10.0"
}

4️⃣ 执行升级

composer update laravel/framework --with-dependencies

⚠️ 如果遇到错误，可加：

composer update --no-scripts

四、处理升级后的常见事项

1️⃣ 清理缓存

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

2️⃣ 执行数据库迁移（如有变更）

php artisan migrate

3️⃣ 检查配置是否兼容

php artisan route:list
php artisan config:show

五、升级 Nginx / Apache（如需要）

Nginx 重启

sudo systemctl restart nginx

PHP-FPM 重启

sudo systemctl restart php8.2-fpm

六、常见错误及解决方法

❌ 1. PHP 版本过低

Your PHP version is too low

✅ 升级 PHP（见第二部分）

❌ 2. Composer 内存不足

COMPOSER_MEMORY_LIMIT=-1 composer update

❌ 3. 依赖冲突

composer why-not laravel/framework 10.*

七、推荐升级路径（安全）

Laravel 8 → 9 → 10 → 11

不要跨多个大版本直接升级。

八、我可以帮你进一步做什么？

你可以告诉我： 1️⃣ 当前 Laravel 版本
2️⃣ Debian 版本（cat /etc/debian_version）
3️⃣ 是否使用 Nginx / Apache
4️⃣ 报错信息（如果有）

我可以直接给你 针对你服务器的一键升级方案 ✅