Filament v5

Filament v5 のサーバー駆動型 UI と Schema、Livewire v4 のリアクティビティを使用して、強力な Laravel 管理パネルを構築します。

概要

Filament v5 は Laravel 管理パネルフレームワークで、宣言的な PHP API を通じて完全な CRUD インターフェース、フォーム、テーブル、ダッシュボードコンポーネントを提供します。Livewire v4 上に構築され、JavaScript を記述することなくリアルタイムのリアクティビティを実現します。

主要概念

• PanelProvider: 管理パネルを定義する中央設定クラス
• Resources: Eloquent モデル用の自動 CRUD インターフェース
• Schemas: 宣言的 UI コンポーネント（フォーム、テーブル、インフォリスト）
• Actions: モーダルとバックエンドロジック付きのインタラクティブボタン
• Widgets: データ可視化用のダッシュボードコンポーネント

システム要件

• Laravel 11.28+
• PHP 8.2+
• Livewire v4
• Node.js 18+
• Tailwind CSS v4.1+

インストール

Composer 経由で Filament をインストールし、パネルをスカッフォルドします:

composer require filament/filament:"^5.0" -W
php artisan filament:install --scaffold
npm install && npm run dev
php artisan make:filament-user

このコマンドはパネルプロバイダー、ディレクトリ構造、構築を開始するために必要なアセットを作成します。

ディレクトリ構造

app/
  Filament/
    Resources/          # フォームとテーブル付き CRUD リソース
    Pages/              # カスタムページ
    Widgets/            # ダッシュボードウィジェット
  Providers/
    Filament/
      AdminPanelProvider.php

コア概念

パネル設定

PanelProvider は管理パネルのエントリーポイントです。以下を設定します:

• Identity: ID、パス、ブランディング（名前、ロゴ、カラー）
• Discovery: リソース、ページ、ウィジェットの自動検出
• Middleware: セッション、認証、カスタムミドルウェア
• Tenancy: SaaS アプリケーション向けのマルチテナント設定

リソース

リソースは以下を通じて完全な CRUD インターフェースを提供します:

• Forms: 20 以上のフィールドタイプ（TextInput、Select、DatePicker、FileUpload、RichEditor など）を持つ Schema ベースのフォーム
• Tables: 列、フィルター、ソート、アクションを備えたデータテーブル
• Pages: List、Create、Edit、View ページの自動生成
• Relations: モデルリレーションシップ処理用のリレーションマネージャー

フォーム

フォームは Schema ベースのアプローチを使用し、フィールドを PHP オブジェクトとして宣言します:

• 入力フィールド: テキスト、セレクト、チェックボックス、トグル、日付/時刻ピッカー
• メディア: バリデーション付きのファイルおよび画像アップロード
• 複雑なフィールド: リッチテキストエディター、リピーター、ビルダー
• レイアウト: グリッド、セクション、タブ、ウィザード
• バリデーション: 組み込み Laravel バリデーションルール

テーブル

テーブルは広範なカスタマイズでデータを表示します:

• Columns: テキスト、バッジ、アイコン、画像、カラー
• Filters: セレクト、三項、カスタムフィルターロジック
• Actions: 行ごとのアクション、一括アクション、ヘッダーアクション
• Features: 検索、ソート、ページネーション、グループ化

アクション

アクションはトリガーするインタラクティブボタンです:

• Modals: データ収集用のフォームダイアログ
• Confirmation: 破壊的なアクション確認
• Wizards: マルチステッププロセス
• Notifications: 完了後のユーザーフィードバック

ウィジェット

ダッシュボードウィジェットには:

• Stats Overview: トレンドとスパークラインを備えたメトリックカード
• Charts: Chart.js を使用したラインチャート、棒グラフ、円グラフ
• Tables: 最新レコード用のデータテーブル

テスト

Filament は Pest PHP と Livewire テストヘルパーを使用します:

• Page Testing: List、Create、Edit、View ページ機能
• Form Testing: バリデーション、状態管理、送信
• Table Testing: 検索、フィルター、ソート、アクション
• Authorization Testing: アクセス制御と権限

認可

以下を通じたアクセス制御:

• Panel Access: パネルレベルのアクセス用 FilamentUser コントラクト
• Policies: リソースレベルの権限用 Laravel ポリシー
• Field Visibility: ユーザーロールに基づくフィールドの表示/非表示
• Multi-Tenancy: SaaS アプリケーション向けのテナント分離

アーキテクチャパターン

サーバー駆動型 UI

