消息

Laravel 发布周期:版本、支持策略和日期

发布
Laravel 发布周期:版本、支持策略和日期(图片)

Laravel 每年第一季度发布一个主要版本,并在其间的大部分时间里发布次要版本和补丁版本。Laravel 13 是当前的主要版本,于 2026 年 3 月 17 日发布。 Laravel 14 预计将于 2027 年第一季度发布。

语义版本控制

Laravel及其第一方软件包遵循 语义版本控制 版本号的每个组成部分,例如: 13.33.0 具有固定含义:

  1. 主要的 ( 13 当版本包含重大变更时,会发生更改。
  2. 次要的 ( 33 当版本以向后兼容的方式添加功能时,就会发生变化。
  3. 修补 ( 0 )当版本仅包含向后兼容的错误修复时会发生变化

在 Laravel 6 之前,该框架使用第二个数字来表示主要版本号,因此 5.4 到 5.5 的版本升级可能会导致应用程序出现问题。 切换到语义化版本控制 Laravel 6 于 2019 年 9 月发布。从那时起,像 6.1 到 6.2 这样的版本升级意味着新增功能,但不会有破坏性变更。

每周小版本更新和补丁发布

Laravel 团队每周都会发布框架版本,通常是在周二。新增功能的版本号会增加次版本号,而仅修复 bug 的版本号会增加补丁版本号。Laravel 13.0 于 2026 年 3 月发布,到 2026 年 9 月 22 日,该框架已更新至…… Laravel 13.33 。

三十多岁的小数字并不意味着你落后了。 发行说明 声明指出,次要版本和补丁版本绝不能包含破坏性变更,因此从 13.1 升级到 13.33 是不可取的。 composer update Laravel News 会报道每周的版本更新,一年多来,这些版本更新包含了该框架的大部分新功能。

年度主要发行

Laravel 每六个月发布一个主要版本,直到 Laravel 8。2021 年 1 月,Taylor Otwell 宣布转向年度主要版本发布周期 他的理由是减少社区的维护工作量,并在年内发布新功能而不破坏向后兼容性。

Laravel 9 原计划于 2021 年 9 月发布,但团队 推迟至2022年2月 因此它可以与 Symfony 6.0 组件一起发布。自那以后,每年的主要版本都会在年初发布:

  • Laravel 9:2022年2月8日
  • Laravel 10:2023年2月14日
  • Laravel 11:2024 年 3 月 12 日发布
  • Laravel 12:2025年2月24日
  • Laravel 13:2026 年 3 月 17 日发布

目前的版本说明将发布计划描述为“每年(~第一季度)”,因此主要版本可能会在二月或三月发布。

由于大多数功能都是在小版本中发布的,因此现在的主版本更新只会保留那些会破坏现有功能的更改,而且升级幅度通常很小。摘自 Laravel 13 发布说明:

在本版本发布周期中,我们的工作重点是尽可能减少破坏性变更。相反,我们致力于全年持续推出提升用户体验的改进措施,这些措施不会破坏现有应用程序。

提高 PHP 最低版本要求属于破坏性变更之一。 Laravel 13 需要 PHP 8.3,而 Laravel 14 将需要 PHP 8.4。

支持政策

Laravel 的每个主要版本都会获得 18 个月的 bug 修复支持和两年的安全修复支持。目前已不再发布长期支持 (LTS) 版本。Laravel 6 是最后一个 LTS 版本,此后的每个主要版本都遵循相同的支持期限。

对于其他第一方库,只有最新的主要版本才会获得错误修复。

版本 PHP 发布 错误修复直至 安全修复直至
14 8.4+ 预计2027年第一季度 2028年第三季度 2029年第一季度
13 8.3 - 8.5 2026年3月17日 2027年第三季度 2028年3月17日
12 8.2 - 8.5 2025年2月24日 2026年8月13日 2027年2月24日
11 8.2 - 8.4 2024年3月12日 2025年9月3日 2026年3月12日
10 8.1 - 8.3 2023年2月14日 2024 年 8 月 6 日 2025 年 2 月 4 日

截至本文撰写之时,Laravel 10 和 11 已停止维护。Laravel 12 仅接收安全修复,直至 2027 年 2 月 24 日。Laravel 13 是唯一继续接收 bug 修复的版本。

每年都会发布一个主要版本,而 bug 修复周期为 18 个月,因此在新版本发布后的几个月内,旧版本仍会继续获得 bug 修复。Laravel 13 于 2026 年 3 月 17 日发布,Laravel 12 的 bug 修复周期于 2026 年 8 月 13 日结束。规划主要版本升级时,应围绕这个较短的修复周期,而不是两年的安全周期。

发展发生在哪里

这 laravel/框架 存储库为每个主要版本保留一个分支( 11.x , 12.x , 13.x )和 master 下一个主要版本的分支。 贡献指南 设置拉取请求指向哪个分支的规则:

  • 错误修复程序会推送至最新接收错误修复的版本,目前 13.x
  • 向后兼容的功能也适用于 13.x 并将于下周发布
  • 重大变更和主要新功能将移至 master 即 Laravel 14

Laravel 14 的功能列表与一年来的其他产品相比显得很短。 13.x 出于这个原因,需要发布新版本。变更正在等待中。 master 只有当它向合约添加方法、更改方法签名或更改现有行为时,才会发生这种情况。 Laravel 14 文章 跟踪已合并的内容 master 迄今为止。

Composer 版本限制

在框架中使用插入符号约束 composer.json :

“要求” :{
“laravel/框架” : “^13.0”
}

这 ^13.0 约束接受所有 13.x 释放并停止 14.0 每周的小版本更新会陆续到来。 composer update 并且,重大升级将等到您更改约束条件后才会进行。

命名参数 不受 Laravel 向后兼容性指南的约束。团队可能会在小版本更新中重命名方法的参数,因此类似这样的调用可能会受到影响。 Cache::put(key: 'foo', value: 'bar') 即使没有重大版本更新,也可能出现问题。

升级到新的主要版本

发布说明指出,团队的目标是在一天或更短时间内完成新主要版本的升级。每个主要版本都有一个 升级指南 列出了所有重大变更,并评估了每项变更对您的应用程序造成影响的可能性。

Laravel 转变 它能自动进行重大升级,并为每次更改创建一个包含提交的拉取请求。它还能 利用人工智能实现更多升级过程的自动化 。

Laravel 版本发布历史

版本 发布 错误修复直至 安全修复直至
14 预计2027年第一季度 2028年第三季度 2029年第一季度
13 2026年3月17日 2027年第三季度 2028年3月17日
12 2025年2月24日 2026年8月13日 2027年2月24日
11 2024年3月12日 2025年9月3日 2026年3月12日
10 2023年2月14日 2024 年 8 月 6 日 2025 年 2 月 4 日
9 2022 年 2 月 8 日 2023 年 8 月 8 日 2024 年 2 月 6 日
8 2020年9月8日 2022年7月26日 2023年1月24日
7 2020年3月3日 2020年10月6日 2021年3月3日
6(LTS) 2019年9月3日 2022年1月25日 2022年9月6日
5.8 2019年2月26日 2019年8月26日 2020年2月26日
5.7 2018年9月4日 2019年3月4日 2019年9月4日
5.6 2018年2月7日 2018年8月7日 2019年2月7日
5.5(LTS) 2017年8月30日 2019年8月30日 2020年8月30日
5.4 2017年1月24日 2017年7月24日 2018年1月24日
5.3 2016年8月23日 2017年2月23日 2017年8月23日
5.2 2015年12月21日 2016年6月21日 2016年12月21日
5.1(LTS) 2015年6月9日 2017年6月9日 2018年6月9日
5.0 2015年2月4日 2015年8月4日 2016年2月4日
4 2013年5月 - -
3 2012年2月 - -
2 2011 年 9 月 - -
1 2011年6月 - -

当前支持日期列于此处 Laravel 发行说明 . 即将发布的主要版本日期均为预估日期,直至各版本正式发布为止。

保罗·雷德蒙德照片

Laravel News 特约撰稿人。全栈 Web 开发人员兼作家。

归档于

赞助

掌握 Laravel 标志
Laravel 代码审查

几天内即可获得 Laravel 代码审查方面的专家指导

访问 Laravel 代码审查
Laravel AI SDK 和 Laravel MCP 安全修复:立即更新 图片

Laravel AI SDK 和 Laravel MCP 安全修复:立即更新

阅读文章
Laravel 邮箱:预览和测试渲染后的邮件图片

Laravel 邮箱:预览和测试渲染后的邮件

阅读文章
Laravel 13.34 图片中将 Worker 崩溃计数作为作业异常

Laravel 13.34 中将 Worker 崩溃计数为作业异常

阅读文章
Elastic Bridge:Elasticsearch 和 OpenSearch 的 Eloquent 风格查询(图片)

Elastic Bridge:Elasticsearch 和 OpenSearch 的 Eloquent 风格查询

阅读文章
Unlearn.dev 将于 10 月 10 日和 11 日周末免费开放(图片)。

Unlearn.dev 将于 10 月 10 日和 11 日周末免费开放。

阅读文章
Tashil:Laravel 订阅计划和功能使用限制图片

Tashil:Laravel 订阅计划和功能使用限制

阅读文章