Laravel キャッシュクリア完全ガイド｜コマンド一覧と反映されない時の対処法

Laravelで開発を進めていると、「.env の設定値を変更したのに反映されない」「ルーティングやBladeテンプレートを書き換えたのに古い画面が表示される」「コードを修正したはずなのにエラーが消えない」といったトラブルに遭遇することがよくあります。

これらの原因の多くは、Laravelがパフォーマンス向上のために保持している各種キャッシュです。

結論から言うと、原因が特定できない場合や手っ取り早く解決したい場合は、ターミナルで以下のコマンドを実行するのが最も確実です。

php artisan optimize:clear

しかし、「php artisan cache:clear を実行したのに解決しなかった」という経験をした方も多いのではないでしょうか。実は、cache:clear が削除するのは アプリケーションキャッシュ（Cacheファサードで保存したデータ） のみであり、設定（config）やルーティング（route）、ビュー（view）のキャッシュは削除されません。

この記事では、Laravelに存在する5大キャッシュ（config / route / view / app cache / event）の違いと役割、一括クリアコマンドと個別クリアコマンドの使い分け、Docker/Laravel Sail環境での実行方法、キャッシュをクリアしても反映されない原因と対処法、さらにはArtisanコマンドが動かない時の手動削除手順まで徹底解説します。

【最速解決】全キャッシュを一括クリアするコマンド

何が原因で変更が反映されないのか分からない時や、開発中に一旦すべての状態をリセットしたい時は、optimize:clear コマンドを実行します。

php artisan optimize:clear

【実行結果の例（Laravel 11 / 12）】

   INFO  Clearing cached bootstrap files.

  cache ................................................. DONE
  compiled ............................................... DONE
  config ................................................. DONE
  events ................................................. DONE
  routes ................................................. DONE
  views .................................................. DONE

このコマンド1つで、Laravelアプリケーション内で生成されたコンパイル済みファイルや主要なキャッシュ（設定・ルーティング・Bladeビュー・イベント・アプリケーションキャッシュ）がすべて一括で削除されます。

Laravel Sail / Docker環境での実行方法

Laravel Sail を利用している場合は、ホストマシンから直接実行するのではなく、Sailコマンドまたはコンテナ経由で実行します。

# Laravel Sail の場合
./vendor/bin/sail artisan optimize:clear

# Docker Compose の場合（サービス名が app の例）
docker compose exec app php artisan optimize:clear

詳しいオプションや仕様については、optimize:clear — キャッシュをクリアするコマンド でも解説しています。

Laravelの5大キャッシュ一覧と個別クリアコマンド

Laravelには複数のキャッシュ機構が存在し、それぞれ保存先やクリアコマンドが異なります。それぞれの役割と違いを理解しておくことで、トラブル時に適切な対処ができるようになります。

キャッシュ種別	主な内容・対象	保存先ディレクトリ / ファイル	個別クリアコマンド	キャッシュ生成コマンド
設定（Config）	.env や config/*.php の設定値	bootstrap/cache/config.php	php artisan config:clear	php artisan config:cache
ルート（Route）	routes/*.php で定義した全ルート	bootstrap/cache/routes-v7.php	php artisan route:clear	php artisan route:cache
ビュー（View）	事前コンパイルされたBladeテンプレート	storage/framework/views/*.php	php artisan view:clear	php artisan view:cache
アプリ（Application）	Cache::put() 等で保存したデータ	storage/framework/cache/data/ または Redis / DB	php artisan cache:clear	—（アプリコード内で動的に生成）
イベント（Event）	イベントとリスナーの自動ディスカバリ情報	bootstrap/cache/events.php	php artisan event:clear	php artisan event:cache

---

1. 設定キャッシュ（Config Cache）：php artisan config:clear

.env ファイルや config/ ディレクトリ配下の設定ファイルを変更した際に、変更が反映されない原因となるのが「設定キャッシュ」です。

php artisan config:clear

【実行結果の例】

   INFO  Configuration cache cleared successfully.

詳しい仕組みや対策は、config:clear — 設定キャッシュをクリアするコマンド および Laravelの.envが反映されない原因4つと解決策 で詳しく解説しています。

---

2. ルートキャッシュ（Route Cache）：php artisan route:clear

新しいルーティング（URL）を routes/web.php や routes/api.php に追加したのに「404 Not Found」になる場合や、ルート名・コントローラーのアクション変更が反映されない場合は、ルートキャッシュをクリアします。

php artisan route:clear

【実行結果の例】

   INFO  Route cache cleared successfully.

本番環境では php artisan route:cache（または php artisan optimize）によってすべてのルートが1つのシリアライズされたファイル（bootstrap/cache/routes-v7.php）に結合され、ルート解決が劇的に高速化されます。しかし開発中にキャッシュが残っていると変更が一切検知されなくなるため、開発中はキャッシュをクリアした状態にしておきます。

詳細は route:clear — ルーティングキャッシュをクリアするコマンド を参照してください。

---

3. ビューキャッシュ（View/Blade Cache）：php artisan view:clear

Bladeテンプレート（resources/views/**/*.blade.php）を修正したのにブラウザの表示が変わらない場合は、ビューキャッシュを削除します。

