发布记录

版本控制方案

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

当从您的应用程序或软件包中引用 Laravel 框架或其组件时，您应始终使用类似 ^12.0 的版本约束，因为 Laravel 的主要版本更新通常包含破坏性更改。不过，我们始终努力确保你能够在 一天之内或更短时间内 完成对新主版本的更新。

命名参数

命名参数 不在 Laravel 的向后兼容性指南覆盖范围内。为了改进 Laravel 的代码库，我们可能会在必要时对函数参数进行重命名。因此，在调用 Laravel 方法时使用命名参数应当谨慎，并且要理解：这些参数名称未来可能会发生变化。

支持政策

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

• (*) 支持的 PHP 版本

Laravel 12

Laravel 12 在 11.x 的基础上进一步提升，不仅更新了上游依赖，还为 React、Vue 和 Livewire 引入了全新的入门套件（Starter Kits），并提供使用 WorkOS AuthKit 进行用户认证的选项。采用 WorkOS 版本的入门套件，可直接使用 社交登录、Passkey、以及 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 将不再获得额外的更新。

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