Ubuntu上Laravel版本如何升级

Ubuntu上升级Laravel版本的完整流程

一、升级前准备

1. 备份项目与数据库
   升级前必须全量备份项目代码（可通过tar -czvf laravel_project_backup.tar.gz /path/to/project压缩）和数据库（使用mysqldump -u username -p database_name > backup.sql或云服务商快照功能），确保升级失败时可快速回滚。
2. 检查PHP版本兼容性
   新版本Laravel对PHP有明确要求（如Laravel 11需PHP 8.2+）。在Ubuntu终端运行php -v确认当前PHP版本，若不满足，需先升级PHP（例如升级到PHP 8.2：添加Ondřej Surý的PPA源sudo add-apt-repository ppa:ondrej/php，然后运行sudo apt-get update && sudo apt-get install php8.2 php8.2-cli php8.2-mbstring php8.2-xml php8.2-mysql，最后切换默认版本sudo update-alternatives --config php）。
3. 更新Composer与项目依赖
   确保Composer为最新版本（composer self-update），然后在项目根目录运行composer update更新现有依赖，解决潜在的依赖冲突。
4. 阅读官方升级指南
   根据目标版本查阅Laravel官方升级日志（如从L10升级到L11，需阅读UPGRADE.md或对应版本文档），重点关注破坏性变更（如命名空间调整、方法签名修改、配置文件变动），提前规划代码适配方案。

二、执行升级操作

1. 修改composer.json文件
   调整require部分的laravel/framework版本（如升级到L11则改为"laravel/framework": "^11.0"），同时检查并更新其他Laravel生态包（如laravel/sanctum、laravel/tinker、spatie/laravel-ignition）的版本，确保与目标Laravel版本兼容。
2. 通过Composer更新Laravel
   在项目根目录运行composer update laravel/framework（精确更新Laravel框架）或composer update（更新所有依赖），等待Composer解析依赖并完成安装。此过程可能因依赖冲突需手动干预（如删除vendor目录后重新运行composer install）。
3. 适配代码与配置变更
   • 合并配置文件：新版本Laravel可能新增或修改配置文件（如config/app.php、config/database.php），不要直接覆盖现有文件，而是通过代码对比工具（如VS Code的Diff功能）合并差异，保留自定义配置（如邮件驱动、缓存驱动）。
   • 处理破坏性变更：根据升级指南修改代码，例如Laravel 9+移除了php artisan optimize命令，需删除项目中的相关调用；Laravel 10调整了中间件的注册方式，需更新app/Http/Kernel.php文件。
   • 更新第三方包：检查composer.json中的第三方包（如laravel/ui、intervention/image）是否支持目标Laravel版本，若有更新则运行composer update package/name，避免兼容性问题。

三、升级后验证

1. 运行数据库迁移
   若新版本包含数据库结构变更（如新增表、修改字段），运行php artisan migrate应用迁移。若迁移失败，需检查SQL语句（如字段类型兼容性）和Eloquent模型（如属性类型声明），调整后重试。
2. 测试应用功能
   • 自动化测试：运行php artisan test执行单元测试、功能测试，确保核心业务逻辑未受影响。
   • 手动测试：重点测试核心流程（如登录、支付、文件上传）和第三方集成（如支付接口、短信服务），确保功能正常。
3. 重启Web服务器
   若使用Apache，运行sudo service apache2 restart；若使用Nginx，运行sudo service nginx restart，使配置变更生效。