データバリデーション

データバリデーションは、どのようなアプリケーションにおいても重要な部分です。なぜなら、これはモデル内のデータがアプリケーションのビジネスルールに則していることを保証する仕組みだからです。たとえば、パスワードの長さが８文字以上あることや、ユーザ名がユニークであることを保証したい場合などが考えられます。バリデーションルールを定義することで、フォームの扱いが非常に楽になります。

データバリデーションのプロセスには、いろいろと異なった側面があります。そのうちこのセクションで扱うのは、モデルに特化した部分です。基本的には、あなたのモデルで save() メソッドをコールした時に起こる内容です。 FormHelper には、バリデーションエラーの表示がどのように処理されるのかについての記載があります。

データバリデーションへの最初のステップは、まずモデルの中にバリデーションルールを作成することです。そのためには、モデル定義の中で Model::validate 配列を使います。たとえば以下のようになります。 :

class User extends AppModel {
    public $validate = array();
}

この例では User モデルに対して $validate 配列を追加していますが、その配列には（まだ）バリデーションルールが書かれていません。ここで、users テーブルには login, password, email, born という項目があるとしましょう。これらの項目に対して適用されるいくつかのシンプルなバリデーションルールを以下の例で示します。 :

class User extends AppModel {
    public $validate = array(
        'login' => 'alphaNumeric',
        'email' => 'email',
        'born'  => 'date'
    );
}

この例では、モデルの項目に対してバリデーションルールを追加する方法を示しています。login 項目については文字と数字のみが、email と born はそれぞれ書式に合致したメールアドレスと日付が入力できます。バリデーションルールの定義があると、入力されたデータが定義されたルールに合致しない場合、 CakePHP がフォームの中で自動的にエラーメッセージを表示してくれます。

CakePHP には多くのバリデーションルールが用意されており、非常に簡単に利用できます。ビルトインルールのいくつかを使って電子メールや URL、クレジットカード番号等の書式をチェックできますが、まずこれらについて説明します。

これらビルトインされたバリデーションルールの利点を活用した、より複雑な例を以下に示します。 :

class User extends AppModel {
    public $validate = array(
        'login' => array(
            'alphaNumeric' => array(
                'rule' => 'alphaNumeric',
                'required' => true,
                'message' => '文字と数字のみです'
            ),
            'between' => array(
                'rule' => array('lengthBetween', 5, 15),
                'message' => '5～15文字です'
            )
        ),
        'password' => array(
            'rule' => array('minLength', '8'),
            'message' => '最低8文字です'
        ),
        'email' => 'email',
        'born' => array(
            'rule' => 'date',
            'message' => '正しい値を入れてください',
            'allowEmpty' => true
        )
    );
}

ユーザ名(login)に対して２つのバリデーションルールが定義されています。文字または数字のみで構成されること、および長さが 5 から 8 までということの２つです。パスワード(password)項目は 8 文字以上である必要があります。メールアドレス(email)は正しいメールアドレスで、また誕生日(born)は正しい日付でなければなりません。さらに、これらのバリデーションルールに引っかかった時に CakePHP が使うエラーメッセージを自由に定義できます。

この例でもわかるように、ひとつのフィールドに複数のバリデーションルールを持つことができます。また、ビルトインルールがあなたの基準に合わなければ、いつでも必要に応じて独自のバリデーションルールを追加できます。

ここまで、データバリデーションがどう動くのかの全体像を見てきました。次はこれらのルールをモデルの中でどう定義すればよいのかを見てみましょう。バリデーションルールを定義するには３つの方法があります：単純配列、項目単位の単一ルール、項目単位の複数ルールです。

単純なルール

名前の通り、これがバリデーションルールを定義する最も簡単な方法です。この方法で定義する場合の、一般的な書式は以下の通りです。 :

public $validate = array('fieldName' => 'ruleName');

ここで 'fieldName' はルールを定義する対象の項目名です。 'ruleName' は事前に定義されたルール名で、 'alphaNumeric', 'email', 'isUnique' といったものがあります。

たとえば、ユーザーが入力したメールアドレスが書式に合っているかどうかをチェックするために、以下のようにルールを使えます。 :

public $validate = array('user_email' => 'email');

項目単位の単一ルール

この定義テクニックを使うと、バリデーションルールの動きをより良くコントロールできます。しかしその前に、単一項目に対してルールを追加する際の一般的に利用パターンを見てみましょう。 :

public $validate = array(
    'fieldName1' => array(
        // or: array('ruleName', 'param1', 'param2' ...)
        'rule'       => 'ruleName',
        'required'   => true,
        'allowEmpty' => false,
        // or: 'update'
        'on'         => 'create',
        'message'    => 'エラーメッセージ'
    )
);

'rule' キーは必須です。　'required' => true だけをセットしても、そのフォームバリデーションは正しく機能しません。このため、 'required' は厳密にはルールではありません。

これでわかるように、各項目（直前の例では項目は一つだけですが）は 'rule', 'required', 'allowEmpty', 'on', 'message' という５つのキーを持つ配列に関連付けられます。これらのキーについてもう少し詳しく見てみましょう。