php artisan view:clear

【実行結果の例】

   INFO  Compiled views cleared successfully.

LaravelのBladeテンプレートは、初回アクセス時に素のPHPコードへとコンパイルされ、storage/framework/views/ ディレクトリ内にハッシュ値の名前（例: a1b2c3d4...php）で保存されます。通常はファイルの更新日時を検知して自動再コンパイルされますが、タイムスタンプの不整合やパーミッション問題で更新されない場合に view:clear が効果を発揮します。

詳細は view:clear — 事前コンパイルされた Blade ビューを削除するコマンド をご覧ください。

---

4. アプリケーションキャッシュ：php artisan cache:clear

Cache ファサード（Cache::put()、Cache::remember() など）を使ってプログラム内で保存したデータ（データベースクエリの結果やAPIレスポンスのキャッシュなど）をすべて破棄したい時に実行します。

php artisan cache:clear

【実行結果の例】

   INFO  Application cache cleared successfully.

特定のタグやドライバのみクリアする

RedisやMemcachedなどタグ対応のキャッシュドライバを使用している場合、特定のタグのみをクリアしたり、特定の接続ストアを指定してクリアすることも可能です。

# 特定のキャッシュタグのみをクリア
php artisan cache:clear --tags=users,posts

# 特定のキャッシュストア（例: redis）を指定してクリア
php artisan cache:clear redis

PHPプログラム内からキャッシュを操作・削除する

Artisanコマンドではなく、コード内から特定のキーやタグをピンポイントで削除したい場合は、Cache ファサードを利用します。

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;
use IlluminateSupportFacadesCache;
use AppModelsPost;

class PostController extends Controller
{
    public function update(Request $request, $id)
    {
        // 記事を更新
        $post = Post::findOrFail($id);
        $post->update($request->validated());

        // 特定のキャッシュキーを削除
        Cache::forget("post_{$id}");

        // タグでグループ化されたキャッシュを一括削除（Redis等）
        Cache::tags(['posts'])->flush();

        return redirect()->route('posts.show', $id);
    }
}

Cacheファサードの詳しい使い方は、Laravel Cacheの使い方完全ガイド をご覧ください。

---

5. イベントキャッシュ（Event Cache）：php artisan event:clear

Laravelでは、イベントリスナーの対応関係を自動検出（Event Discovery）してキャッシュする機能があります。新しいイベントリスナーを追加したのに発火しない場合は、イベントキャッシュをクリアします。

php artisan event:clear

【実行結果の例】

   INFO  Cached events cleared successfully.

---

その他の便利なクリアコマンド

Laravelには、用途に応じて以下のような個別クリアコマンドも用意されています。

• コンパイル済みクラスのクリア：php artisan clear-compiled（古い最適化ファイルを削除）
• 認証リセットトークンのクリア：php artisan auth:clear-resets（期限切れパスワードリセットトークンを削除）
• キューのクリア：php artisan queue:clear（キューに溜まった未処理ジョブを全削除）
• スケジュールキャッシュのクリア：php artisan schedule:clear-cache（重複実行防止ミューテックスを解除）

開発環境と本番環境でのキャッシュ運用の違い

キャッシュの扱いは、「ローカル開発環境」 と 「本番環境（商用サーバー）」 で全く異なります。運用のルールを間違えると、開発効率の低下や本番サイトのパフォーマンス低下を招きます。

1. 開発環境（ローカル）：基本的にキャッシュを作らない

開発中はコードや設定を頻繁に変更するため、設定・ルート・ビューのキャッシュを作成しない（キャッシュクリアした状態を維持する） のが基本です。

• 開発中に config:cache や route:cache を実行しない
• 挙動がおかしくなったら、まず php artisan optimize:clear を実行する

2. 本番環境：デプロイ時に「クリア → 一括再構築」を行う

