Lzh on GitHub

版本控制方案

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

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

命名参数

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

支持政策

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

版本PHP (*)发布错误修复截止日期安全修复截止日期
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 日
138.3 - 8.42026 年第 1 季度2027 年第 3 季度2028 年第 1 季度
  • 生命周期结束
  • 仅限安全修复 (*) 支持的 PHP 版本

Laravel 12

Laravel 12 通过更新上游依赖项并引入用于 React、Vue 和 Livewire 的新入门套件(包括使用 WorkOS AuthKit 进行用户身份验证的选项),继续了 Laravel 11.x 中所做的改进。我们的入门套件的 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 将不再获得额外的更新。

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