Skip to content

发布说明

版本控制方案

Laravel 及其其他第一方包遵循语义化版本控制。主要框架版本每年发布一次(大约在第一季度),而次要和补丁版本可能每周发布。次要和补丁版本绝不应包含破坏性更改。

在应用程序或包中引用 Laravel 框架或其组件时,您应始终使用诸如 ^12.0 之类的版本约束,因为 Laravel 的主要版本确实包含破坏性更改。然而,我们努力确保您可以在一天或更短时间内更新到新的主要版本。

命名参数

命名参数不在 Laravel 的向后兼容性指南的覆盖范围内。我们可能会在必要时重命名函数参数,以改进 Laravel 代码库。因此,在调用 Laravel 方法时使用命名参数应谨慎,并理解参数名称可能会在将来更改。

支持政策

对于所有 Laravel 版本,提供 18 个月的错误修复和 2 年的安全修复。对于所有附加库,包括 Lumen,只有最新的主要版本会收到错误修复。此外,请查看 Laravel 支持的数据库版本

版本PHP (*)发布错误修复截止日期安全修复截止日期
98.0 - 8.22022年2月8日2023年8月8日2024年2月6日
108.1 - 8.32023年2月14日2024年8月6日2025年2月4日
118.2 - 8.42024年3月12日2025年9月3日2026年3月12日
128.2 - 8.42025年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 将不再接收额外更新。

要开始使用我们的新启动套件,请查看 启动套件文档