本番環境では、リクエストごとのファイル読み込みや解析オーバーヘッドをなくすため、必ずキャッシュを構築して運用します。

本番サーバーへのデプロイフローには、古いキャッシュをクリアした後に必ず php artisan optimize で再キャッシュする手順を組み込みます。

# 本番環境デプロイスクリプトの標準的な手順
cd /var/www/my-laravel-app

# 1. メンテナンスモード有効化（必要に応じて）
php artisan down

# 2. 最新コードの取得 & 依存関係インストール
git pull origin main
composer install --no-dev --optimize-autoloader

# 3. マイグレーション実行
php artisan migrate --force

# 4. 古いキャッシュをクリア
php artisan optimize:clear

# 5. 本番用キャッシュを一括再構築（config, routes, views, eventsをまとめてキャッシュ）
php artisan optimize
php artisan view:cache

# 6. メンテナンスモード解除
php artisan up

optimize コマンドの詳細は、optimize — キャッシュを一括作成して起動を高速化 を参照してください。

キャッシュクリアしても反映されない原因と対処法5選

php artisan optimize:clear を実行したにもかかわらず、画面や設定の変更が反映されない場合は、Laravelの枠組み外に原因があります。以下の5項目を順番に確認してください。

1. ブラウザキャッシュ / CDN（Cloudflare等）が残っている

CSS、JavaScript、画像ファイルなどの静的アセットや、HTTPレスポンスヘッダーによるブラウザキャッシュが原因の場合です。

• 対処法：
  • ブラウザで「ハード再読み込み（スーパーリロード）」（Windows: Ctrl + F5 または Ctrl + Shift + R、Mac: Cmd + Shift + R）を実行する
  • シークレットウィンドウ（プライベートブラウズ）で開いて確認する
  • CloudflareやAWS CloudFrontなどのCDNを使っている場合は、CDN側のキャッシュパージを実行する

2. PHP OPcache（PHP-FPM）がコードを保持している

PHPのパフォーマンス向上モジュール「OPcache」が有効になっている環境（特に本番サーバーやステージング環境）では、PHPスクリプトのバイトコードがメモリ上にキャッシュされるため、ファイルを書き換えても即座に反映されないことがあります。

• 対処法：PHP-FPMプロセスを再起動します。

# Ubuntu / Debian の場合（PHP 8.3 の例）
sudo systemctl restart php8.3-fpm

# Nginx も再起動する場合
sudo systemctl restart nginx

3. ディレクトリのパーミッション（書き込み権限）エラー

Webサーバー実行ユーザー（www-data や nginx）に storage や bootstrap/cache ディレクトリへの書き込み権限がないと、キャッシュの削除や再生成がサイレントに失敗します。

• 対処法：適切な権限を付与します。

# オーナー権限をWebサーバーユーザーに変更（Ubuntuの例）
sudo chown -R www-data:www-data storage bootstrap/cache

# 適切な書き込み権限を付与
sudo chmod -R 775 storage bootstrap/cache

4. 外部キャッシュストア（Redis / Memcached）の設定不一致

.env の CACHE_STORE（または旧 CACHE_DRIVER）に redis などを指定している場合、ローカルのファイルではなく外部サーバーにキャッシュが保持されています。設定変更後に php artisan config:clear を忘れていると、古い接続先を見に行ってしまうことがあります。

• 対処法：

  php artisan config:clear
  php artisan cache:clear

  Redisサーバーに直接ログインして FLUSHDB コマンドで全削除を試すのも有効です。

5. ターミナルで実行しているカレントディレクトリが違う

複数のプロジェクトを同時に開発している場合や、サブディレクトリでコマンドを実行していると、別のプロジェクトのキャッシュをクリアしていることがあります。

• 対処法：pwd コマンドで現在のパスを確認し、対象Laravelプロジェクトのルートディレクトリ（artisan ファイルがある場所）で実行しているか確かめましょう。

【緊急時】Artisanコマンドがエラーで動かない時の手動削除手順

「コードに致命的な文法エラー（Syntax Error）がある」「破損したキャッシュが原因で php artisan コマンド自体が例外を出して起動しない」という緊急事態では、コマンドラインからのキャッシュクリアができません。

そのような場合は、キャッシュファイルをファイルシステムから直接手動削除 することで復旧できます。

手動削除の対象ファイル・ディレクトリ一覧

