LaravelDocs(中文)

Laravel 版本說明(Laravel Release)

深入了解 Laravel 發行說明 (Release Notes) 與官方版本支援政策 (Support Policy)。本文詳列 Laravel 12 與 11 的發布日期、錯誤修復與安全性更新時程 (LTS),並提供 PHP 版本對照表與最新 Starter Kits 介紹,助您掌握框架升級與維護的最佳時機。

版本命名規則 (Versioning Scheme)

Laravel 及其他官方套件遵循 語意化版本控制。主要框架版本每年發布一次(約在第一季),而次要版本和修補版本可能每週發布。次要版本和修補版本絕不應該包含破壞性變更。

當從您的應用程式或套件引用 Laravel 框架或其組件時,您應該始終使用版本約束,例如 ^12.0,因為 Laravel 的主要版本確實包含破壞性變更。但是,我們會努力確保您可以在一天或更短的時間內更新到新的主要版本。

命名引數 (Named Arguments)

命名引數 不在 Laravel 的向後相容性準則的涵蓋範圍內。為了改進 Laravel 程式碼庫,我們可能會在必要時選擇重新命名函式引數。因此,使用命名引數呼叫 Laravel 方法時應該謹慎行事,並理解參數名稱將來可能會更改。

支援政策 (Support Policy)

對於所有 Laravel 版本,錯誤修復提供 18 個月,安全修復提供 2 年。對於所有額外的函式庫,只有最新的主要版本會收到錯誤修復。此外,請查看 Laravel 支援的資料庫版本

版本PHP (*)發布日期錯誤修復至安全修復至
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.52025 年 2 月 24 日2026 年 8 月 13 日2027 年 2 月 24 日
138.3 - 8.52026 年第一季2027 年第三季2028 年第一季
已終止支援
僅限安全修復

(*) 支援的 PHP 版本

Laravel 12

Laravel 12 延續了 Laravel 11.x 的改進,更新了上游依賴項目,並為 React、Vue 和 Livewire 推出了新的 Starter Kits,包括使用 WorkOS AuthKit 進行使用者驗證的選項。我們 Starter Kits 的 WorkOS 變體提供了社群驗證、Passkeys 和 SSO 支援。

最小化破壞性變更 (Minimal Breaking Changes)

在這個發布週期中,我們的大部分重點都放在最小化破壞性變更上。相反,我們致力於全年發布不會破壞現有應用程式的持續性改進。

因此,Laravel 12 版本是相對較小的「維護版本」,目的是升級現有的依賴項目。鑑於此,大多數 Laravel 應用程式可以在不更改任何應用程式程式碼的情況下升級到 Laravel 12。

新的應用程式 Starter Kits (New Application Starter Kits)

Laravel 12 為 React、Vue 和 Livewire 推出了新的應用程式 Starter Kits。React 和 Vue Starter Kits 使用 Inertia 2、TypeScript、shadcn/ui 和 Tailwind,而 Livewire Starter Kits 則使用基於 Tailwind 的 Flux UI 組件庫和 Laravel Volt。

React、Vue 和 Livewire Starter Kits 都使用 Laravel 內建的驗證系統來提供登入、註冊、密碼重設、電子郵件驗證等功能。此外,我們正在推出每個 Starter Kit 的 WorkOS AuthKit 驅動 變體,提供社群驗證、Passkeys 和 SSO 支援。WorkOS 為每月最多 100 萬活躍使用者的應用程式提供免費驗證。

隨著我們新應用程式 Starter Kits 的推出,Laravel Breeze 和 Laravel Jetstream 將不再接收額外的更新。

要開始使用我們的新 Starter Kits,請查看 Starter Kit 文件