Laravel 中文文档

主题

发布说明 ​

版本命名规范 ​

Laravel 及其一手包办的组件遵循 语义化版本控制。框架的主版本每年发布一次（约第一季度），次版本与补丁版本可能每周发布。次版本与补丁版本绝不包含突破性变更。

在应用或包中引用 Laravel 框架或其组件时，务必使用如 ^11.0 的版本约束，因主版本更新包含突破性变更。我们致力于确保您能在一天内完成至新主版本的升级。

命名参数 ​

命名参数 不受 Laravel 后向兼容性方针的庇护。我们可能视需更名函数参数以改进代码基底。故调用 Laravel 方法时使用命名参数须谨慎，参数名未来或有变迁。

支持政策 ​

对于所有 Laravel 版本，缺陷修复提供 18 个月，安全修复延续 2 年。对于其他附加库（包括 Lumen），仅最新主版本获缺陷修复支持。请查阅 Laravel 支持的数据库版本。

版本PHP (*)发布日期缺陷修复截止安全修复截止
98.0 - 8.22022 年 2 月 8 日2023 年 8 月 8 日2024 年 2 月 6 日
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 日
生命周期终止
仅限安全修复

(*) 支持的 PHP 版本

Laravel 12 ​

Laravel 12 在 11.x 版本改良基础上，更新上游依赖，并引入 React、Vue 和 Livewire 的全新入门套件，可选使用 WorkOS AuthKit 进行用户认证。WorkOS 版本的入门套件提供社交认证、通行密钥及单点登录支持。

最小化突破性变更 ​

此发布周期，我们倾力于将突破性变更降至最低，全年持续推出不破坏现有应用的生活品质提升。

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 支持的变体，提供社交认证、通行密钥及单点登录支持。WorkOS 为每月活跃用户达百万的应用提供免费认证。

新应用入门套件推出后，Laravel Breeze 与 Laravel Jetstream 将不再获更新。

欲体验新入门套件，请参阅入门套件文档。