rule

'rule' キーはバリデーションの方法を定義します。引数には単一の値または配列を渡します。引数として指定できる値はあなたのモデルのメソッド名、組み込みで用意されているバリデーションクラスのメソッド名、もしくは正規表現のいずれかです。デフォルトで利用可能な rule の詳細は Core Validation Rules を参照してください。

rule がパラメータを必要としない場合、'rule' に次のような単一の値を指定できます。 :

public $validate = array(
    'login' => array(
        'rule' => 'alphaNumeric'
    )
);

（max, min, range のように）rule がパラメータを取る場合、 'rule' を配列で指定します。 :

public $validate = array(
    'password' => array(
        'rule' => array('minLength', 8)
    )
);

配列ベースのルール定義には 'rule' キーが必要ですので覚えておいてください。

required

このキーにはブール値か、または create, update を指定できます。 true にすると、その項目は必須項目になります。一方 create または update にすると、その項目は更新または作成処理の場合にのみ必須となります。 'required' が真と評価されると、その項目はデータ配列の中に存在しなければならなくなります。たとえばバリデーションルールが以下のように定義されたとすると、 :

public $validate = array(
    'login' => array(
        'rule'     => 'alphaNumeric',
        'required' => true
    )
);

モデルの save() メソッドに送られるデータにはログイン項目が含まれていなければなりません。そうでなければバリデーションは失敗します。このキーのデフォルト値はブールの「偽」です。

required => true はバリデーションルールの notBlank() と同じではありません。 required => true は配列の「キー」が含まれていなければならないという意味であり、それが値を持たなければならないということではありません。このため、データセット中にこの項目がない場合バリデーションは失敗しますが、送信された値が空 ('') の場合は成功することもあります（ルール定義によります）

Changed in version 2.1

create と update のサポートが追加されました。

allowEmpty

false にすると、その項目の値は『nonempty』でなければなりません。ここで "nonempty" は !empty($value) || is_numeric($value) と定義されます。数値のチェックがあるため $value がゼロでも CakePHP は正しく動作します。

required と allowEmpty の違いは少し紛らわしいです。 'required' => true の場合、 $this->data の中にその項目の『キー』がないと、モデルの保存はできません（チェックは isset で行われます）。一方 'allowEmpty' => false にした場合、前述のように現在の項目の『値が』 nonempty であること、となります。

on

'on' キーには 'update' または 'create' のいずれかをセットします。これにより、新しいレコードの生成時、またはレコードの更新時に特定のルールが適用されます。

'on' => 'create' でルールが定義されていると、そのルールは新しいレコードを生成する場合に限って適用されます。同様に、 'on' => 'update' で定義されている場合はレコードの更新時にのみ適用されます。

'on' のデフォルト値は null です。'on' が null の場合、そのルールは生成と更新双方のケースで適用されます。

message

message キーを使うと、そのルールについてのカスタムバリデーションエラーメッセージを定義できます。 :

public $validate = array(
    'password' => array(
        'rule' => array('minLength', 8),
        'message' => 'パスワードは８文字以上必要です。'
    )
);

NOTE

ルールにかかわらず、message が定義されない場合のバリデーション失敗時のメッセージは "This field cannot be left blank." です。

１項目に複数のルール

これまでの説明では、単純なルール設定に比べればより柔軟な書き方を学んできましたが、さらにきめ細かいデータバリデーション制御の方法があります。次のテクニックを使うと、１つのモデル項目に対して複数のバリデーションルールを割り当てることができます。

１つの項目に対して複数のバリデーションルールを割り当てたい場合、その基本的な書き方は以下のようになります。 :

public $validate = array(
    'fieldName' => array(
        'ruleName' => array(
            'rule' => 'ruleName',
            // ここに on や required などその他のキーを書く
        ),
        'ruleName2' => array(
            'rule' => 'ruleName2',
            // ここに on や required などその他のキーを書く
        )
    )
);

これでわかるように、この書き方はこれまでのセクションで出てきたものととてもよく似ています。それぞれの項目にはバリデーションパラメータの配列が一つだけ書かれています。このケースでは、 'fieldName' はルールのインデックスの配列から構成されます。それぞれの 'ruleName' にはバリデーションパラメータの別々の配列を保持しています。

もう少し実践的な例を見てみましょう。 :

public $validate = array(
    'login' => array(
        'loginRule-1' => array(
            'rule' => 'alphaNumeric',
            'message' => 'アルファベットまたは数字のみです',
         ),
        'loginRule-2' => array(
            'rule' => array('minLength', 8),
            'message' => '最低８文字です'
        )
    )
);

この例では login 項目に対して loginRule-1 と loginRule-2 という２つのルールを定義しています。見ての通り、各ルールは任意の名前で区別されています。

項目単位の複数ルールを使っている場合、'required' と 'allowEmpty' キーは先頭のルールに一度だけ現れるようにしなければなりません。

last

