CakePHP3のルーティング（routes.php）の変更が反映されない時はキャッシュのクリアを

2019/02/02

CakePHP3のルーティングを変更しても反映されない時がある。そんなときは慌てずにキャッシュをクリアしよう！

ルーティングの設定を再設定するキャッシュのクリア方法

　
このルーティングの設定は「/config/routes.php」ファイルに記述します。
記述を変更すればすぐに反映されますが、時々、ルーティングの設定がうまく反映されない場合もあります。
　
その時は、CakePHP3のキャッシュを疑ってください。
　
下記のコマンドを実行してキャッシュをすべて削除します。
　

$ cd [CakePHPのルートフォルダ]
$ bin/cake cache clear_all

1 2	$ cd [CakePHPのルートフォルダ] $ bin/cake cache clear_all

　
そして、改めて動作を確認してみてください。
　
　

ルーティングの設定とキャッシュのクリア方法の詳細解説

ルーティング設定とは URLを自由に設計する機能

　
CakePHP3には、プログラムと URLを関連付けるための設定、ルーティングを設定することができるようになっています。
　
例えば、「Controller：test」「action：view」のプログラムを作ったとします。
　
CakePHP3の場合は、デフォルトでの URLは以下のようになります。
http://example.com/test/view
　
ですが、ルーティング（routes.php）の設定を行うことで、自由な URLを設定することができるようになります。
例えば、上記の URLを下記のように変更することもできます。
http://example.com/aaa/bbb
　
このような URLの変更をするのがルーティングの設定で、「/config/routes.php」ファイルに記述します。
　
　
この記事ではルーティングの設定方法の解説は行いませんので、ルーティングの設定方法を知りたい場合は、下記のオフィシャルサイトを見ていただくか、ググってください。
　
CakePHP3・Cookbook・ルーティング
https://book.cakephp.org/3.0/ja/development/routing.html
　
　

ルーティングの設定変更が正しく反映されないときはキャッシュをクリアしよう！

　
このルーティングの設定は「/config/routes.php」ファイルに記述します。
記述を変更すれば普通はすぐに反映されますが、時々、ルーティングの設定がうまく反映されない場合もあります。
　
その時は、CakePHP3のキャッシュを疑ってください。
　
ローカル環境ではあまりキャッシュを残す設定にしていないことが多いため、ついつい忘れがちですが、ルーティングの設定もキャッシュされています。
　
そのキャッシュを削除する場合は、下記のコマンドを実行します。
このコマンドでキャッシュをすべて削除することができます。
　

$ cd [CakePHPのルートフォルダ]
$ bin/cake cache clear_all

1 2	$ cd [CakePHPのルートフォルダ] $ bin/cake cache clear_all

　
キャッシュを削除したら、改めて動作の確認をしてみてください。
　
　
ちなみに、キャッシュの削除は、かつては「/tmp/cache/」フォルダの中のファイルを手作業で削除していましたが、CakePHP 3.3で上記のコマンドが実装されましたので、コマンド一発ですべて削除できるようになりました。
　
キャッシュを削除する方法の詳しい解説については下記に記事を書いています。
CakePHP3、CakePHP4のキャッシュをクリアする方法「bin/cake cache clear_all」を使う
　
また、ルーティング機能を活用して、CakePHP3の中に静的なページを組み込む方法については下記に記事を書いています。
CakePHP3で静的ページの作成は webrootか pagesを使う。トップページを参考に解説
　
　

- CakePHP 3.x 4.x 5.x CakePHP3

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP 2.3　Search Pluginで検索処理　その４前方一致検索、後方一致検索、不等号による検索、between句による範囲検索

CakePHPの検索プラグイン Search Pluginの検索処理の中で前方一致検索、後方一致検索、不等号による検索、between句による範囲検索の解説です。

: CakePHP5系でDeprecatedを回避しfindListでキーと値のカラムを指定して取得する方法

CakePHP4のfindListでキーと値のカラムを指定してテーブルにアクセスする方法がCakePHP5では「Deprecated（非推奨）」となった。推奨の記述方法を解説。

: CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合の詳細ページの注意点

ID以外のカラムでアソシエーション（連携）させて詳細ページを表示させる際の考え方と注意点をサンプルソースを用いて解説しています。

: CakePHP3のCakeDC/Usersのバリデーションのカスタマイズ方法解説

CakeDC謹製Usersプラグインの紹介。Usersのカスタマイズとして入力項目のバリデーションの変更を、プラグインのファイルは触らずオーバーライドにより実装する方法を解説する。

: CakePHP4、5で$_SERVERと同じようにURIを取得する「getUri()」の紹介

PHPでサーバ情報、環境情報を取得する際は「$_SERVER」を利用するが、似たような情報をCakePHPの関数で取得する際は「getUri()」を使用する。取得出来る値は一致するものもあるが、違うものもあり便利な使い方もある。

: CakePHP3のメッセージ日本語化の設定（国際化と地域化の機能の使い方の解説）

CakePHP3の英語のメッセージを日本語化（多言語化）する手順を解説。オリジナルのメッセージを作成する方法やプログラムで文言を追加する場合の対応なども解説。

: CakePHP4のCakeDC/Usersの Usersへの接続、バリデーションのカスタマイズ方法解説

CakeDC謹製Usersプラグインの紹介。CakePHP4で使う場合のUsersのカスタマイズとして入力項目のバリデーションの変更を、プラグインのファイルは触らずオーバーライドにより実装する方法を解説する。