Filament のパネルを本番環境向けに最適化する Artisan コマンド
カテゴリ: artisan 著者: filament バージョン: 4.x タイトル: php artisan filament:optimize
説明: Filament アプリを本番環境向けに最適化します。コンポーネントキャッシュ、設定・ルートキャッシュ、Composer オートロードの最適化を実行し、パフォーマンスを向上させます。
php artisan filament:optimize
php artisan filament:optimize
Filament のパネルを本番環境向けに最適化します。
コンポーネントのキャッシュ生成、設定・ルートのキャッシュ化、Composer オートロードの最適化を行い、パフォーマンスを向上させます。
php artisan filament:optimize –help
Filament のパネルを本番環境向けに最適化するコマンドです。
Usage:
filament:optimize
Options:
-h, --help Display this help message
Options
- 本コマンドはオプションを持ちません。
Examples
本番環境へのデプロイスクリプト
# 1. 設定とルートをキャッシュ
php artisan config:cache
php artisan route:cache
# 2. Filament を最適化
php artisan filament:optimize
開発環境でのローカル最適化
# コンポーネントのキャッシュ生成
php artisan filament:cache-components
Related Commands
php artisan filament:cache-componentsphp artisan filament:assetsphp artisan filament:check-translationphp artisan filament:installphp artisan filament:upgrade
FAQ
- Q:
Command "filament:optimize" is not defined
A:
- Filament が最新版(4.x)であることを確認。
composer require filament/filamentでパッケージを更新。php artisan vendor:publish --provider="Filament\FilamentServiceProvider"を再実行し、サービスプロバイダを登録。
- Q:
filament:optimize実行時に長時間停止する
A: 大規模なコンポーネント数の場合は、先にphp artisan filament:cache-componentsを実行してキャッシュファイルを作成し、最適化を高速化します。
Caveats
- Filament 3.x 以前では
filament:optimizeコマンドが存在しません。代わりにphp artisan filament:assetsとphp artisan filament:check-translationを手動で実行してください。 config:cacheとroute:cacheを先に実行しないと、最適化後にエラーが発生する場合があります。
Security
- 本番環境では HTTPS を有効にし、リダイレクトを設定して Filament のアクセスを保護してください。
php artisan config:cacheで設定キャッシュ化した後は、.envファイルを安全に保管し、環境変数が漏れないように注意します。
Bugs
- バグ報告: Windows 環境で
php artisan filament:optimizeを実行すると「Command not defined」エラーが発生するケースがあります。
対処:composer update filament/filamentでパッケージを最新版に更新し、php artisan vendor:publish --provider="Filament\FilamentServiceProvider"を再実行してください。
Known Issues
- GitHub Issue #14283
一部環境でfilament:optimizeが認識されない問題。
原因はconfig/app.phpのproviders配列にFilament\FilamentServiceProvider::classが未登録であることが多いです。
対策: サービスプロバイダを追加し、php artisan config:clearを実行後に再度コマンドを呼び出す。

