logo

安装 ​

安装 Jetstream ​

您可以使用 Composer 将 Jetstream 安装到新的 Laravel 项目中

bash
composer create-project laravel/laravel example-app

cd example-app

composer require laravel/jetstream

安装 Jetstream 包后，您可以执行 jetstream:install Artisan 命令。此命令接受您喜欢的堆栈名称（livewire 或 inertia）。此外，您可以使用 --teams 开关启用团队支持。

jetstream:install 命令还将安装一套“功能”测试，为 Jetstream 提供的功能提供测试覆盖率。

强烈建议您在开始 Jetstream 项目之前阅读 Livewire 或 Inertia 的完整文档。

仅限新应用程序

Jetstream 只能安装到新的 Laravel 应用程序中。尝试将 Jetstream 安装到现有的 Laravel 应用程序中会导致意外行为和问题。

使用 Livewire 安装 Jetstream ​

bash
php artisan jetstream:install livewire

如果您想要“团队”支持，可以在安装命令中提供 --teams 指令

bash
php artisan jetstream:install livewire --teams

或者，使用 Inertia 安装 Jetstream ​

bash
php artisan jetstream:install inertia

如果您想要使用 Inertia 堆栈的“团队”支持，请在安装命令中提供 --teams 指令

bash
php artisan jetstream:install inertia --teams

Inertia 堆栈也可以使用 SSR 支持安装

bash
php artisan jetstream:install inertia --ssr

您可以在 Laravel Vite 插件 和 Inertia 文档中了解更多关于运行 SSR 服务器的信息。

暗黑模式 ​

如果您希望在构建应用程序前端时包含“暗黑模式”支持，请在执行 jetstream:install 命令时提供 --dark 指令

bash
php artisan jetstream:install livewire --dark

完成安装 ​

安装 Jetstream 后，您应该安装并构建 NPM 依赖项，并迁移数据库

bash
npm install
npm run build
php artisan migrate

安装 Jetstream 后，您可能已经注意到 Jetstream 徽标被用于 Jetstream 的身份验证页面以及应用程序的顶部导航栏。您可以通过修改一些 Jetstream 组件轻松自定义徽标。

Livewire ​

如果您使用的是 Livewire 堆栈，则应该自定义以下 Blade 组件中的 SVG

  • resources/views/components/application-logo.blade.php
  • resources/views/components/application-mark.blade.php
  • resources/views/components/authentication-card-logo.blade.php

Inertia ​

如果您使用的是 Inertia 栈，您应该自定义以下 Vue 组件中的 SVG：

  • resources/js/Components/ApplicationLogo.vue
  • resources/js/Components/ApplicationMark.vue
  • resources/js/Components/AuthenticationCardLogo.vue

自定义这些组件后，您应该重建您的资产

bash
npm run build

升级指南 ​

要从以前版本升级到 Jetstream 5.x，请参阅我们的 升级指南。