发布说明
版本控制方案
Laravel 及其其他第一方包遵循语义化版本控制。主要框架版本每年发布一次(大约在第一季度),而次要和补丁版本可能每周发布。次要和补丁版本绝不应包含破坏性更改。
在应用程序或包中引用 Laravel 框架或其组件时,您应始终使用诸如 ^12.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 继续改进 Laravel 11.x,通过更新上游依赖项并引入新的 React、Vue 和 Livewire 启动套件,包括使用 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 将不再接收额外更新。
要开始使用我们的新启动套件,请查看 启动套件文档。