CakePHP4のController内でViewテンプレート、レイアウトの変更設定を記述する方法

2024/08/10 2024/09/08

CakePHP4のController内でViewテンプレート、レイアウトの指定はrenderを使用する

　
CakePHP4では、Controller内で Viewテンプレートや、レイアウトファイルをデフォルト以外のものに変更したいときは下記のように記述します。
　

$this->render(string $view, string $layout);

1	$this->render(string $view, string $layout);

　
上記を記述することで、Viewのテンプレート、および、レイアウトを指定する事ができます。
　
　
また、テンプレート、レイアウトを使用しない場合は、下記の記述をします。
　

// テンプレートファイルを使用しない場合
$this->autoRender = false;
// レイアウトファイルを使用しない場合
$this->layout = false;

// テンプレートファイルを使用しない場合

$this->autoRender = false;

// レイアウトファイルを使用しない場合

$this->layout = false;

CakePHP4でrenderに Viewを指定する具体的な記述方法の解説

　
具体的に、Controller内で Viewテンプレートや、レイアウトファイルをデフォルト以外のものに変更したいときの記述方法を解説します。
　

$view = "/element/sampleView";
$layout = "sampleLayout";

$this->render($view, $layout);

$view = "/element/sampleView";

$layout = "sampleLayout";

$this->render($view, $layout);

　
「$view」に編集するテンプレートのファイル名ですが、下記のルールがあります。
・拡張子の「.php」は記述しない
・標準フォルダ内にある場合はファイル名のみで OK
・「/」から始めると「/templates」からの相対パスになる
　
　

デフォルト設定で処理される Viewについて

　
そのため、例えば、下記の Controller、Actionで処理をしているとします。
　Controller名「Samples」
　Action名「getData」
　
この場合、「render」でテンプレートを指定しないデフォルトの状態では下記のファイルをテンプレートとして使用します。
　/templates/Samples/get_data.php
　
ここで注意が必要な点は、Action名は「getData」のようにローワーキャメルケースで記述しますが、テンプレートのファイル名は「get_data.php」のようにスネークケースで記述することになります。
　
これを間違えると下記の「テンプレートファイルがないよ」というエラーが発生します。
Missing Template Cake\View\Exception\MissingTemplateException Error The view for SamplesController::getData() was not found.
　
　

デフォルトのフォルダ内にある Viewを renderに指定をする方法

　
今度は、デフォルトのフォルダ内にある「get_image.php」というテンプレートファイルを使用したい場合の対応です。
　
下記のファイルを使用します。
　/templates/Samples/get_image.php
　
この場合の renderに指定する記述方法は以下となります。
　

$view = "get_image";

$this->render($view);

$view = "get_image";

$this->render($view);

　
上記のように、「$view」に「get_image」と、テンプレート名を指定します。
　
「$view = "getImage";」のようにローワーキャメルケースで記述しても動作はしますが、公式 Cookbookでもスネークケースで記述してありますので、規約上はスネークケースで記述する方が正しいようです。
　
ちなみに、「$view = "getImage";」と記述しても、テンプレートファイルは「get_image.php」である必要があり、「getImage.php」では読み込まれません。
　
　

フォルダのパスも含めて Viewを指定をする方法

　
最後は、フォルダのパスも含めて Viewのファイル名を指定する方法です。
　
下記のファイルを使用します。
　/templates/element/get_record.php
　
この場合の renderに指定する記述方法は以下となります。
　

$view = "/element/get_record";

$this->render($view);

$view = "/element/get_record";

$this->render($view);

　
上記のように、「$view」に「/」から始まるパスを記述すると「/templates」からの相対パスとして扱われます。
　
　
実ファイルを「/templates/element/getRecord.php」とした場合、「$view = "getRecord";」とすることで、テンプレートファイルを読み込むことはできます。
ですが、公式 Cookbookではスネークケースで記述してありますので、規約上はスネークケースで記述する方が正しいようです。
　
ファイル名がキャメルケースの「getRecord.php」である場合は renderにも「getRecord」と記述する必要があり、スネークケースの「get_record.php」である場合は renderにも「get_record」と記述する必要があるようです。
キャメルケース、スネークケースが混在している場合はエラーになります。
　
　
ちなみに、規約からは外れるようですが、
　/templates/Samples/getData.php
上記のように、標準フォルダ内にキャメルケースで記述したファイルをテンプレートとして使用する場合は、
　$view = "/Samples/getData";
のようにパス付でファイル名を指定する事で使用することは可能です。
　
　

「render()」を使用する際の注意点・renderは最後に書く理由

　
「render()」を使用する場合の注意点は
「$this->render(string $view, string $layout);」は可能な限り Controller内の最後に書くことが必要です。
　
　
理由は単純です。
「$this->render(string $view, string $layout);」の後に記述された「$this->set()」の変数は受け取ることができないためです。
　
　

