CakePHP4でcontrollerで実行したバリデーションエラーをmodelのにマージする方法

2022/07/13 2023/12/28

CakePHP4でcontrollerで実行したバリデーションエラーは「setError()」「setErrors()」でセットする

　
CakePHP4では強力なバリデーション（入力チェック）機能が用意されていますので、簡単にいろいろなバリデーションを組み込むことができます。
　
通常のバリデーションは Modelの中に記述します。
（src/Model/Table/ArticleTable.php 内の validationDefault()に記述します。）
　
ですが、この記事では、独自のバリデーションを controller内に記述する際の処理について解説します。
　
独自のバリデーションを controller内に記述し、その処理で発生したエラーを Model内のバリデーションの結果に追加して（エンティティにエラーをセットして）、まとめてバリデーションのエラーとして画面に表示したい、という場合の方法についての解説となります。
　
　
この記事は、CakePHP4について書いていますが、CakePHP3でも同様に記述することで同様の処理を行うことができます。
　
　

エラーのセットは「setError()」「setErrors()」を使う

　
エラーのセットは、下記の 16行目のように「setError()」を使用します。
　

    public function add()
    {
        $topic = $this->Topics->newEmptyEntity();
        if ($this->request->is('post')) {

            // アップロードしたファイル情報を取得
            $file = $this->request->getData("file");
            // アップロードファイルのバリデーション
            $fileResponse = $this->CheckFile($file);

            // アップロードファイルのバリデーション結果の処理
            if(!empty($fileResponse)){
                $fileError = $fileResponse["error"];

                // エラーメッセージをセット
                $topic->setError("file",[$fileError]);

            } else {
                $filePath = WWW_ROOT . "upload" . DS .  $file->getClientFilename();
                $file->moveTo($filePath);
                $topic["file"] = $filePath;
            }

            $topic = $this->Topics->patchEntity($topic, $this->request->getData());
            if ($this->Topics->save($topic)) {
                $this->Flash->success(__('The topic has been saved.'));

                return $this->redirect(['action' => 'index']);
            }
            $this->Flash->error(__('The topic could not be saved. Please, try again.'));
        }
        $this->set(compact('topic'));
    }

public function add()

{

$topic = $this->Topics->newEmptyEntity();

if ($this->request->is('post')) {

// アップロードしたファイル情報を取得

$file = $this->request->getData("file");

// アップロードファイルのバリデーション

$fileResponse = $this->CheckFile($file);

// アップロードファイルのバリデーション結果の処理

if(!empty($fileResponse)){

$fileError = $fileResponse["error"];

// エラーメッセージをセット

$topic->setError("file",[$fileError]);

} else {

$filePath = WWW_ROOT . "upload" . DS . $file->getClientFilename();

$file->moveTo($filePath);

$topic["file"] = $filePath;

}

$topic = $this->Topics->patchEntity($topic, $this->request->getData());

if ($this->Topics->save($topic)) {

$this->Flash->success(__('The topic has been saved.'));

return $this->redirect(['action' => 'index']);

}

$this->Flash->error(__('The topic could not be saved. Please, try again.'));

}

$this->set(compact('topic'));

}

　
上記は「Topics」というテーブルにファイルをアップロードする処理があり、そのアップロードしたファイルのバリデーションを controller（内にある関数）で実行し、エラーが発生したら「setError()」を使用して、エラーメッセージをセットする、という処理です。
　
9行目でアップロードしたファイルをチェックする独自のバリデーション関数「$this->CheckFile()」を使ってバリデーションを行います。
12行目でエラーの有無をチェックして、エラーが発生した場合は、16行目の「setError()」にメッセージをセットしています。
　
　

　
セットされたエラーメッセージは上記のような感じで、Modelのバリデーションと同じように表示されます。
　
　

「setError()」と「setErrors()」の使い方

　
controllerの処理で確認したエラーをエンティティにセットするには「setError()」と「setErrors()」を使用します。
　
「setError()」と「setErrors()」の違いは下記のようになっています。
　
　「setError()」は 1つのフィールドのエラーを記述
　「setErrors()」は、複数のフィールのエラーをまとめて記述
　
　