項目単位の複数ルールでは、デフォルトでは特定のルールに引っかかるとそのルールのエラーメッセージが返され、その項目についてそれ以降のルールは処理されません。もしあるルールが失敗してもそれ以降のバリデーションを継続したい場合は、そのルールで last キーを false にします。

以下の例では "rule1" のチェックに引っかかっても "rule2" が引き続き実行され、さらに "rule2" にも引っかかった場合は両方のエラーメッセージが返されます。 :

public $validate = array(
    'login' => array(
        'rule1' => array(
            'rule' => 'alphaNumeric',
            'message' => 'アルファベットと数字だけを使えます',
            'last'    => false
         ),
        'rule2' => array(
            'rule' => array('minLength', 8),
            'message' => '８文字以上です'
        )
    )
);

この配列形式でバリデーションルールを指定する場合、 message キーは省略できます。以下の例を見てください。 :

public $validate = array(
    'login' => array(
        'アルファベットと数字だけです' => array(
            'rule' => 'alphaNumeric',
         ),
    )
);

alphaNumeric ルールに引っかかった場合、 message キーが指定されていないので、'アルファベットと数字だけです' がエラーメッセージとして返されます。

カスタムバリデーションルール

ここまで読んでもなお希望するような仕組みを見つけきれない方については、いつでもプログラマ独自のバリデーションルールを作成できます。これには２つの方法があります。カスタム正規表現を使う方法と、カスタムバリデーションメソッドを定義する方法です。

カスタム正規表現によるバリデーション

自分が必要とするバリデーションテクニックを正規表現マッチングを使って実現できるのであれば、ある項目のバリデーションルールとしてカスタム正規表現を定義できます。 :

public $validate = array(
    'login' => array(
        'rule' => '/^[a-z0-9]{3,}$/i',
        'message' => '文字と数字のみ、３文字以上'
    )
);

上記の例では login が文字と数字のみで構成され、最低３文字あるかどうかをチェックしています。

rule で指定する正規表現は、スラッシュで囲まなければなりません。末尾のスラッシュの後に 'i' を付けると、その正規表現は case insensitive（大文字と小文字を区別しないこをと）を表します。

独自のバリデーションメソッドを追加する

データをチェックするのに、正規表現パターンだけでは機能が足りない場合があります。たとえばプロモーションコードが使われた回数が 25 回を超えていないことをチェックしたい場合、以下の様な独自のバリデーション関数を追加する必要があります。 :

class User extends AppModel {

    public $validate = array(
        'promotion_code' => array(
            'rule' => array('limitDuplicates', 25),
            'message' => '利用回数の制限を超えました。'
        )
    );

    public function limitDuplicates($check, $limit) {
        // $check には array('promotion_code' => '入力値') が入る
        // $limit には 25 が入っている
        $existingPromoCount = $this->find('count', array(
            'conditions' => $check,
            'recursive' => -1
        ));
        return $existingPromoCount < $limit;
    }
}

チェック対象の現在の項目が、項目名をキー、ポストされたデータを値とする連想配列として構成され、この関数の第一パラメータとして渡されます。

作成したバリデーション用の関数に追加のパラメータを渡したい場合は、要素を 'rule' 配列に入れ、関数内でそれらを（主となる $check パラメータの後の）追加パラメータとして処理します。

作成したバリデーション関数は（上記の例のように）モデルの中に書くか、またはモデルを実装するビヘイビアとして書きます。これにはマップされたメソッドも含まれます。

モデルやビヘイビアメソッドは、 Validation クラスの中のメソッドを検索する前の段階で、最初にチェックされます。つまり、（ alphaNumeric() のような）既存のメソッドを、アプリケーションのレベル（ AppModel にメソッドを追加する）やモデルのレベルでオーバーライドできるということです。

複数項目で利用可能なバリデーションルールを作成する場合、$check 配列から項目の値を取り出す際には注意が必要です。$check 配列はフォームの項目名をキー、項目値を値として渡されます。チェック対象のレコードの全体は $this->data メンバ変数に入っています。 :

class Post extends AppModel {

    public $validate = array(
        'slug' => array(
            'rule' => 'alphaNumericDashUnderscore',
            'message' => 'これには文字、数字、ハイフン、' .
                'アンダースコアが使えます'
        )
    );

    public function alphaNumericDashUnderscore($check) {
        // $data 配列はフォームの項目名をキーとして渡される。
        // この関数が汎用的に使えるように、値を展開する必要がある。
        $value = array_values($check);
        $value = $value[0];

        return preg_match('|^[0-9a-zA-Z_-]*$|', $value);
    }
}

NOTE

独自のバリデーションメソッドは、スコープが public でなければなりません。 protected や private なバリデーションメソッドはサポートされていません。

入力値が有効の場合、メソッドは true を返さなければなりません。無効の場合は false を返します。これら以外の返り値が文字列であれば、それはエラーメッセージとして表示されます。文字列を返すということは、チェックでエラーになったことを表します。その文字列は $validate 配列に設定された message を上書きし、その項目がエラーになった理由としてビューのフォームに表示されます。

