linux laravel如何升级

linux

小樊

2026-10-27 19:27:35

栏目: 智能运维

在 Linux 服务器上升级 Laravel 一般分为几种情况：

升级 Laravel 框架本身（如 8 → 9 → 10 → 11）
升级 Laravel 项目依赖（composer update）
升级 PHP 版本（Laravel 对 PHP 有要求）

下面按最常见、最安全的流程说明。

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

1. 查看当前版本

php artisan --version

2. 查看 Laravel 官方升级指南

每个大版本都有独立文档：

https://laravel.com/docs/upgrade

例如：

8 → 9
9 → 10
10 → 11

⚠️ 跨大版本必须逐步升级，不能跳版本

3. 备份项目

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

数据库也备份：

mysqldump -u user -p dbname > db.sql

4. 确认 PHP 版本

Laravel 版本对应 PHP：

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

查看 PHP：

php -v

如不够，用：

sudo apt install php8.2

二、使用 Composer 升级 Laravel

1. 进入项目目录

cd /var/www/your-project

2. 修改 composer.json

例如升级到 Laravel 10：

"require": {
    "php": "^8.1",
    "laravel/framework": "^10.0"
}

或直接使用命令：

composer require laravel/framework:^10.0

3. 更新依赖

composer update

如报错：

composer update --with-all-dependencies

4. 执行 Laravel 升级命令

php artisan upgrade

（Laravel 9+ 支持）

5. 清理缓存

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

三、常见升级问题

1. 依赖冲突

composer why-not laravel/framework:^10.0

2. 第三方包不兼容

升级包版本
或暂时移除

3. Nginx / Apache 不生效

重启服务：

sudo systemctl restart nginx
sudo systemctl restart php8.2-fpm

四、仅更新小版本（安全更新）

composer update laravel/framework

五、总结流程（标准）

php artisan --version
备份项目 + 数据库
升级 PHP
修改 composer.json
composer update
php artisan upgrade
清理缓存

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

当前 Laravel 版本
PHP 版本
使用的 Linux（Ubuntu / CentOS）

我可以给你精确到版本的升级命令。