「setError()」の使い方

　
「setError()」の使い方は下記のようになります。
　

$topic->setError("フィールド名",["エラーメッセージ1","エラーメッセージ2"]);

1	$topic->setError("フィールド名",["エラーメッセージ1","エラーメッセージ2"]);

　
1つめのパラメータに「フィールド名」を記述し、2つ目のパラメータに「エラーメッセージ」を「配列」で記述します。
エラーメッセージは配列で指定しますので、エラーメッセージが複数ある場合は配列で指定すれば OKです。
　
Model側の処理でもバリデーションは実行され、発生したエラーは追加されますので、Model内と controller内と区別されることなく、入力画面にエラーメッセージが表示されます。
　
　

「setErrors()」の使い方

　
「setErrors()」の使い方は下記のようになります。
　

$topic->setErrors([
    "フィールド名1" => ["エラーメッセージ1-1","エラーメッセージ1-2"],
    "フィールド名2" => ["エラーメッセージ2-1","エラーメッセージ2-2"]
]);

$topic->setErrors([

"フィールド名1" => ["エラーメッセージ1-1","エラーメッセージ1-2"],

"フィールド名2" => ["エラーメッセージ2-1","エラーメッセージ2-2"]

]);

　
「setError()」とほとんど同じですが、複数のフィールドのエラーをまとめて記述することができるようになっています。
　
　

参考資料

　
この記事を書く際に参考にしたオフィシャルの Cookbookの URLを記載しておきます。
　
https://book.cakephp.org/3/ja/orm/entities.html#id8
https://book.cakephp.org/4/ja/orm/entities.html#id8
https://api.cakephp.org/4.1/class-Cake.ORM.Entity.html
　
　

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

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

Message コメントをキャンセル

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

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

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

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

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

: CakePHP3でデフォルトのソート条件を設定してユーザの選択肢たソート条件を有効にする方法

CakePHP3でデフォルトのソート条件を設定しつつ画面上でユーザがソート条件を選択したときもソート処理を実行させる方法を解説。ソート条件はページネーションの処理として実装。

: CakePHP 2.3　連携先のテーブルの項目で条件抽出する場合

アソシエーション（連携）している先のテーブルの項目で条件抽出する際の考え方と注意点をサンプルソースを用いて説明しています。

: CakePHP3でテーブルにカラム（項目）を追加したときに変更するポイントのまとめ

CakePHP3でシステム開発をする際、途中でカラムを追加した場合に何を変更すればいいかを確認。カラムを追加する前後で Bakeした結果を比較し、変更になった点をリストアップした。

: CakePHP4のフラッシュメッセージの表示場所、デザインを変更する方法を解説

CakePHP4のエラーメッセージ、完了メッセージなどを表示するフラッシュ処理の解説。Controller、レイアウトファイル、テンプレートファイルでそれぞれ処理を指定する。

: CakePHP3のUpload Plugin 3.0をバリデーションなど実運用向けのカスタマイズ方法解説・その２

CakePHP3でファイル、画像をアップロードするプラグイン、upload plugin 3を導入する手順を解説した記事。3部作のその2でバリデーションなどの実用的なカスタマイズ方法を解説。

: CakePHP3のCakeDC/UsersのUserHelperでログアウトやreCAPTCHAをカスタマイズ

CakeDC謹製Usersプラグインの紹介。UserHelperを利用し、ログアウトのリンクや権限があるときのみ表示されるリンク、プロフィールページへのリンク、reCAPTCHAの設置方法などを解説。

: CakePHP3のプラグイン「CakeDC/Users」を日本語化・翻訳ファイルもダウンロード可

CakePHP3のユーザ管理、ログイン認証プラグインである「CakeDC/Users」のメッセージを日本語にする手順の解説とともに、日本語の翻訳ファイルを提供。ファイルを設置すれば日本語になる！

: CakePHP5でヘルパーから他のヘルパーを読み込む方法・CakePHP4からの変更点

CakePHP5のヘルパーで他のヘルパーを読み込む方法を解説。公式の日本語CookbookはCakePHP4のソースのままで間違っているため注意が必要。CakePHP4からの移行の際も同じ点に注意が必要。