バリデーションルールを動的に変更する

$validate プロパティを使ってバリデーションルールを定義するのは、それぞれのモデルについて静的にルールを定義するにはよい方法です。しかしながら、事前に定義された設定に対して動的にバリデーションルールを追加／変更／削除したいケースがあります。

バリデーションルールはすべて ModelValidator オブジェクトに格納されますが、ここにはあなたのモデルにおけるそれぞれの項目のルールセットが保持されます。新しいバリデーションルールを定義するのは、このオブジェクトに対して希望する項目の新しいバリデーションメソッドを格納したいことを伝えるのと同じくらい簡単です。

新しいバリデーションルールの追加

Added in version 2.2

ModelValidator オブジェクトが内部設定に新しい項目を追加するためにはいくつかのやり方があります。最初は add メソッドを使う方法です。 :

// Inside a model class
$this->validator()->add('password', 'required', array(
    'rule' => 'notBlank',
    'required' => 'create'
));

これはモデルの password 項目に対して単一のルールを追加します。 add に対してさらに他の add への呼び出しを、好きなだけ繋げられます。 :

// Inside a model class
$this->validator()
    ->add('password', 'required', array(
        'rule' => 'notBlank',
        'required' => 'create'
    ))
    ->add('password', 'size', array(
        'rule' => array('lengthBetween', 8, 20),
        'message' => 'パスワードは最低8文字です。'
    ));

一つの項目に対して一度に複数のルールを追加することもできます。 :

$this->validator()->add('password', array(
    'required' => array(
        'rule' => 'notBlank',
        'required' => 'create'
    ),
    'size' => array(
        'rule' => array('lengthBetween', 8, 20),
        'message' => 'パスワードは最低8文字です。'
    )
));

また、validator オブジェクトに対して配列形式のインターフェースを使って直接ルールを設定することもできます。 :

$validator = $this->validator();
$validator['username'] = array(
    'unique' => array(
        'rule' => 'isUnique',
        'required' => 'create'
    ),
    'alphanumeric' => array(
        'rule' => 'alphanumeric'
    )
);

現在のバリデーションルールを変更する

Added in version 2.2

validator オブジェクトを使って現在のバリデーションルールを変更することもできます。現在のルールを変更する場合、項目にメソッドを追加したり、またその項目からルールセットを完全に取り去ってしまうなど、いくつかの方法があります。 :

// モデルクラスの中で
$this->validator()->getField('password')->setRule('required', array(
    'rule' => 'required',
    'required' => true
));

これと似たようなやり方で、その項目におけるルールをすべて完全に差し替えてしまうこともできます。 :

// モデルクラスの中で
$this->validator()->getField('password')->setRules(array(
    'required' => array(...),
    'otherRule' => array(...)
));

ルールの中の一つのプロパティだけを変更したい場合は、 CakeValidationRule オブジェクトの中に入って直接プロパティをセットすることもできます。 :

// モデルクラスの中で
$this->validator()->getField('password')
    ->getRule('required')->message = 'この項目は必須入力です';

CakeValidationRule におけるどのプロパティも、たとえば 'message' や 'allowEmpty' といった配列キーのように、バリデーションルールのプロパティを定義する際に使える自分自身の名前を配列キーから取得します。

ルールセットに新しいルールを追加する場合、配列インターフェースを使って既存のルールを変更することも可能です。 :

$validator = $this->validator();
$validator['username']['unique'] = array(
    'rule' => 'isUnique',
    'required' => 'create'
);

$validator['username']['unique']->last = true;
$validator['username']['unique']->message = 'その名前はすでに使われています';

ルールセットからルールを削除する

Added in version 2.2

ある項目のルールセットにおいて、ルールすべてを削除することも一つのルールを削除することも、どちらも可能です。 :

// ある項目からすべてのルールを完全に削除する
$this->validator()->remove('username');

// password から 'required' ルールを削除する
$this->validator()->remove('password', 'required');

配列インターフェースを使って削除することもできます。 :

$validator = $this->validator();
// ある項目のすべてのルールを完全に削除する
unset($validator['username']);

// password から 'required' ルールを削除する
unset($validator['password']['required']);

コア・バリデーションルール

class Validation

CakePHP のバリデーションクラスには多くのバリデーションルールがあり、モデルデータのバリデーションをより簡単にしています。このクラスにはよく使われるバリデーションテクニックが組み込まれており、プログラマが独自のルールを書かなくても済むようになっています。以下にすべてのルールの一覧を、その使用例とともに示します。

static Validation::alphaNumeric(mixed $check)

この項目は文字と数字だけで構成されなければなりません。 :

public $validate = array(
    'login' => array(
        'rule' => 'alphaNumeric',
        'message' => 'ユーザ名には文字と数字だけしか使えません。'
    )
);

static Validation::lengthBetween(string $check, integer $min, integer $max)

この項目のデータ長は指定された数値の範囲に収まっていなければなりません。最小値と最大値の両方を指定する必要があります。 :

