view:clear — 事前コンパイルされた Blade ビューを削除するコマンド

概要

ビューキャッシュを一括削除
php artisan view:clear は storage/framework/views にあるすべてのコンパイル済みビューファイルを削除します。開発時のテンプレート変更を即時反映させたり、キャッシュが破損した際に使います。

• カテゴリ：artisan
• 掲載バージョン：Laravel 12・PHP 8.4
• 名前空間 / FQCN / コマンド：php artisan view:clear
• 関連：view:cache、view:compile、php artisan view:clear
• 変更履歴：Laravel 5.8 で追加。以降のバージョンでは仕様変更なし。

要点（TL;DR）

構文 / シグネチャ

php artisan view:clear

• 戻り値：なし（ターミナルにメッセージのみ出力）
• 例外/副作用：ビューファイルを完全に削除するため、次リクエストで再コンパイルが発生。

使用例

最小例

php artisan view:clear

実務例（CI/CD スクリプト）

# デプロイ後にビューファイルをリセット
git pull origin main
composer install --no-dev
php artisan view:clear
php artisan config:cache
php artisan route:cache

よくある落とし穴・注意

• パフォーマンス低下：クリア後は初リクエストでビューが再コンパイルされる。
• キャッシュ戦略との相性：view:cache を使用している場合は、クリアするとキャッシュが無効化される。
• CI/CD での誤実行：本番環境で頻繁に実行すると、再コンパイルが多発しログが膨張する。

代替・関連APIとの比較

テスト例（Pest）

it('clears compiled view files', function () {
    // 事前にダミーのビューファイルを作成
    Storage::disk('local')->put('framework/views/dummy.php', '<?php echo "test"; ?>');

    // コマンド実行
    Artisan::call('view:clear');

    // クリア後にファイルが無いことを確認
    expect(Storage::disk('local')->exists('framework/views/dummy.php'))->toBeFalse();
});

トラブルシュート（エラー別）

参考リンク

• Laravel 公式ドキュメント: view:clear
• Laravel 公式リリースノート: view caching changes