Laravel 每年第一季度发布一个主要版本,并在其间的大部分时间里发布次要版本和补丁版本。Laravel 13 是当前的主要版本,于 2026 年 3 月 17 日发布。 Laravel 14 预计将于 2027 年第一季度发布。
语义版本控制
Laravel及其第一方软件包遵循
语义版本控制
版本号的每个组成部分,例如:
13.33.0
具有固定含义:
- 主要的
(
13当版本包含重大变更时,会发生更改。 - 次要的
(
33当版本以向后兼容的方式添加功能时,就会发生变化。 - 修补
(
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 发行说明 . 即将发布的主要版本日期均为预估日期,直至各版本正式发布为止。







