跳至內容

入門套件

簡介

為了讓您在構建新的 Laravel 應用程式時有一個良好的開始,我們很樂意提供身份驗證和應用程式入門套件。這些套件會自動為您的應用程式建立註冊和驗證用戶所需的路由、控制器和視圖。

雖然歡迎您使用這些入門套件,但它們並非必須。您可以透過簡單地安裝一個新的 Laravel 副本來從頭開始構建自己的應用程式。無論如何,我們知道您會建立出色的東西!

Laravel Breeze

Laravel Breeze 是 Laravel 所有 身份驗證功能 的最小、簡單的實現,包括登入、註冊、密碼重設、電子郵件驗證和密碼確認。此外,Breeze 還包括一個簡單的「個人資料」頁面,用戶可以在其中更新他們的姓名、電子郵件地址和密碼。

Laravel Breeze 的預設視圖層由使用 Tailwind CSS 設計樣式的簡單 Blade 範本組成。此外,Breeze 還提供基於 LivewireInertia 的 scaffolding 選項,並可選擇使用 Vue 或 React 進行基於 Inertia 的 scaffolding。

Laravel Bootcamp

如果您是 Laravel 的新手,請隨時跳到 Laravel Bootcamp。Laravel Bootcamp 將引導您使用 Breeze 構建您的第一個 Laravel 應用程式。這是了解 Laravel 和 Breeze 所提供的一切的絕佳方式。

安裝

首先,您應該建立一個新的 Laravel 應用程式。如果您使用 Laravel 安裝程式建立您的應用程式,系統會提示您在安裝過程中安裝 Laravel Breeze。否則,您需要依照下面的手動安裝說明進行操作。

如果您已經建立了一個沒有入門套件的新 Laravel 應用程式,您可以透過 Composer 手動安裝 Laravel Breeze

composer require laravel/breeze --dev

Composer 安裝 Laravel Breeze 套件後,您應該執行 breeze:install Artisan 命令。此命令會將身份驗證視圖、路由、控制器和其他資源發佈到您的應用程式。Laravel Breeze 會將其所有程式碼發佈到您的應用程式,以便您可以完全控制和可見其功能和實作。

breeze:install 命令會提示您選擇您的首選前端堆疊和測試框架

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

Breeze 和 Blade

預設的 Breeze「堆疊」是 Blade 堆疊,它使用簡單的 Blade 範本來呈現應用程式的前端。可以透過在沒有其他額外參數的情況下調用 breeze:install 命令並選擇 Blade 前端堆疊來安裝 Blade 堆疊。安裝 Breeze 的 scaffolding 後,您也應該編譯應用程式的前端資源

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

接下來,您可以在網頁瀏覽器中瀏覽應用程式的 /login/register URL。所有 Breeze 的路由都在 routes/auth.php 檔案中定義。

lightbulb - Laravel 框架

要了解有關編譯應用程式 CSS 和 JavaScript 的更多資訊,請查看 Laravel 的 Vite 文件

Breeze 和 Livewire

Laravel Breeze 還提供 Livewire scaffolding。Livewire 是一種使用 PHP 構建動態、反應式前端 UI 的強大方法。

Livewire 非常適合主要使用 Blade 範本,並且正在尋找更簡單的替代方案來取代像 Vue 和 React 這樣的 JavaScript 驅動的 SPA 框架的團隊。

要使用 Livewire 堆疊,您可以在執行 breeze:install Artisan 命令時選擇 Livewire 前端堆疊。安裝 Breeze 的 scaffolding 後,您應該執行資料庫遷移

php artisan breeze:install
 
php artisan migrate

Breeze 和 React / Vue

Laravel Breeze 還透過 Inertia 前端實作提供 React 和 Vue scaffolding。Inertia 允許您使用傳統的伺服器端路由和控制器來構建現代化的單頁 React 和 Vue 應用程式。

Inertia 讓您可以享受 React 和 Vue 的前端強大功能,以及 Laravel 令人難以置信的後端生產力和閃電般的 Vite 編譯。要使用 Inertia 堆疊,您可以在執行 breeze:install Artisan 命令時選擇 Vue 或 React 前端堆疊。

選擇 Vue 或 React 前端堆疊時,Breeze 安裝程式也會提示您確定是否需要 Inertia SSR 或 TypeScript 支援。安裝 Breeze 的 scaffolding 後,您也應該編譯應用程式的前端資源

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

接下來,您可以在網頁瀏覽器中瀏覽應用程式的 /login/register URL。所有 Breeze 的路由都在 routes/auth.php 檔案中定義。

Breeze 和 Next.js / API

Laravel Breeze 還可以建立一個身份驗證 API,該 API 已準備好驗證由 NextNuxt 等提供支援的現代 JavaScript 應用程式。若要開始使用,請在執行 breeze:install Artisan 命令時選擇 API 堆疊作為您所需的堆疊

php artisan breeze:install
 
php artisan migrate

在安裝過程中,Breeze 會將 FRONTEND_URL 環境變數新增至應用程式的 .env 檔案。此 URL 應該是您的 JavaScript 應用程式的 URL。在本地開發期間,通常會是 http://localhost:3000。此外,您應該確保您的 APP_URL 設定為 http://localhost:8000,這是 serve Artisan 命令使用的預設 URL。

Next.js 參考實作

最後,您已準備好將此後端與您選擇的前端配對。Breeze 前端的 Next 參考實作可在GitHub 上取得。此前端由 Laravel 維護,並且包含與 Breeze 提供的傳統 Blade 和 Inertia 堆疊相同的使用者介面。

Laravel Jetstream

雖然 Laravel Breeze 為構建 Laravel 應用程式提供了一個簡單且最少的起點,但 Jetstream 使用更強大的功能和額外的前端技術堆疊來增強該功能。對於 Laravel 的新手,我們建議您先使用 Laravel Breeze 學習基礎知識,然後再升級到 Laravel Jetstream。

Jetstream 為 Laravel 提供了一個設計精美的應用程式 scaffolding,包括登入、註冊、電子郵件驗證、雙重因素驗證、工作階段管理、透過 Laravel Sanctum 支援 API 以及可選的團隊管理。Jetstream 是使用 Tailwind CSS 設計的,並提供您選擇的 LivewireInertia 驅動的前端 scaffolding。

有關安裝 Laravel Jetstream 的完整文件可以在官方 Jetstream 文件中找到。