Filament はサーバー駆動型アプローチを使用し、バックエンドが Schema を通じて UI 構造を定義します。PHP コードはフォーム、テーブル、レイアウトを記述し、Filament がそれらを Livewire コンポーネントとしてレンダリングします。

Schema システム

Schema は以下を定義する PHP 設定オブジェクトです:

• フォームフィールドとそのバリデーションルール
• テーブル列とそのフォーマット
• レイアウトコンテナ（グリッド、セクション、タブ）
• アクション定義とその動作

Livewire 統合

すべてのコンポーネントは Livewire コンポーネントとしてマウントされ、以下を提供します:

• ページリロードなしのリアルタイムリアクティビティ
• 自動状態管理
• イベント処理と AJAX 更新
• インスタントフィードバック付きフォームバリデーション

リソース優先設計

フレームワークはリソース優先アプローチを推奨します:

1. Eloquent モデルを定義します
2. それらのモデルにマップするリソースを作成します
3. 各リソースのフォームとテーブルを設定します
4. 必要に応じてアクションとウィジェットを追加します

コマンドリファレンス

コマンド	目的
filament:install --scaffold	パネルスカッフォルド付き Filament をインストール
make:filament-resource	CRUD リソースを作成
make:filament-page	カスタムページを作成
make:filament-widget	ダッシュボードウィジェットを作成
make:filament-panel	追加パネルを作成
make:filament-user	管理ユーザーを作成
make:filament-relation-manager	リレーションマネージャーを作成
filament:cache-components	本番環境用にキャッシュ

詳細ドキュメント

リファレンスガイド

各コンポーネント用の包括的なドキュメント:

• Forms - すべてのフォームコンポーネント、バリデーションルール、レイアウト、条件付きロジック
• Tables - 列型、フィルター、アクション、テーブル設定
• Resources - CRUD リソース、リレーションマネージャー、インフォリスト、グローバル検索
• Infolists - 読み取り専用データ表示コンポーネント（TextEntry、ImageEntry、IconEntry）
• Widgets - Stats Overview、チャート、テーブルウィジェット
• Actions - モーダルアクション、通知、アクショングループ、ウィザード
• Notifications - フラッシュメッセージ、データベース、ブロードキャスト通知
• Schemas - Schema システム、レイアウト、コンポーネント構成
• Testing - リソース、フォーム、テーブル、認可向け Pest テストパターン
• Authorization - アクセス制御、ポリシー、ロール、マルチテナンシー

コード例

完全な動作コード例については examples.md を参照してください:

• 完全なリソース実装
• フォーム設定
• テーブルセットアップ
• ウィジェット設定
• テストスイート
• 認可パターン

ベストプラクティス

パフォーマンス

• getEloquentQuery() を使用してリレーションシップをイーガーロードし、N+1 クエリを防止します
• filament:cache-components で本番環境のコンポーネントキャッシュを有効にします
• ページネーションオプションを制限し、大規模データセット向けに遅延ロードを使用します
• ウィジェットの高価な計算をキャッシュします

セキュリティ

• パネルアクセス制御用に常に FilamentUser コントラクトを実装します
• リソースレベルの認可に Laravel ポリシーを使用します
• 適切なフォームルールですべての入力をバリデートします
• 本番環境では認可をスキップしないでください
• マルチテナントアプリケーション向けに適切なテナント分離を実装します

コード構成

• フィーチャーごとに構成: app/Filament/Admin/Resources/
• 複雑なフォームとテーブルを別々のクラスに抽出します
• 一般的なパターン用に再利用可能なフォームコンポーネントを作成します
• リソースを単一責任に集中させます
• 非 CRUD 機能には専用ページを使用します

テスト

• 各リソースのすべての CRUD 操作をテストします
• 複数シナリオでフォームバリデーションルールを検証します
• テーブル機能をテスト: 検索、フィルター、ソート、アクション
• 異なるユーザーロールで認可を検証します
• ファクトリーを使用して現実的なテストデータを作成します

Filament の使用時期

Filament は以下の場合に最適です:

• Admin Panels: アプリケーションデータを管理するバックオフィスインターフェース
• CMS: リッチ編集機能付きコンテンツ管理システム
• CRM: 顧客関係管理ツール
• E-commerce: 製品、注文、在庫管理
• SaaS Applications: マルチテナント管理インターフェース
• Internal Tools: ビジネスプロセス管理とデータ入力

その他のリソース

• Official Documentation
• GitHub Repository
• Live Demo
• Discord Community

---

Version: 1.0.0
License: MIT
Compatibility: Laravel 11+, PHP 8.2+, Livewire v4