Filament 运行需要以下内容:
安装方式有两种,取决于您是希望使用我们的面板构建器来构建应用,还是在您应用的 Blade 视图中使用这些组件:
配电盘制造商
大多数人选择此选项来构建一个面板 (例如, 管理面板) 用于他们的应用. 面板构建器将所有独立组件组合成一个有凝聚力的框架. 你可以在 Laravel 安装中创建任意数量的面板, 但你只需安装一次.
各个组件
如果你正在使用 Blade 从头开始构建你的应用,你可以从 Filament 安装单个组件来丰富你的用户界面。
在你的 Laravel 项目目录中运行以下命令,即可安装 Filament 面板构建器:
composer require filament/filament:"^4.0"
php artisan filament:install --panels在使用 Windows PowerShell 安装 Filament 时,您可能需要运行以下命令,因为它会忽略版本约束中的 ^ 字符:
composer require filament/filament:"~4.0"
php artisan filament:install --panels这将创建并注册一个新的 Laravel 服务提供者 名为 app/Providers/Filament/AdminPanelProvider.php.
如果您在访问面板时遇到错误,请检查服务提供商是否已在 bootstrap/providers.php 中注册。如果未注册,您需要手动添加。
您可以使用以下命令创建一个新的用户账户:
php artisan make:filament-user打开 /admin 在您的网络浏览器中,登录,然后 开始构建您的应用!
使用 Composer 安装您想使用的 Filament 组件:
composer require
filament/tables:"^4.0"
filament/schemas:"^4.0"
filament/forms:"^4.0"
filament/infolists:"^4.0"
filament/actions:"^4.0"
filament/notifications:"^4.0"
filament/widgets:"^4.0"你可以在项目中稍后安装额外的包,而无需重复这些安装步骤。
当使用 Windows PowerShell 安装 Filament 时,您可能需要运行以下命令,因为它会忽略版本约束中的 ^ 字符:
composer require
filament/tables:"~4.0"
filament/schemas:"~4.0"
filament/forms:"~4.0"
filament/infolists:"~4.0"
filament/actions:"~4.0"
filament/notifications:"~4.0"
filament/widgets:"~4.0"如果您只想使用 Blade UI 组件,您需要引入 filament/support 在此阶段。
新 Laravel 项目
通过运行一个简单的命令,快速上手 Filament 组件。请注意,这会覆盖您应用中任何已修改的文件,因此它只适用于新的 Laravel 项目。
现有的 Laravel 项目
如果您有现有的 Laravel 项目,您仍然可以安装 Filament,但应手动进行以保留您现有的功能。
为了在新 Laravel 项目中快速设置 Filament, 运行以下命令来安装 Livewire, Alpine.js, 和 Tailwind CSS:
这些命令将覆盖您的应用程序中的现有文件。仅在新的 Laravel 项目中运行它们!
运行以下命令以安装 Filament 前端资源:
php artisan filament:install --scaffold
npm install
npm run dev在脚手架搭建过程中,如果您已安装 通知 包,Filament 会询问您是否希望将所需的 Livewire 组件安装到您的默认布局文件中。如果您想通过 Filament 向用户发送闪存通知,则需要此组件。
Filament 附带一个配置文件,允许您覆盖所有软件包共享的默认设置。在安装面板构建器后发布它,以便您可以查看和自定义设置:
php artisan vendor:publish --tag=filament-config此命令会创建 config/filament.php,您可以在其中配置各种选项,例如默认文件系统磁盘、文件生成标志以及 UI 默认值。随时重新运行发布命令,以获取新增的配置键,再根据您的项目进行调整。