コントローラーからのバリデーション

通常は単にモデルの save メソッドを使うことが多いと思いますが、時にはデータを保存せずにバリデーション（妥当性チェック）だけをやりたいというケースもあるかもしれません。たとえばデータベースに実際にデータを保存する前に、なんらかの追加情報を表示したい場合もあるでしょう。バリデーションには単なるデータの保存とは若干異なる処理が必要です。

まず、データをモデルにセットします:

$this->ModelName->set($this->request->data);

そしてバリデーションするにはモデルの validates メソッドを使います。これはデータが正しければ true 、エラーがあれば false を返します:

if ($this->ModelName->validates()) {
    // 正しい場合のロジック
} else {
    // 正しくない場合のロジック
    $errors = $this->ModelName->validationErrors;
}

モデルで指定されているバリデーションのうちの、一部だけを適用したい場合もあると思います。たとえば User というモデルがあって、その中に first_name, last_name, email, password という項目があるとします。ユーザを作成または編集するためのインスタンスでは、 4 項目すべてのバリデーションを行うべきですね。一方ユーザがログインする際は email と password のルールだけをチェックすれば済みます。これを行うには、チェックする項目を指定したオプション配列を渡してあげます:

if ($this->User->validates(['fieldList' => ['email', 'password']])) {
    // バリデーションOK
} else {
    // バリデーションNG
}

validates メソッドは invalidFields メソッドを呼び出しますが、この中でモデルの validationErrors プロパティを設定します。 invalidFields はまた、そのデータを結果として返します:

$errors = $this->ModelName->invalidFields(); // validationErrors 配列を返す

バリデーション結果のエラーリストは一連の invalidFields() の呼び出しの間はクリアされません。このため、ループの中でバリデーションを行っている際にそれぞれのエラーを個別に取得する場合は、 invalidFields() を使ってはいけません。その代わりに validates() を使い、モデルのプロパティである validationErrors にアクセスしてください。

重要な点としては、データのバリデーションを行うにあたり、事前にそのデータはモデルにセットされていなければならないということです。これは、データがパラメータとして渡される save メソッドとは異なります。さらに、必ずしも save の前に validates を呼ぶ必要もありません。これは、save では実際にデータの保存をする前に、自動的にバリデーションが行われるためです。

複数のモデルのバリデーションを行うには次のアプローチを使います:

if (
    $this->ModelName->saveAll(
        $this->request->data,
        ['validate' => 'only'],
    )
) {
  // データは有効
} else {
  // データは無効
}

もし save の前に妥当性チェックが終わっていれば、二度目のチェックを省略することができます:

if (
    $this->ModelName->saveAll(
        $this->request->data,
        ['validate' => false],
    )
) {
    // チェックを省略して保存する
}

コントローラーからのバリデーション ​

コントローラーからのバリデーション