削除対象のパス	説明	削除時の注意点
bootstrap/cache/config.php	設定キャッシュファイル	削除してOK（次回アクセス時に自動生成または非キャッシュ動作）
bootstrap/cache/routes-v7.php	ルートキャッシュファイル	削除してOK
bootstrap/cache/events.php	イベントキャッシュファイル	削除してOK
bootstrap/cache/packages.php	パッケージディスカバリキャッシュ	削除してOK（php artisan package:discover で再生成）
bootstrap/cache/services.php	サービスプロバイダーキャッシュ	削除してOK
storage/framework/views/*.php	コンパイル済みBladeビュー群	ディレクトリ自体は残し、中身の .php ファイルのみ削除
storage/framework/cache/data/*	ファイルドライバのアプリキャッシュ	ディレクトリ自体は残し、中身のファイル・フォルダのみ削除

Linux / Mac での手動削除一括コマンド

# bootstrap/cache 配下の生成ファイルを一括削除（.gitignore 以外の全 .php）
rm -f bootstrap/cache/*.php

# storage 配下のコンパイル済みビューとキャッシュデータを削除
rm -rf storage/framework/views/*.php
rm -rf storage/framework/cache/data/*

Windows（PowerShell）での手動削除コマンド

# bootstrap/cache 配下の php ファイルを削除
Remove-Item bootstrapcache*.php

# views 配下の php ファイルを削除
Remove-Item storageframeworkviews*.php

よくある質問（FAQ）

Q1. php artisan cache:clear と optimize:clear はどう使い分けますか？

日常の開発作業で「変更が反映されない」「ルーティングや.envを書き換えた」という場合は、すべてのキャッシュをまとめてリセットできる php artisan optimize:clear を使うのが最も安全で確実です。
一方、php artisan cache:clear は「Cache::remember() でキャッシュしたAPIデータやDB検索結果のデータだけを破棄したい」といったピンポイントな用途で使用します。

Q2. キャッシュをクリアするとユーザーのログインセッションは消えますか？

セッションの保存先設定（.env の SESSION_DRIVER）によって異なります。

• SESSION_DRIVER=file（デフォルト）や database の場合：php artisan cache:clear や optimize:clear を実行してもセッションは消えません（ログインは維持されます）。
• SESSION_DRIVER=redis や memcached かつ CACHE_STORE と同じストアを共有している場合：cache:clear の実行方法やRedisのFLUSH操作によってセッションが消える可能性があります。本番環境ではセッションとキャッシュのプレフィックスやDB番号を分ける設計が推奨されます。

Q3. .env を書き換えたのに php artisan config:clear をしても反映されません。

以下の3点を確認してください。

1. Docker/Sail環境の場合、コンテナの再起動（sail restart または docker compose restart）が必要な場合があります。
2. コード内で env() 関数を直接呼び出していないか確認してください。設定キャッシュ作成後は config('xxx') 経由でないと値を取得できません。
3. OS環境変数やWebサーバー（Nginx / Apache）の設定で同名の環境変数が上書き定義されていないか確認してください。

Q4. キャッシュクリアはサーバーに負荷をかけますか？

キャッシュクリア自体はファイルの削除処理のため、サーバーへの直接的な負荷は非常に小さいです。ただし、アクセス数が多い本番サーバーでキャッシュを一気にクリアすると、その直後に大量のユーザーからリクエストが来た際に「設定読み込み」「ルート解決」「Bladeコンパイル」「DB問い合わせ」が一斉に発生し、CPU使用率や応答時間が跳ね上がる（キャッシュスタンピード現象）リスクがあります。
そのため、本番環境では必ず optimize コマンドで事前キャッシュを行ってからリクエストを受け付けるようにしてください。

まとめ｜迷ったら php artisan optimize:clear を実行しよう

Laravelのキャッシュクリアについて要点をまとめます。

• 全キャッシュを一括で消す：php artisan optimize:clear（開発中のトラブルシューティングはまずこれ）
• .envや設定ファイルの変更：php artisan config:clear
• ルート追加・変更の反映：php artisan route:clear
• Bladeテンプレートの更新：php artisan view:clear
• Cacheファサードの保存データ削除：php artisan cache:clear
• 本番環境でのデプロイ：optimize:clear の後に必ず php artisan optimize で再構築する
• コマンドが動かない緊急時：bootstrap/cache/*.php と storage/framework/views/*.php を手動削除する

Laravelの各種キャッシュの仕組みを理解して正しく使い分けることで、開発時の「反映されない」ストレスを解消し、本番環境でも高速で安定した運用を実現しましょう。