发布说明

• 版本控制方案
• 支持策略
• Laravel 12

版本控制方案

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

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

命名参数

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

支持策略

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

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

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