public $validate = array(
    'password' => array(
        'rule' => array('lengthBetween', 5, 15),
        'message' => 'パスワードは5～15文字でなければなりません。'
    )
);

データは文字数でチェックされます。バイト数ではありません。もし、UTF-8 互換の代わりに、純粋な ASCII 入力に対して検証したい場合、カスタムバリデータを書く必要があります。

static Validation::blank(mixed $check)

このルールはその項目が未入力のまま、もしくはその値がホワイトスペースだけで構成されていることを確認するときに使います。ホワイトスペース文字として有効なのは空白、タブ、復帰（キャリッジリターン）、改行（ニューライン）です。 :

public $validate = array(
    'id' => array(
        'rule' => 'blank',
        'on'   => 'create'
    )
);

static Validation::boolean(string $check)

その項目のデータはブール値でなければなりません。有効な値は true, false, 数字の 0 または 1、文字列の '0' または '1' です。 :

public $validate = array(
    'myCheckbox' => array(
        'rule' => array('boolean'),
        'message' => 'myCheckbox の値が誤っています'
    )
);

static Validation::cc(mixed $check, mixed $type = 'fast', boolean $deep = false, string $regex = null)

このルールはそのデータが有効なクレジットカード番号かどうかをチェックします。これにはパラメータとして 'type', 'deep', 'regex' の３つが必要です。

'type' キーには 'fast', 'all' または以下のいずれかを指定します:

amex
bankcard
diners
disc
electron
enroute
jcb
maestro
mc
solo
switch
visa
voyager

'type' が 'fast' の場合、そのデータがメジャーなクレジットカードの番号のフォーマットになっているかチェックします。'type' を 'all' にすると、すべてのクレジットカードタイプをチェックします。また、マッチさせたいタイプだけを配列で指定することもできます。

