debian怎么升级laravel

在 Debian 上升级 Laravel，通常取决于你是通过 Composer 安装的（最常见）。下面按「标准升级流程」和「常见场景」给你说明。

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

1️⃣ 备份项目

cp -r /var/www/your-project /var/www/your-project.bak

2️⃣ 确认 PHP 版本

Laravel 对 PHP 版本要求较严格：

Laravel 版本	最低 PHP
10.x	8.1
11.x	8.2

查看 PHP 版本：

php -v

如果 PHP 版本不够，先升级 PHP（Debian 12 示例）：

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

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

1️⃣ 进入项目目录

cd /var/www/your-project

2️⃣ 查看当前 Laravel 版本

php artisan --version

3️⃣ 升级 Laravel 框架

例如升级到 Laravel 10：

composer require laravel/framework:^10.0

或升级到最新稳定版：

composer update laravel/framework

4️⃣ 升级依赖

composer update

三、升级到 Laravel 11（大版本升级）

⚠️ 大版本升级建议先看官方升级指南

官方文档：

https://laravel.com/docs/upgrade

常见步骤：

composer require laravel/framework:^11.0
composer update

然后执行：

php artisan migrate
php artisan route:clear
php artisan config:clear
php artisan cache:clear

四、升级后检查

✅ 1. 检查 Laravel 版本

php artisan --version

✅ 2. 检查是否有报错

php artisan serve

✅ 3. 检查 PHP 扩展

常见缺失扩展：

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

五、如果你是用 APT 装 Laravel（不推荐）

Debian 官方仓库里的 Laravel 版本很旧，不建议使用。

❌ 错误方式：

sudo apt install laravel

✅ 正确方式：Composer 全局安装

composer global require laravel/installer

确保 ~/.composer/vendor/bin 在 PATH 中：

export PATH="$HOME/.composer/vendor/bin:$PATH"

六、常见问题

❓ composer 内存不足

COMPOSER_MEMORY_LIMIT=-1 composer update

❓ 权限问题

sudo chown -R www-data:www-data /var/www/your-project

七、总结（最简流程）

cd your-project
php -v
composer update laravel/framework
php artisan migrate
php artisan cache:clear

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

Laravel 当前版本
Debian 版本（10 / 11 / 12）
是否生产环境

我可以给你 精确的升级命令 ✅