## Filament 從管理面板頂級容器開始
## 環境要求
運行 Filament 有一些基礎要求：
* PHP 8.1+
* Laravel v10.0+
* Livewire v3.0+
## 安裝
> 如果你是從 Filament v2 升級，請查看[升級向導](https://laravel-filament.cn/docs/zh-CN/3.x/panels/upgrade-guide)。
安裝 Filament 面板構造器，在 Laravl 項目目錄下運行如下命令：
~~~bash
composer require filament/filament:"^3.2" -W?php artisan filament:install --panels
~~~
這段命令將會創建并注冊一個新的[Laravel 服務提供者](https://laravel.com/docs/providers)，叫做`app\Providers\Filament\AdminPanelProvider`.
> 如果訪問面板時出錯，請檢查該服務提供者有沒有在`bootstrap/providers.php`(Laravel 11 及以上版本)或`config/app.php`(Laravel 10 及以下版本) 中注冊。如果沒有，你應該手動添加。
## 創建用戶
如果還沒有用戶，你可以使用以下命令創建新用戶：
~~~bash
php artisan make:filament-user
~~~
訪問`/admin`并登錄，你現在可以開始創建自己的應用了!
不確定應該從哪里開始？請瀏覽[開始向導](https://laravel-filament.cn/docs/zh-CN/3.x/panels/getting-started)，學習如何構建一個完整登錄的 Filament 管理后臺。
## 使用其他 Filament 包
Filament 面板構造器包已經預裝了[表單構造器](https://laravel-filament.cn/docs/zh-CN/3.x/forms/installation)、[表格構造器](https://laravel-filament.cn/docs/zh-CN/3.x/tables/installation)、[通知生成器](https://laravel-filament.cn/docs/zh-CN/3.x/notifications/installation)、[Action](https://laravel-filament.cn/docs/zh-CN/3.x/actions/installation)、[信息列表](https://laravel-filament.cn/docs/zh-CN/3.x/infolists/installation)及[Widget](https://laravel-filament.cn/docs/zh-CN/3.x/widgets/installation)包。因此在面板中無需再行安裝就能使用。
## 改善 Filament 面板性能
### 緩存 Blade 圖標
你可以考慮在本地及部署腳本中運行`php artisan icons:cache`。這是因為 Filament 使用了[Blade Icons](https://blade-ui-kit.com/blade-icons)包，它在緩存時有更好的性能。
### 緩存 Filament 組件
你也可以考慮在部署腳本中運行`php artisan filament:cache-components`，特別是當你有大量組件(資源、頁面、Widgets、關聯管理器、自定義 Livewire 組件等)時。這將在應用的`bootstrap/cache/filament`目錄中生成緩存文件，其中包含每個組件類型的索引。這在某些應用中可以顯著提升 Filament 的性能，因為它減少了需要掃描的文件數量并且自動發現組件。
不過，如果你在本地開發應用，應該避免使用該命令，因為它在清除或者重新緩存之前，將會阻止你發現新組件。
你可以運行`php artisan filament:clear-cached-components`在任何時候清理緩存而不重新生成緩存。
### 在服務器中啟用 OPcache
來自于[Laravel Forge 文檔](https://forge.laravel.com/docs/servers/php.html#opcache):
> 優化生產環境中的 PHP OPcache，將編譯過的 PHP 代碼保存在內存中是對性能的極大提升。
請使用搜索引擎去檢索相關的 Opcache 安裝指南。
### 優化 Laravel 應用
你也可以考慮在部署腳本中運行`php artisan optimize`。這將會緩存配置和路由。
## 部署到生產環境
### 允許用戶訪問面板
默認情況下，所有的`App\Models\User`在本地下都可以訪問 Filament。要允許用戶在生成環境中訪問，你還需要采取一些額外的措施來確保只有授權的用戶可以訪問該應用。
~~~php
<?php?namespace App\Models;?use Filament\Models\Contracts\FilamentUser;use Filament\Panel;use Illuminate\Foundation\Auth\User as Authenticatable;?class User extends Authenticatable implements FilamentUser{ // ...? public function canAccessPanel(Panel $panel): bool { return str_ends_with($this->email, '@yourdomain.com') && $this->hasVerifiedEmail(); }}
~~~
> 如果你沒有完成這些步驟，當你在生產環境中試圖訪問應用時，會出現 403 錯誤。
了解更多[用戶](https://laravel-filament.cn/docs/zh-CN/3.x/panels/users)相關信息。
## 發布配置
你可以使用如下命令發布配置文件：
~~~bash
php artisan vendor:publish --tag=filament-config
~~~
## 發布翻譯文件
可以使用如下命令可以發布語言文件供翻譯：
~~~bash
php artisan vendor:publish --tag=filament-translations
~~~
由于此包依賴于其他 Filament 包，因此你還可以使用如下命令發布語言文件：
~~~bash
php artisan vendor:publish --tag=filament-actions-translationsphp artisan vendor:publish --tag=filament-forms-translationsphp artisan vendor:publish --tag=filament-notifications-translationsphp artisan vendor:publish --tag=filament-tables-translationsphp artisan vendor:publish --tag=filament-support-translations
~~~
## 升級
> 如果你是從 Filament v2 升級，請查看[升級向導](https://laravel-filament.cn/docs/zh-CN/3.x/panels/upgrade-guide)。
當運行`composer update`命令時，Filament 會自動升級到最新的非破壞性版本。升級完成后，應該清除所有 Laravel 緩存，并且重新發布前端資源。你可以使用`filament:upgrade`命令一次性完成這些動作，該命令會第一次運行`filament:install`添加到`composer.json`文件中：
~~~json
"post-autoload-dump": [ // ... "@php artisan filament:upgrade"],
~~~
請注意`filament:upgrade`不會真正處理升級過程，因為 Composer 已經做了升級，如果你不使用`post-autoload-dump`鉤子手動升級，你可以自己運行該命令：
~~~bash
composer updatephp artisan filament:upgrade
~~~
