CakePHPでデータベースのカスタムバリデーションが動かないときはnewEntityかpatchEntityを使っているか確認する

CakePHPで、カスタムバリデーションが動作しない自体が発生しました。
コードを追いかけると以下のようなコードでした（元のコードを元にサンプル作成）

// 記事を公開するかどうか
$isPublish = $this->request->getData('is_publish');

// 該当記事のEntityを取得
$articles = $this->Articles->get($page);

// 公開・非公開の情報をEntityにセット
$articles->is_publish = $isPublish;

// DBに保存
$this->Articles->save($articles);

一見間違いなさそうに見えますが、CakePHPでは、newEntityまたはpatchEntity実行時にしかカスタムバリデーションが発火しないとのこと。

CakePHPでは、newEntityまたはpatchEntity実行時にしかカスタムバリデーションが発火しないので、上記のコードをnewEntityまたはpatchEntityを使って更新してあげればOKでした。

// 記事を公開するかどうか
$isPublish = $this->request->getData('is_publish');

// 該当記事のEntityを取得
$articles = $this->Articles->get($page);

// DBに保存
$articleEntity = $this->Articles->patchEntity($articles, ['is_publish' => $isPublish]);
$this->Articles->save($articleEntity);

単純にバリデーションがかかっているならいいのですが、
例えば「記事のタイトルが必須」などの条件が含まれている場合、上記のコードでは

cakephp patchEntity This field is required

のようなエラーが発生します。

これは、newEntityまたはpatchEntity実行時にバリデーションが実行されるので、更新項目にタイトルが含まれていないから起こります。
このような場合は、全データを追加してあげることで回避できそうです。

// 記事を公開するかどうか
$isPublish = $this->request->getData('is_publish');

// 該当記事のEntityを取得
$articles = $this->Articles->get($page);

// 全データを配列に
$articleArray = $articles->toArray();

// 更新したい要素を上書きする
$articleArray['is_publish'] = $isPublish;

// DBに保存
$articleEntity = $this->Articles->patchEntity($articles, $articleArray);
$this->Articles->save($articleEntity);

以上です

• https://ja.stackoverflow.com/questions/41104/cakephp3でバリデーションが通らないのですが原因が分かりません
• https://book.cakephp.org/3/ja/orm/validation.html#id20
• https://stackoverflow.com/questions/49320361/cakephp-3-0-throwing-field-required-error-on-non-empty-field

[PR] おすすめの本

この記事を書いた人

Nな人（えぬなひと）。
Nは本名から取っています。
Laravelが大好きなPHPerで、WEBを作るときはLaravelを技術スタックに絶対推すマン。
PHP、Pythonと、昔はperlを書いていたP言語エンジニア。
最近はNimを書いたりしています。