发行说明
版本策略
Laravel 及其其他官方包遵循 语义化版本。框架大版本大约每年发布一次(约第一季度),小版本与补丁版本可能每周都会发布。小版本与补丁版本绝不应包含破坏性变更。
在应用或包中引用 Laravel 框架或其组件时,应始终使用类似 ^12.0 的版本约束,因为 Laravel 大版本确实会包含破坏性变更。不过我们会尽力确保你能在一天甚至更短时间内完成升级。
命名参数
命名参数 不在 Laravel 向后兼容指南的覆盖范围内。我们可能在必要时重命名函数参数以改进代码库。因此,调用 Laravel 方法时使用命名参数应格外谨慎,并明白参数名未来可能变更。
支持策略
所有 Laravel 发行版提供 18 个月的缺陷修复与 2 年的安全修复。对于其他附加库,仅最新大版本会收到缺陷修复。此外,请查阅 Laravel 支持的数据库版本。
| Version | PHP (*) | Release | Bug Fixes Until | Security Fixes Until |
|---|---|---|---|---|
| 10 | 8.1 - 8.3 | February 14th, 2023 | August 6th, 2024 | February 4th, 2025 |
| 11 | 8.2 - 8.4 | March 12th, 2024 | September 3rd, 2025 | March 12th, 2026 |
| 12 | 8.2 - 8.5 | February 24th, 2025 | August 13th, 2026 | February 24th, 2027 |
| 13 | 8.3 - 8.5 | Q1 2026 | Q3 2027 | Q1 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 将不再接收后续更新。
要开始使用新起步套件,请参阅起步套件文档。