// 問題は発生しない順番
$this->set(compact("sampleData01","sampleData02"));
$this->render("sampleView");

// 問題が発生する順番（変数を受け取れない）
$this->render("sampleView");
$this->set(compact("sampleData01","sampleData02"));

// 問題は発生しない順番

$this->set(compact("sampleData01","sampleData02"));

$this->render("sampleView");

// 問題が発生する順番（変数を受け取れない）

$this->render("sampleView");

$this->set(compact("sampleData01","sampleData02"));

　
　
「render()」関数に限った話ではありませんし、CakePHP3のころも同じであったと思いますが、「render()」で指定したテンプレート内で使用する変数は、「render()」を記述するより前に「$this->set()」で指定しておく必要があります。
　
順番が逆だと、Viewテンプレートでは変数を扱うことができませんので、「変数がないよ！」というエラーが発生します。
　
　
単純なことなだけにエラーが発生したときになかなか気づけない不具合とも言えます。
　
　

テンプレート、レイアウトを使用しない場合は autoRender、layoutに falseを指定する

　
前項までは、テンプレートファイル、レイアウトファイルを指定して使用する方法の解説でしたが、テンプレートファイル、レイアウトファイルを使用しない場合の設定方法を解説します。
　

// テンプレートファイルを使用しない場合
$this->autoRender = false;
// レイアウトファイルを使用しない場合
$this->layout = false;

// テンプレートファイルを使用しない場合

$this->autoRender = false;

// レイアウトファイルを使用しない場合

$this->layout = false;

　
記事の最初に書いたものと同じですが、大きなポイントは CakePHP3のころは利用できた下記の記述方法が使えなくなっている、という点です。
　

// テンプレート、レイアウトを無効にする方法
$this->render(false,false);
// テンプレートだけ無効にする方法
$this->render(false,null);
// レイアウトだけ無効にする方法
$this->render(null,false);

// テンプレート、レイアウトを無効にする方法

$this->render(false,false);

// テンプレートだけ無効にする方法

$this->render(false,null);

// レイアウトだけ無効にする方法

$this->render(null,false);

　
そのため、「$this->autoRender = false;」「$this->layout = false;」をぞれぞれ指定する必要があるようです。
　
　
参考サイト
https://book.cakephp.org/4/ja/controllers.html
https://book.cakephp.org/4/ja/views.html
　
　

- CakePHP 3.x 4.x 5.x CakePHP4

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

Message コメントをキャンセル

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

: CakePHP3のCakeDC/Usersの画面、メール本文テンプレートのカスタマイズ方法解説

CakeDC謹製Usersプラグインの紹介。ユーザ新規登録の流れを紹介しつつテンプレートファイルがどこにあるか、設定情報ファイルがどこにあるか、を説明しつつカスタマイズの方法を解説します。

: Windows環境の XAMPPを利用して CakePHPの開発する際の注意点

WindowsベースにXAMPPで環境を構築しCakePHP4を利用したWebシステムを構築する際は、大文字と小文字の違いを意識する必要がある。LinuxベースのWebサーバに移動させたときに不具合で動作しないこともある。

: CakePHP 2.3　Search Pluginで検索処理　その６ORDER、sortソートの機能

CakePHPの検索プラグイン Search Pluginの検索処理の中で order、ソートについての解説です。

: CakePHP3のアソシエーションでJOINのタイプのLEFT、INNERを切り替えながら使う方法

CakePHP3でテーブルのアソシエーションしたデータの取得をコントローラー側でINNERかLEFTを指定する方法を解説。TableファイルにINNERで指定していてもController側で変更ができる。

: CakePHP3の1対多での連携を中間テーブルを使った多対多の連携に変更するときの手順

CakePHP3で「1対多」の連携を中間テーブルを利用した「多対多」の連携に変更するときの手順のまとめ。中間テーブルの設定やModelの変更などを間違いやすい箇所を指摘しながらの解説。

: CakePHP4 のコマンドプログラムからコンポーネントを読み込む方法解説

CakePHP4でコマンドプログラムからコンポーネントを呼び出す方法を解説。コントローラーから呼び出すときと大差はないが、use句でコンポーネントを指定する事がポイント。

: CakePHP4のFrozenDateで1ヵ月前、先月、今月1日、来月末の日付などを算出する方法

CakePHPには「FrozenDate」の日付を扱う関数が用意されている。これを利用して、1ヶ月後、月末日、月初日、5日後などを指定して日付を取得できる。それを解説。

: CakePHP 2.3　デバッグキット（DebugKit）超初心者向けフォロー講座

CakePHP初心者に向けてデバッグキット（DebugKit）のインストール方法、はまりポイントを解説。

: CakePHP3の更新画面でUpload Plugin 3.0を使う方法、viewで使う方法解説・その３

CakePHP3でファイル、画像をアップロードするプラグイン、upload plugin 3を導入する手順を解説した記事。3部作のその3で記事を更新する際のファイルの取り回しなどについてを解説。