发布说明
版本控制方案
Laravel 及其其他第一方包遵循语义化版本控制。主要框架版本每年发布一次(大约在第一季度),而次要和补丁版本可能每周发布。次要和补丁版本绝不应包含破坏性更改。
在应用程序或包中引用 Laravel 框架或其组件时,您应始终使用诸如 ^12.0 之类的版本约束,因为 Laravel 的主要版本确实包含破坏性更改。然而,我们努力确保您可以在一天或更短时间内更新到新的主要版本。
命名参数
命名参数不在 Laravel 的向后兼容性指南的覆盖范围内。我们可能会在必要时重命名函数参数,以改进 Laravel 代码库。因此,在调用 Laravel 方法时使用命名参数应谨慎,并理解参数名称可能会在将来更改。
支持政策
对于所有 Laravel 版本,bug 修复会提供 18 个月,安全修复会提供 2 年。对于所有额外的库,只有最新的主要版本会收到 bug 修复。此外,请查看 Laravel 支持的数据库版本。
| 版本 | PHP (*) | 发布日期 | Bug 修复截止 | 安全修复截止 |
|---|---|---|---|---|
| 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.5 | 2025年2月24日 | 2026年8月13日 | 2027年2月24日 |
| 13 | 8.3 - 8.5 | 2026年第一季度 | 2027年第三季度 | 2028年第一季度 |
(*) 支持的 PHP 版本
Laravel 12
Laravel 12 延续了 Laravel 11.x 所做的改进,更新了上游依赖,并为 React、Svelte、Vue 和 Livewire 引入了新的启动套件,包括使用 WorkOS AuthKit 进行用户认证的选项。我们启动套件的 WorkOS 变体提供了社交认证、通行密钥和单点登录支持。
最小化破坏性更改
在此发布周期中,我们的重点是最小化破坏性更改。相反,我们致力于在全年内提供不破坏现有应用程序的持续质量改进。
因此,Laravel 12 版本是一个相对较小的“维护版本”,以升级现有依赖项。鉴于此,大多数 Laravel 应用程序可以在不更改任何应用程序代码的情况下升级到 Laravel 12。
新的应用程序启动套件
Laravel 12 为 React、Svelte、Vue 和 Livewire 引入了新的应用程序启动套件。React、Svelte 和 Vue 启动套件使用了 Inertia 2、TypeScript、shadcn/ui 和 Tailwind,而 Livewire 启动套件则使用了基于 Tailwind 的 Flux UI 组件库和 Laravel Volt。
React、Svelte、Vue 和 Livewire 启动套件均利用 Laravel 内置的认证系统,提供登录、注册、密码重置、电子邮件验证等功能。此外,我们还为每个启动套件引入了基于 WorkOS AuthKit 的变体,提供社交认证、通行密钥和单点登录支持。WorkOS 为月活跃用户数不超过 100 万的应用程序提供免费认证服务。
随着我们新的应用程序启动套件的引入,Laravel Breeze 和 Laravel Jetstream 将不再接收额外更新。
要开始使用我们的新启动套件,请查看 启动套件文档。