Skip to content
全部文档

发行说明

版本策略

Laravel 及其其他官方包遵循 语义化版本。框架大版本大约每年发布一次(约第一季度),小版本与补丁版本可能每周都会发布。小版本与补丁版本绝不应包含破坏性变更。

在应用或包中引用 Laravel 框架或其组件时,应始终使用类似 ^12.0 的版本约束,因为 Laravel 大版本确实会包含破坏性变更。不过我们会尽力确保你能在一天甚至更短时间内完成升级。

命名参数

命名参数 不在 Laravel 向后兼容指南的覆盖范围内。我们可能在必要时重命名函数参数以改进代码库。因此,调用 Laravel 方法时使用命名参数应格外谨慎,并明白参数名未来可能变更。

支持策略

所有 Laravel 发行版提供 18 个月的缺陷修复与 2 年的安全修复。对于其他附加库,仅最新大版本会收到缺陷修复。此外,请查阅 Laravel 支持的数据库版本

VersionPHP (*)ReleaseBug Fixes UntilSecurity Fixes Until
108.1 - 8.3February 14th, 2023August 6th, 2024February 4th, 2025
118.2 - 8.4March 12th, 2024September 3rd, 2025March 12th, 2026
128.2 - 8.5February 24th, 2025August 13th, 2026February 24th, 2027
138.3 - 8.5Q1 2026Q3 2027Q1 2028
已终止支持
仅安全修复

(*) 支持的 PHP 版本

Laravel 12

Laravel 12 延续 Laravel 11.x 的改进,更新了上游依赖,并引入面向 React、Svelte、Vue 与 Livewire 的新起步套件,同时可选使用 WorkOS AuthKit 进行用户认证。起步套件的 WorkOS 变体提供社交登录、通行密钥(passkeys)与 SSO 支持。

极少破坏性变更

本发布周期的重点之一是尽量减少破坏性变更。我们更倾向于在全年持续交付不会破坏现有应用的体验改进。

因此,Laravel 12 在很大程度上是一次相对较小的「维护版本」发布,主要用于升级现有依赖。大多数 Laravel 应用无需改动业务代码即可升级到 Laravel 12。

全新应用起步套件

Laravel 12 引入了面向 React、Svelte、Vue 与 Livewire 的全新应用起步套件。React、Svelte 与 Vue 起步套件采用 Inertia 2、TypeScript、shadcn/ui 与 Tailwind;Livewire 起步套件则采用基于 Tailwind 的 Flux UI 组件库与 Laravel Volt。

React、Svelte、Vue 与 Livewire 起步套件均使用 Laravel 内置认证系统,提供登录、注册、密码重置、邮箱验证等功能。此外,我们还为每套起步套件提供了由 WorkOS AuthKit 驱动的变体,支持社交登录、通行密钥与 SSO。WorkOS 可为每月活跃用户不超过 100 万的应用提供免费认证。

随着新应用起步套件的推出,Laravel Breeze 与 Laravel Jetstream 将不再接收后续更新。

要开始使用新起步套件,请参阅起步套件文档