发行说明

12.x

12.x 11.x 10.x 9.x 8.5 8.x 7.x 6.x 5.8 5.7 5.6 5.5 5.4 5.3 5.2 5.1

Laravel 12 中文文档 /

本文档最新版为 11.x，旧版本可能放弃维护，推荐阅读最新版！

发布说明

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

版本控制方案

Laravel 及其其他官方组件遵循语义化版本控制。主要版本每年发布一次（大约在第一季度），而次版本和补丁版本可能每周都会发布。次版本和补丁版本 绝不会 包含破坏性变更。

当你在应用或包中引用 Laravel 框架或其组件时，应始终使用类似 ^12.0 的版本约束，因为 Laravel 的主版本更新中可能包含破坏性变更。不过，我们始终努力确保你可以在一天之内完成主版本升级。

命名参数

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

支持策略

对于所有 Laravel 发布版本，Bug 修复支持周期为 18 个月，安全性修复支持周期为 2 年。对于所有附加组件库，仅最新主版本会接收 Bug 修复。

此外，请查看 Laravel 支持的数据库版本。

| 版本 | 支持的 PHP 版本（*） | 发布时间 | Bug 修复截止时间 | 安全修复截止时间 | | --- | --- | --- | --- | --- | | 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 日 | | 13 | 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 将不再接收额外更新。

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

本文章首发在 LearnKu.com 网站上。