跳至内容

发行说明

版本控制方案

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

当你在应用程序或扩展包中引用 Laravel 框架或其组件时,应始终使用版本约束,例如^12.0,因为 Laravel 的主要版本确实包含重大变更。然而,我们始终致力于确保你可以在一天或更短的时间内更新到新的主要版本。

命名参数

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

支持政策

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

版本 PHP (*) 发布 错误修复直至 安全修复直至
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日
十三 8.3 - 8.4 2026 年第一季度 2027 年第三季度 2028 年第一季度
生命终结
仅限安全修复

(*)支持的 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 将不再收到额外的更新。

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