Laravel升级需遵循官方步骤并注意兼容性,先确认当前版本及目标版本支持周期,不可跨多版本直接升级;从10.x升至11.x需依次递进。备份代码与数据库,检查PHP环境(如8.2+)及第三方包兼容性,更新composer.json中laravel/framework等依赖为^11.0,执行composer update --with-all-dependencies。根据升级指南调整代码,如移除废弃Facades、更新配置文件、处理Kernel结构变化,可能需手动引入辅助函数。完成后运行php artisan test测试功能,清除缓存并重建自动加载。建议在独立分支操作,确保平稳过渡。

Laravel 的升级流程其实并不复杂,只要遵循官方推荐的步骤,并注意版本间的兼容性变化,就能顺利完成。Laravel 每年发布两个主版本(如 9.x、10.x、11.x),每个版本都有明确的支持周期,因此及时升级有助于获得新功能、性能优化和安全补丁。
确认当前版本与目标版本
在开始升级前,先查看你当前使用的 Laravel 版本:
php artisan --version然后访问 Laravel 官方文档,找到你想升级到的最新版本对应的升级指南(通常在“Upgrade Guide”一栏中)。例如从 10.x 升级到 11.x,需查阅《Upgrade Guide: 11.x》。
注意: Laravel 不支持跨多个主版本直接升级。比如从 9.x 跳到 11.x 必须先升到 10.x,再升到 11.x。备份项目与环境准备
升级前务必做好以下准备:
- 提交所有代码变更到 Git 或其他版本控制系统
- 备份数据库和重要配置文件(如 .env)
- 确保本地开发环境满足新版 Laravel 的 PHP 扩展和版本要求(如 Laravel 11 需要 PHP 8.2+)
- 检查第三方包是否兼容目标版本,尤其是常用扩展包如 Laravel Sanctum、Sail、Jetstream 等
修改 composer.json 文件
打开项目的 composer.json 文件,更新 Laravel 相关依赖的版本号。
以从 Laravel 10 升级到 11 为例:
"require": {
"php": "^8.2",
"laravel/framework": "^11.0",
"laravel/fortify": "^1.20", // 若使用
"laravel/sanctum": "^4.0"
},
"require-dev": {
"laravel/pint": "^1.13",
"laravel/sail": "^1.27",
"phpunit/phpunit": "^11.0"
}
同时检查并更新其他依赖项,确保它们与 Laravel 11 兼容。
执行依赖更新与代码调整
运行以下命令更新依赖:
具备更多的新特性: A.具有集成度更高的平台特点,集中体现了信息、文档在办公活动中交流的开放性与即时性的重要。 B.提供给管理员的管理工具,使系统更易于管理和维护。 C.产品本身精干的体系结构再加之结合了插件的设计思想,使得产品为用户度身定制新模块变得非常快捷。 D.支持对后续版本的平滑升级。 E.最价的流程管理功能。 F.最佳的网络安全性及个性化
如果出现冲突,可尝试:
composer update --with-all-dependencies完成后,根据升级指南进行必要的代码调整。常见变更包括:
- 移除废弃的 Facades 或类调用
- 更新配置文件中的过时选项(config/app.php、config/cache.php 等)
- 处理服务提供者或引导逻辑的变化(如 $bootstrappers 数组调整)
- 检查中间件注册方式是否改变(特别是 Laravel 11 中简化了 Kernel 结构)
例如,Laravel 11 移除了部分全局辅助函数的默认加载,可能需要手动引入或启用。
运行测试与验证功能
升级完成后,执行以下操作验证系统稳定性:
- 运行 PHPUnit 测试:php artisan test
- 访问关键页面,检查是否有异常报错
- 清除缓存:php artisan config:clear && php artisan route:clear
- 重新生成自动加载映射:composer dump-autoload
若使用了模型工厂、种子文件或自定义 Artisan 命令,也需确认其是否正常工作。
基本上就这些。只要一步步来,关注官方升级说明,大多数项目都能平稳过渡到最新 Laravel 版本。不复杂但容易忽略的是第三方包兼容性和 PHP 环境匹配问题,建议在独立分支中完成升级后再合并上线。









