CakePHP3、CakePHP4のキャッシュをクリアする方法「bin/cake cache clear_all」を使う

CakePHP3、CakePHP4では「bin/cake cache clear_all」を使ってキャッシュをクリア

「bin/cake cache clear_all」コマンドを使ってすべてのキャッシュを一括クリア

　
CakePHP3、CakePHP4のキャッシュをクリアするには下記のコマンドを実行します。
（この記事は、CakePHP3の記事として書きましたが、CakePHP4でも同様に動作することを確認しています。「CakePHP3」を「CakePHP4」と読み替えていただいて問題ありません。）
　

　
かつて、CakePHPでキャッシュをクリアする場合は、
CakePHP2の頃は「/app/tmp/cache/」フォルダの中身を、CakePHP3では「/tmp/cache/」フォルダの中身を手作業で削除していく必要がありました。
　
　
ですが、CakePHP3.3でキャッシュ削除するコマンドが追加されましたので、コマンドを入力することで、簡単にキャッシュを削除することができるようになりました。
　
また、コマンドが用意されたことで、
「このファイルキャッシュなのかな？」
「消していいのかな？」
「間違っていてプログラムが動かなくなったりしないかな？」
なんていう心配が要らなくなりました。
　

キャッシュのリストを表示させて個別に削除する方法

　
先に紹介した「bin/cake cache clear_all」コマンドは「clear_all」とあるように、キャッシュをまとめて全て削除するコマンドです。
　
キャッシュをまとめて全部消してしまっても問題ありませんが、場合によってはキャッシュを指定してクリアしたい場合もあるかもしれません。
　
その時のためにキャッシュを指定して削除する方法も用意されています。
　
まず、下記の「bin/cake cache list_prefixes」コマンドでキャッシュのリストを表示させることができます。
　

　
続けて、下記のようにキャッシュを指定して削除を実行します。
　

　
上記は、下記で解説したルーティング情報のキャッシュを削除する場合のコマンドです。
CakePHP3のルーティング（routes.php）の変更が反映されない時はキャッシュのクリアを
　
モデルのキャッシュをクリアしたい場合は「_cake_model_」を指定します。
　
　

CakePHP3、CakePHP4のキャッシュについて

　
CakePHP3、CakePHP4のキャッシュについては、下記のオフィシャルサイトを確認してください。
　
CakePHP3・Cookbook・キャッシュ
https://book.cakephp.org/3.0/ja/core-libraries/caching.html
　
CakePHP4・Cookbook・キャッシュ
https://book.cakephp.org/4/ja/core-libraries/caching.html
　
　
ここで紹介した「bin/cake cache clear_all」コマンドで
　/tmp/cache/persistent/
　/tmp/cache/models/
　/tmp/cache/view/
フォルダの中の各ファイル、および
　/tmp/cache/myapp_cake_routes_route_collection
などのキャッシュが削除されます。
　
　
また、デフォルトは、キャッシュをファイルとして保持する設定になっています。
　
それらの設定は「/config/app.php」ファイルに記載されていますが、下記の「bin/cake cache list_prefixes」コマンドで表示される「_cake_core_」「_cake_model_」「_cake_routes_」などについては、その「/config/app.php」ファイルに記載されているコメントを読むと何についてのキャッシュなのかが分かります。
　
　

_cake_core_（CACHE_CAKECORE_URL）

　
Configure the cache used for general framework caching.
Translation cache files are stored with this configuration.
Duration will be set to ‘+2 minutes’ in bootstrap.php when debug = true
If you set ‘className’ => ‘Null’ core cache will be disabled.
　
一般的なフレームワークキャッシュに使用されるキャッシュを設定します。
翻訳キャッシュファイルはこの設定で保存されます。
debug = trueの場合、期間はbootstrap.phpで「+ 2分」に設定されます。
‘className’ => ‘Null’と設定すると、コアキャッシュは無効になります。
　
　

_cake_model_（CACHE_CAKEMODEL_URL）

　
Configure the cache for model and datasource caches.
This cache configuration is used to store schema descriptions, and table listings in connections.
Duration will be set to ‘+2 minutes’ in bootstrap.php when debug = true
　
モデルキャッシュとデータソースキャッシュ用にキャッシュを設定します。
このキャッシュ設定は、スキーマの説明とテーブルリストを接続に格納するために使用されます。
debug = trueの場合、期間はbootstrap.phpで「+ 2分」に設定されます。
　
　

_cake_routes_（CACHE_CAKEROUTES_URL）

　
Configure the cache for routes.
The cached routes collection is built the first time the routes are processed via config/routes.php.
Duration will be set to ‘+2 seconds’ in bootstrap.php when debug = true
　
ルート用のキャッシュを設定します。
キャッシュされたルートコレクションは config / routes.phpでルートが最初に処理されたときに構築されます。
debug = trueの場合、所要時間はbootstrap.phpで ‘+ 2秒’に設定されます。
　
　

CakePHP3の関連記事