Starter Kits
介绍
为了帮助你快速开始构建新的 Laravel 应用程序,我们很高兴提供认证和应用启动包。这些启动包会自动为你的应用程序搭建所需的路由、控制器和视图,以便你注册和认证用户。
虽然你可以使用这些启动包,但它们并不是必需的。你也可以通过简单地安装一个全新的 Laravel 副本,从头开始构建自己的应用程序。无论哪种方式,我们相信你一定会构建出一个很棒的应用!
Laravel Breeze
Laravel Breeze 是 Laravel 认证功能的最小化、简化实现,包括登录、注册、密码重置、电子邮件验证和密码确认。此外,Breeze 还包含一个简单的 “个人资料” 页面,用户可以在该页面上更新他们的姓名、电子邮件地址和密码。
Laravel Breeze 的默认视图层由简单的 Blade 模板组成,并使用 Tailwind CSS 进行样式化。此外,Breeze 还提供基于 Livewire 或 Inertia 的脚手架选项,并且对于基于 Inertia 的脚手架,可以选择使用 Vue 或 React。

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 模板来渲染应用程序的前端。Blade 堆栈可以通过调用 breeze:install
命令并选择 Blade 前端堆栈来安装。安装完 Breeze 的脚手架后,你还需要编译应用程序的前端资产:
php artisan breeze:install
php artisan migrate
npm install
npm run dev
接下来,你可以在浏览器中访问应用程序的 /login
或 /register
URL。所有 Breeze 的路由都定义在 routes/auth.php
文件中。
若要了解更多关于编译应用程序的 CSS 和 JavaScript,可以查看 Laravel 的 【Vite 文档】。 |
Breeze 和 Livewire
Laravel Breeze 还提供了 Livewire 脚手架。Livewire 是一种强大的方式,可以仅使用 PHP 构建动态、响应式的前端 UI。
Livewire 非常适合主要使用 Blade 模板的团队,并且希望寻找比 Vue 和 React 这样的 JavaScript 驱动的 SPA 框架更简单的替代方案。
要使用 Livewire 堆栈,你可以在执行 breeze:install
Artisan 命令时选择 Livewire 前端堆栈。安装完 Breeze 的脚手架后,你应该运行数据库迁移:
php artisan breeze:install
php artisan migrate
Breeze 和 React / Vue
Laravel Breeze 还通过 Inertia 前端实现提供了 React 和 Vue 的脚手架。Inertia 允许你使用经典的服务器端路由和控制器构建现代的单页 React 和 Vue 应用。
Inertia 让你能够享受 React 和 Vue 的前端功能,同时结合 Laravel 的强大后端生产力和 lightning-fast Vite 编译。要使用 Inertia 堆栈,你可以在执行 breeze:install
Artisan 命令时选择 Vue 或 React 前端堆栈。
在选择 Vue 或 React 前端堆栈时,Breeze 安装程序还会提示你是否需要 Inertia SSR 或 TypeScript 支持。安装完 Breeze 的脚手架后,你还需要编译应用程序的前端资源:
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 还可以为现代 JavaScript 应用程序(例如 Next、 Nuxt 等)生成一个认证 API。要开始使用,请在执行 breeze:install
Artisan 命令时选择 API 堆栈作为你想要的堆栈:
php artisan breeze:install
php artisan migrate
安装期间,Breeze 会将 FRONTEND_URL
环境变量添加到你的应用程序的 .env
文件中。这个 URL 应该是你的 JavaScript 应用程序的 URL。通常在本地开发时,这个 URL 为 http://localhost:3000
。此外,你还需要确保 APP_URL
设置为 http://localhost:8000
,这是 serve
Artisan 命令使用的默认 URL。
Next.js 参考实现
最后,你可以将这个后端与选择的前端配对。一个基于 Next.js 的 Breeze 前端参考实现可以在 GitHub 上找到。这个前端由 Laravel 维护,并包含与 Breeze 提供的传统 Blade 和 Inertia 堆栈相同的用户界面。
Laravel Jetstream
虽然 Laravel Breeze 提供了一个简单且最小化的起点来构建 Laravel 应用程序,但 Jetstream 在此基础上增强了更多强大的功能和额外的前端技术栈。对于刚接触 Laravel 的开发者,我们建议先使用 Laravel Breeze 学习基础,再过渡到 Laravel Jetstream。
Jetstream 提供了一个设计精美的应用程序脚手架,并包括登录、注册、电子邮件验证、双因素认证、会话管理、通过 Laravel Sanctum 支持的 API 以及可选的团队管理功能。Jetstream 采用 Tailwind CSS 设计,并提供 Livewire 或 Inertia 驱动的前端脚手架供选择。
有关安装 Laravel Jetstream 的完整文档,请参阅 【官方的 Jetstream 文档】。