'deep' キーにはブール値を指定します。true が指定されると、そのクレジットカードの Luhn アルゴリズムをチェックします (https://en.wikipedia.org/wiki/Luhn_algorithm). デフォルトは false です。

'regex' キーにはクレジットカード番号の妥当性チェックで使うための独自の正規表現を指定できます。 :

public $validate = array(
    'ccnumber' => array(
        'rule' => array('cc', array('visa', 'maestro'), false, null),
        'message' => 'クレジットカード番号が正しくありません。'
    )
);

static Validation::comparison(mixed $check1, string $operator = null, integer $check2 = null)

comparison は数値を比較します。サポートしている機能は『より大きい』『より小さい』『以上』『以下』『等しい』『等しくない』です。以下にいくつか例を示します。 :

public $validate = array(
    'age' => array(
        'rule' => array('comparison', '>=', 18),
        'message' => '条件は１８歳以上です。'
    )
);

public $validate = array(
    'age' => array(
        'rule' => array('comparison', 'greater or equal', 18),
        'message' => '条件は１８歳以上です。'
    )
);

static Validation::custom(mixed $check, string $regex = null)

カスタム正規表現が必要な場合に使われます。 :

public $validate = array(
    'infinite' => array(
        'rule' => array('custom', '\u221E'),
        'message' => '∞ を入力してください'
    )
);

static Validation::date(string $check, mixed $format = 'ymd', string $regex = null)

このルールは、データが有効な日付のフォーマットで入力されたかどうかを検証します。単一のパラメータ（配列でもよい）を渡すと、それを元に入力された日付のフォーマットをチェックします。パラメータのに値は以下のいずれかを指定します:

'dmy' たとえば 27-12-2006 または 27-12-06 （区切り文字には空白、ピリオド、ハイフン、スラッシュが使えます）
'mdy' たとえば 12-27-2006 または 12-27-06 （区切り文字には空白、ピリオド、ハイフン、スラッシュが使えます）
'ymd' たとえば 2006-12-27 または 06-12-27 （区切り文字には空白、ピリオド、ハイフン、スラッシュが使えます）
'dMy' たとえば 27 December 2006 または 27 Dec 2006
'Mdy' たとえば December 27, 2006 または Dec 27, 2006 （カンマはオプション）
'My' たとえば December 2006 または Dec 2006
'my' たとえば 12/2006 または 12/06 （区切り文字には空白、ピリオド、ハイフン、スラッシュが使えます）
'ym' たとえば 2006/12 または 06/12 （区切り文字には空白、ピリオド、ハイフン、スラッシュが使えます）
'y' たとえば 2006 （区切り文字には空白、ピリオド、ハイフン、スラッシュが使えます）

キーが指定されない場合、'ymd' がデフォルトのキーとして使われます。 :

public $validate = array(
    'born' => array(
        'rule'       => array('date', 'ymd'),
        'message'    => '有効な日付を YY-MM-DD フォーマットで入力してください。',
        'allowEmpty' => true
    )
);

大量のデータが特定の日付フォーマットを要求している場合は、様々な日付フォーマットを受け取ってから、それらを変換するという力仕事を考えてみてもよいでしょう。利用者のために一度がんばれば、後が楽になります。

Changed in version 2.4

ym および y フォーマットが追加されました。

static Validation::datetime(array $check, mixed $dateFormat = 'ymd', string $regex = null)

このルールはデータが有効な日時のフォーマットに合致していることを保証します。日付のフォーマットを指定するためのパラメータ（配列でもよい）が渡されます。パラメータの値は以下のいずれかです:

'dmy' たとえば 27-12-2006 または 27-12-06 （区切り文字には空白、ピリオド、ハイフン、スラッシュが使えます）
'mdy' たとえば 12-27-2006 またはr 12-27-06 （区切り文字には空白、ピリオド、ハイフン、スラッシュが使えます）
'ymd' たとえば 2006-12-27 または 06-12-27 （区切り文字には空白、ピリオド、ハイフン、スラッシュが使えます）
'dMy' たとえば 27 December 2006 または 27 Dec 2006
'Mdy' たとえば December 27, 2006 または Dec 27, 2006 （カンマはオプションです）
'My' たとえば December 2006 または Dec 2006
'my' たとえば 12/2006 or 12/06 （区切り文字には空白、ピリオド、ハイフン、スラッシュが使えます）

キーが指定されない場合、'ymd' がデフォルトのキーとして使われます。 :

public $validate = array(
    'birthday' => array(
        'rule' => array('datetime', 'dmy'),
        'message'    => '有効な日時を入力してください。',
    )
);

２番めのパラメータには正規表現を指定します。このパラメータが指定されると、そのパターンのみが有効となります。

date() と異なり、datetime() は日時を検証します。

static Validation::decimal(string $check, integer $places = null, string $regex = null)

このルールは、データが有効な数値であることを保証します。パラメータとして小数部の桁数を指定します。パラメータが渡された場合、そのデータは浮動小数点形式として検証されるため、小数点の後ろに数字がない場合は正当な数値としてはみなされません。 :

public $validate = array(
    'price' => array(
        'rule' => array('decimal', 2)
    )
);

static Validation::email(string $check, boolean $deep = false, string $regex = null)

データが正しいメールアドレスかどうかをチェックします。オプションの第二パラメータとして true を渡すと、ホスト部が有効なアドレスかどうかも合わせてチェックします。 :

public $validate = array('email' => array('rule' => 'email'));

public $validate = array(
    'email' => array(
        'rule' => array('email', true),
        'message' => '有効なメールアドレスを入力してください。'
    )
);

static Validation::equalTo(mixed $check, mixed $compareTo)

入力値がパラメータで与えられた値と同じ型で、かつ同じ値であるかどうかをチェックします。 :

public $validate = array(
    'food' => array(
        'rule' => array('equalTo', 'cake'),
        'message' => 'この値は文字列 cake でなければなりません。'
    )
);

static Validation::extension(mixed $check, array $extensions = array('gif', 'jpeg', 'png', 'jpg'))

.jpg や .png といった有効なファイル拡張子かどうかをチェックします。複数の拡張子を配列として渡すこともできます。

public $validate = array(
    'image' => array(
        'rule' => array(
            'extension',
            array('gif', 'jpeg', 'png', 'jpg')
        ),
        'message' => '有効な画像ファイルを指定してください。'
    )
);

static Validation::fileSize($check, $operator = null, $size = null)

ファイルサイズのチェックを行います。使用したい比較のタイプを $operator （演算子）として指定できます。ここでは ~Validation::comparison() がサポートしている演算子をすべてサポートしています。 $check が tmp_name キーを含んでいる場合、このメソッドは $_FILES から渡される値を自動的に解析し、tmp_name キーがあれば取り出します。 :

public $validate = array(
    'image' => array(
        'rule' => array('fileSize', '<=', '1MB'),
        'message' => '画像は 1MB 未満でなければなりません。'
    )
);

Added in version 2.3

このメソッドは 2.3 で追加されました。

static Validation::inList(string $check, array $list, boolean $caseInsensitive = false)

このルールは、値が与えられた候補セットに含まれることを保証します。パラメータとして値の配列を指定する必要があります。項目値が与えられた配列の値のいずれかにマッチする場合、その項目は有効であるとみなされます。

使用例:

public $validate = array(
    'function' => array(
         'allowedChoice' => array(
             'rule' => array('inList', array('Foo', 'Bar')),
             'message' => 'Foo または Bar を入力してください。'
         )
     )
 );

デフォルトでは比較の際に大文字と小文字を区別します。 $caseInsensitive を true で指定すると大文字と小文字を区別せずに比較します。

static Validation::ip(string $check, string $type = 'both')

このルールは有効な IPv4 もしくは IPv6 アドレスが入力されたことを保証します。オプションとして 'both'（デフォルト）、'IPv4'、'IPv6' を指定可能です。

public $validate = array(
    'clientip' => array(
        'rule' => array('ip', 'IPv4'), // or 'IPv6' or 'both' (default)
        'message' => '有効なIPアドレスを入力してください。'
    )
);

method Validation::Model::isUnique()()

static Validation::luhn(string|array $check, boolean $deep = false)

luhn アルゴリズム：さまざまな一意の番号を検証するためのチェックサム算出式。詳細は https://en.wikipedia.org/wiki/Luhn_algorithm を参照してください。

static Validation::maxLength(string $check, integer $max)

このルールはデータが最大長に収まっているかどうかを検証します。 :

public $validate = array(
    'login' => array(
        'rule' => array('maxLength', 15),
        'message' => 'ユーザ名は15文字までです。'
    )
);

これは 'login' フィールドが15文字以内になることを保証します。 15バイトではありません。

static Validation::maxLengthBytes(string $check, integer $max)

このルールはデータが最大長に収まっているかどうかを検証します。 :

public $validate = array(
    'data' => array(
        'rule' => array('maxLengthBytes', 2 ** 24 - 1),
        'message' => 'データは 16 MB より大きくできません。'
    )
);

これは 'data' フィールドが 16777215 バイト以内になることを保証します。

static Validation::mimeType(mixed $check, array|string $mimeTypes)

Added in version 2.2

有効な mime 型かどうかをチェックします。比較の際は大文字小文字を区別します。

Changed in version 2.5

2.5 から $mimeTypes に正規表現が書けるようになりました。

public $validate = array(
    'image' => array(
        'rule' => array('mimeType', array('image/gif')),
        'message' => 'mime 型が不正です。'
    ),
    'logo' => array(
        'rule' => array('mimeType', '#image/.+#'),
        'message' => 'mime 型が不正です。'
    ),
);

static Validation::minLength(string $check, integer $min)

このルールはデータが最小長を満たしているかどうかを検証します。 :

public $validate = array(
    'login' => array(
        'rule' => array('minLength', 8),
        'message' => 'ユーザー名は最低8文字以上にしてください。'
    )
);

ここでいうところの長さとは文字数のことです。バイト数ではありません。もし、UTF-8 互換の代わりに、純粋な ASCII 入力に対して検証したい場合、カスタムバリデータを書く必要があります。

static Validation::minLengthBytes(string $check, integer $min)

このルールはデータが最小長を満たしているかどうかを検証します。 :

public $validate = array(
    'login' => array(
        'rule' => array('minLengthBytes', 2 ** 16 - 1),
        'message' => 'Data can not be smaller than 64KB.'
    )
);

ここでの長さはバイト数です。

static Validation::money(string $check, string $symbolPosition = 'left')

このルールはその値が適切な金額表現になっているかどうかをチェックします。

第二パラメータは通貨シンボルが左右(left/right)どちらに付くかを指定します。

public $validate = array(
    'salary' => array(
        'rule' => array('money', 'left'),
        'message' => '適切な金額を入力してください。'
    )
);

static Validation::multiple(mixed $check, mixed $options = array(), boolean $caseInsensitive = false)

複数の select 入力を検査するのに使います。"in", "max", "min" パラメータをサポートしています。 :

public $validate = array(
    'multiple' => array(
        'rule' => array('multiple', array(
            'in'  => array('do', 're', 'mi', 'fa', 'sol', 'la', 'ti'),
            'min' => 1,
            'max' => 3
        )),
        'message' => '１個から３個までのオプションを選んでください'
    )
);

比較の際はデフォルトで大文字小文字を区別します。区別したくない場合は $caseInsensitive に true を指定してください。

static Validation::notEmpty(mixed $check)

Deprecated in version 2.7

代わりに notBlank を使用してください。

static Validation::notBlank(mixed $check)

Added in version 2.7

その項目が空でないことをチェックする、基本的なルールです。 :

public $validate = array(
    'title' => array(
        'rule' => 'notBlank',
        'message' => 'この項目は必須入力です。'
    )
);

これを複数 select 入力で使うとエラーになります。その場合は "multiple" を使ってください。

static Validation::numeric(string $check)

データが有効な数値かどうかをチェックします。 :

public $validate = array(
    'cars' => array(
        'rule' => 'numeric',
        'message' => '車の台数を入力してください。'
    )
);

static Validation::naturalNumber(mixed $check, boolean $allowZero = false)

Added in version 2.2

これは自然数かどうかをチェックするルールです。 $allowZero を true にすると 0 も入力可能となります。

public $validate = array(
    'wheels' => array(
        'rule' => 'naturalNumber',
        'message' => '車輪の数を入力してください。'
    ),
    'airbags' => array(
        'rule' => array('naturalNumber', true),
        'message' => 'エアバッグ数を入力してください。'
    ),
);

static Validation::phone(mixed $check, string $regex = null, string $country = 'all')

US の電話番号かどうかをチェックします。第二引数として正規表現を指定可能とすることで、US 以外の電話番号のフォーマットをカバーしています。

public $validate = array(
    'phone' => array(
        'rule' => array('phone', null, 'us')
    )
);

static Validation::postal(mixed $check, string $regex = null, string $country = 'us')

アメリカ(us)、カナダ(ca)、U.K(uk)、イタリア(it)、ドイツ(de)、ベルギー(be) の郵便番号の検査を行います。第二引数として正規表現を指定することで、これら以外の郵便番号もサポートしています。

public $validate = array(
    'zipcode' => array(
        'rule' => array('postal', null, 'us')
    )
);

static Validation::range(string $check, integer $lower = null, integer $upper = null)

値が与えられた範囲内にあるかどうかを検査します。範囲を指定しない場合、このルールは現在のプラットフォームにおいて正当な有限の値であることをチェックします。 :

public $validate = array(
    'number' => array(
        'rule' => array('range', -1, 11),
        'message' => '0 から 10 までの数字を入力してください。'
    )
);

上記の例では 0 より大きく（たとえば 0.01）10 より小さい（たとえば 9.99）値を受け付けます。 .. note:

上限と下限が重なってはなりません。

static Validation::ssn(mixed $check, string $regex = null, string $country = null)

アメリカ(us)、デンマーク(dk)、オランダ(nl)の社会保障番号を検査します。第二引数に正規表現を指定することで、これら以外の社会保障番号フォーマットにも対応できます。

public $validate = array(
    'ssn' => array(
        'rule' => array('ssn', null, 'us')
    )
);

static Validation::time(string $check)

渡された文字列が妥当な時刻かどうかを検証します。時刻は 24時間形式 (HH:MM) または am/pm ([H]H:MM[a|p]m) です。秒までは検査できません。

static Validation::uploadError(mixed $check)

Added in version 2.2

このルールはファイルアップロードがエラーになったかどうかをチェックします。

public $validate = array(
    'image' => array(
        'rule' => 'uploadError',
        'message' => 'ファイルアップロードで障害が起こりました。'
    ),
);

static Validation::url(string $check, boolean $strict = false)

有効な URL フォーマットかどうかをチェックします。プロトコルとして http(s), ftp(s), file, news, gopher をサポートしています。 :

public $validate = array(
    'website' => array(
        'rule' => 'url'
    )
);

プロトコルが URL に含まれるかどうかをチェックします。以下のように strict（厳密）モードを有効にすることもできます。 :

public $validate = array(
    'website' => array(
        'rule' => array('url', true)
    )
);

このバリデーションメソッドは複雑な正規表現を使っているため、 Windows + Apache2 + mod_php の組み合わせだと問題が起こることがあります。

static Validation::userDefined(mixed $check, object $object, string $method, array $args = null)

ユーザ定義のバリデーションを行います。

static Validation::uuid(string $check)

正当な UUID https://tools.ietf.org/html/rfc4122 かどうかを検査します。

ローカライズされたバリデーション

バリデーションルール phone() と postal() に渡された国別プリフィックスを、適切な名前で別のクラスに渡す方法がわからない場合があります。たとえばあなたがオランダに住んでいて、以下の様なクラスを作ったとします。 :

class NlValidation {
    public static function phone($check) {
        // ...
    }
    public static function postal($check) {
        // ...
    }
}

このファイルは APP/Validation/ や App/PluginName/Validation/ に置かれる可能性がありますが、利用する前に App::uses() 経由でインポートしておく必要があります。その後、あなたのモデルのバリデーションで、以下のように NlValidation を利用できます。 :

public $validate = array(
    'phone_no' => array('rule' => array('phone', null, 'nl')),
    'postal_code' => array('rule' => array('postal', null, 'nl')),
);

モデルのデータが検査される際、Validation は nl ロケールを処理できないので NlValidation::postal() に処理を委譲し、そのメソッドの返り値がババリデーションの結果（成功／失敗）として使われます。このアプローチに従って、ロケールのサブセットもしくはグループを扱うクラスを作ることで、大きな処理を書かずに済みます。個々のバリデーションメソッドの使い方は変えずに、別のバリデータを追加できるようになっています。

TIP

ローカライズされたプラグインでも、すでに多くのルールが利用できるようになっています: https://github.com/cakephp/localized さらに、あなたがローカライズしたバリデーションルールも、ぜひご提供ください。

Validating Data From The Controller

データバリデーション ​

単純なルール ​

項目単位の単一ルール ​

rule ​

required ​

allowEmpty ​

on ​

message ​

１項目に複数のルール ​

last ​

カスタムバリデーションルール ​

カスタム正規表現によるバリデーション ​

独自のバリデーションメソッドを追加する ​

バリデーションルールを動的に変更する ​

新しいバリデーションルールの追加 ​

現在のバリデーションルールを変更する ​

ルールセットからルールを削除する ​

コア・バリデーションルール ​

ローカライズされたバリデーション ​

データバリデーション

単純なルール

項目単位の単一ルール

rule

required

allowEmpty

on

message

１項目に複数のルール

last

カスタムバリデーションルール

カスタム正規表現によるバリデーション

独自のバリデーションメソッドを追加する

バリデーションルールを動的に変更する

新しいバリデーションルールの追加

現在のバリデーションルールを変更する

ルールセットからルールを削除する

コア・バリデーションルール

ローカライズされたバリデーション