发行说明
版本控制方案
Laravel 及其其他第一方软件包遵循 语义化版本控制。主要框架版本每年发布一次(~Q1),而次要版本和补丁版本可能每周都会发布。次要版本和补丁版本绝不应包含破坏性更改。
当从您的应用程序或软件包中引用 Laravel 框架或其组件时,您应始终使用版本约束,例如 ^11.0
,因为 Laravel 的主要版本确实包含破坏性更改。但是,我们努力始终确保您可以在一天或更短的时间内更新到新的主要版本。
命名参数
命名参数 不在 Laravel 的向后兼容性指南的涵盖范围内。我们可能会在必要时选择重命名函数参数,以改进 Laravel 代码库。因此,在调用 Laravel 方法时使用命名参数应谨慎进行,并理解参数名称将来可能会更改。
支持策略
对于所有 Laravel 版本,错误修复提供 18 个月,安全修复提供 2 年。对于所有其他库(包括 Lumen),只有最新的主要版本会收到错误修复。此外,请查看 Laravel 支持的数据库版本。
版本 | PHP (*) | 发布 | 错误修复截止日期 | 安全修复截止日期 |
---|---|---|---|---|
9 | 8.0 - 8.2 | 2022 年 2 月 8 日 | 2023 年 8 月 8 日 | 2024 年 2 月 6 日 |
10 | 8.1 - 8.3 | 2023 年 2 月 14 日 | 2024 年 8 月 6 日 | 2025 年 2 月 4 日 |
11 | 8.2 - 8.4 | 2024 年 3 月 12 日 | 2025 年 9 月 3 日 | 2026 年 3 月 12 日 |
12 | 8.2 - 8.4 | 2025 年 2 月 24 日 | 2026 年 8 月 13 日 | 2027 年 2 月 24 日 |
(*) 支持的 PHP 版本
Laravel 12
Laravel 12 通过更新上游依赖项并为 React、Vue 和 Livewire 引入新的入门套件,延续了 Laravel 11.x 中所做的改进,包括使用 WorkOS AuthKit 进行用户身份验证的选项。我们的入门套件的 WorkOS 变体提供社交身份验证、通行密钥和 SSO 支持。
最小破坏性更改
在此版本周期中,我们的重点主要放在最大限度地减少破坏性更改。相反,我们致力于在全年内持续发布不会破坏现有应用程序的生活质量改进。
因此,Laravel 12 版本是一个相对较小的“维护版本”,目的是升级现有依赖项。鉴于此,大多数 Laravel 应用程序可以升级到 Laravel 12 而无需更改任何应用程序代码。
新的应用程序入门套件
Laravel 12 为 React、Vue 和 Livewire 引入了新的应用程序入门套件。React 和 Vue 入门套件使用 Inertia 2、TypeScript、shadcn/ui 和 Tailwind,而 Livewire 入门套件使用基于 Tailwind 的 Flux UI 组件库和 Laravel Volt。
React、Vue 和 Livewire 入门套件都利用 Laravel 的内置身份验证系统来提供登录、注册、密码重置、邮箱验证等功能。此外,我们正在为每个入门套件引入 WorkOS AuthKit 驱动的变体,提供社交身份验证、通行密钥和 SSO 支持。WorkOS 为每月活跃用户数不超过 100 万的应用程序提供免费身份验证。
随着我们新的应用程序入门套件的推出,Laravel Breeze 和 Laravel Jetstream 将不再收到其他更新。
要开始使用我们的新入门套件,请查看入门套件文档。