温馨提示×

怎样在debian升级laravel版本

小樊
47
2026-10-02 07:51:46
栏目: 智能运维

在 Debian 上“升级 Laravel 版本”通常包含两部分:系统/运行环境准备 和 Laravel 项目本身升级。下面按常见场景给你一个清晰流程。


一、升级前的准备(重要)

1. 备份项目和数据库

# 项目备份
cp -r /var/www/your_project /var/www/your_project_backup

# 数据库备份
mysqldump -u user -p dbname > db_backup.sql

2. 检查当前 Laravel 版本

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

二、升级 PHP(Laravel 新版本通常需要更高 PHP)

以 Laravel 10/11 为例,通常需要 PHP 8.1+

添加 Sury PHP 源(推荐)

sudo apt install -y lsb-release ca-certificates apt-transport-https software-properties-common
sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
sudo sh -c 'echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'
sudo apt update

安装或升级 PHP

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

设置默认 PHP:

sudo update-alternatives --set php /usr/bin/php8.2

三、升级 Composer(Laravel 新版本需要 Composer 2)

sudo apt remove composer
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
composer --version

四、升级 Laravel 项目本身

方式一:使用 Composer 直接升级(常见)

编辑 composer.json:

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

然后执行:

composer update
php artisan migrate
php artisan config:clear
php artisan cache:clear

方式二:使用 Laravel 升级指南(推荐大版本)

官方升级文档:

  • https://laravel.com/docs/upgrade

常见大版本注意点:

  • config/ 文件变化
  • 废弃方法
  • 路由/中间件变化

五、Web 服务器调整(Nginx / Apache)

Nginx 示例

确认 fastcgi_pass 指向新 PHP:

fastcgi_pass unix:/run/php/php8.2-fpm.sock;

重启服务:

sudo systemctl restart nginx php8.2-fpm

六、验证升级

php artisan --version
php artisan route:list
php artisan migrate --dry-run

七、常见问题

1. 权限问题

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

2. 扩展缺失

常见扩展:

php8.2-bcmath php8.2-intl php8.2-gd

如果你能告诉我:

  • 当前 Laravel 版本
  • Debian 版本
  • PHP 版本

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

0 踩