0

0

Laravel如何升级到最新版本?(升级指南和步骤)

穿越時空

穿越時空

发布时间:2026-01-01 17:22:02

|

626人浏览过

|

来源于php中文网

原创

laravel 11 升级需分三步:先确认环境(php ≥8.2)、备份并新建分支;再更新 composer.json 及依赖,运行 php artisan upgrade 迁移结构;最后验证缓存、测试、集成与日志,准备回滚。

laravel如何升级到最新版本?(升级指南和步骤)

直接升级 Laravel 到最新主版本不是改个数字就完事,关键在控制风险、适配变更、验证结果。Laravel 11 是当前最新稳定版(截至 2025 年底),它对 PHP 8.2+ 有硬性要求,且结构精简、内核重构,跳过中间版本容易出问题。

先确认环境和备份

这是所有操作的前提,不能省略:

  • 运行 php -v 确认 PHP 版本 ≥ 8.2;低于则先升级 PHP
  • 执行 php artisan --version 查看当前 Laravel 版本,判断升级跨度(例如从 9 → 11 就不建议跳过 10)
  • git checkout -b upgrade-to-11 新建分支,避免污染主干
  • 完整备份代码 + 数据库 + config/.env 文件

更新 composer.json 并拉取依赖

核心是让 Composer 解析新版依赖树,同时兼顾生态包兼容性:

Ecshop批量生成购买记录自动评价插件
Ecshop批量生成购买记录自动评价插件

本插件支持2.7.2和2.7.3最新UTF-8版本最新升级(2012-10-08)1.可以批量选择商品生成评价和购买记录2.可以灵活控制生成的购买数量和评价数量.真正的真实购买记录.( 新升级版本改动如下:生成评价的时候会随机隐藏某些评价.只生成购买记录(你也可以自己选择某些要隐藏的评价).这样购买数量和评价数量相差40%左右,提高真实性 )生成的购买数量和评价数量 是真正的黄金比例,进一步提高真

下载
  • 打开 composer.json,修改 "laravel/framework": "^11.0"(原为 ^10.0 或更低)
  • 同步更新配套包:如 "laravel/sanctum": "^4.0""spatie/laravel-ignition": "^2.4""nunomaduro/collision": "^8.1"
  • 检查 "php" 行是否已改为 "^8.2",否则 Composer 会拒绝安装
  • 保存后运行 composer update --with-all-dependencies,避免部分包被锁死

处理结构性与代码级变更

Laravel 11 引入了轻量应用结构,默认不生成 app/Http/Controllers 等目录,还需调整多处逻辑:

  • 运行 php artisan upgrade(需先 composer require laravel/upgrade --dev),自动迁移目录结构和配置
  • 检查 AppServiceProvider:register/boot 方法签名未变,但部分绑定方式推荐改用容器扩展
  • HTTP 内核中中间件组定义方式简化,旧的 $middlewareGroups 需按新模板重写
  • 移除所有 illuminate/* 的手动 require(Laravel 11 已统一由框架管理)
  • 搜索项目中 str()array_* 辅助函数调用,替换为 Str::Arr:: 命名空间调用

验证与上线前收尾

升级完成≠可用,必须逐层验证:

  • 清空缓存:php artisan config:clear && php artisan cache:clear && php artisan view:clear
  • 运行全部测试:phpunitphp artisan test,重点关注认证、队列、API 响应
  • 手动触发一次备份、邮件通知、队列任务,确认第三方集成未中断
  • 在预发布环境跑 24 小时,监控日志中的 DeprecatedUndefined array key 类警告
  • 准备好回滚命令:git checkout main && composer install && php artisan migrate:rollback

基本上就这些。不复杂但容易忽略细节,尤其是跨大版本时的配置迁移和第三方包适配。官方 UPGRADING.mdchangelog.md 比任何教程都准,建议边操作边对照着看。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

338

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

290

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

708

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

384

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

133

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

82

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

75

2025.08.05

composer是什么插件
composer是什么插件

Composer是一个PHP的依赖管理工具,它可以帮助开发者在PHP项目中管理和安装依赖的库文件。Composer通过一个中央化的存储库来管理所有的依赖库文件,这个存储库包含了各种可用的依赖库的信息和版本信息。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

161

2023.12.25

Swift iOS架构设计与MVVM模式实战
Swift iOS架构设计与MVVM模式实战

本专题聚焦 Swift 在 iOS 应用架构设计中的实践,系统讲解 MVVM 模式的核心思想、数据绑定机制、模块拆分策略以及组件化开发方法。内容涵盖网络层封装、状态管理、依赖注入与性能优化技巧。通过完整项目案例,帮助开发者构建结构清晰、可维护性强的 iOS 应用架构体系。

0

2026.03.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 12.8万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号