CakePHPでは、バリデーション機能を使用したい画面のモデルに処理を書きます。

前回のお問い合わせフォーム画面であれば、以下のモデルになります。

../cake_pjt/src/Model/Table/FormsTable.php

前回bakeした際に自動的に作成されたモデルなので、既に「validationDefault」というメソッドが用意されています。

ここにバリデーション処理を画面に合わせて追加していきましょう。

バリデーションの基本的な書き方は以下の通りです。

　$validator->チェックルール名('カラム名');

これが基本の書き方になります。

バリデーションのルールには何があるのか知りたい場合は、以下のファイルに様々なルールが用意されているので確認してみてください。

../cake_pjt/vendor/cakephp/cakephp/src/Validation/Validator.php

それではお問い合わせフォームの項目に沿ってバリデーションを追加していきましょう。

・名前 ・・・ 入力必須かつ最大255文字
・都道府県 ・・・ 選択必須
・携帯番号 ・・・ ハイフンなしの数字のみOKかつ11桁以内
・メールアドレス ・・・ 入力必須かつ最大255文字が条件かつ正しいメールアドレス形式
・お問い合わせ内容 ・・・ 入力必須かつ最大255文字

今回チェックする内容は上記の通りです。


それぞれの条件に当てはまるバリデーションルールを設定していきます。

・空でなく文字列かをチェックする →　notEmptyString(‘カラム名’, ‘メッセージ’)
・最大文字数を設定する →　maxLength(‘カラム名’, 最大数, ‘メッセージ’)
・メールアドレスの形式をチェック →　email(‘カラム名’,ホスト名チェック, ‘メッセージ’)

モデルに記載していきましょう。

../cake_pjt/src/Model/Table/FormsTable.php

    /**
     * Default validation rules.
     *
     * @param \Cake\Validation\Validator $validator Validator instance.
     * @return \Cake\Validation\Validator
     */
    public function validationDefault(Validator $validator): Validator
    {
        $validator
            ->maxLength('name', 255, '255文字以内で入力してください')
            ->notEmptyString('name', '名前を入力してください');

        $validator
            ->notEmptyString('gender', '性別を選択してください');

        $validator
            ->notEmptyString('prefecture', '都道府県を選択してください');

        $validator
            ->maxLength('mobile', 11, '11文字以内で入力してください');

        $validator
            ->maxLength('mail', 255, '255文字以内で入力してください')
            ->notEmptyString('mail', 'メールアドレスを入力してください')
            ->email('mail', false, 'メールアドレスは正しい形式で入力してください');

        $validator
            ->maxLength('contents', 255, '255文字以内で入力してください')
            ->notEmptyString('contents', 'お問い合わせ内容を入力してください');

        return $validator;
    }

これで携帯番号の数値チェック以外は完了しました。

純粋な数字チェックはデフォルトのメソッドとして用意されていないようなので（見落としていたらすみません…）、独自ルールを作成します。

今回は正規表現を用いてチェックを行うのですが、数値のみというチェックは今後別の画面で使用したい場合があるかもしれないので、「Validation.php」に処理を書いておこうと思います。

../cake_pjt/vendor/cakephp/cakephp/src/Validation/Validation.php

    /**
     * 数値のみをチェック
     *
     * @param mixed