【Laravel】『alpha系』のバリデーションルールには注意が必要だよというお話

2021年5月5日2022年11月17日

URLをコピーしました！

Laravelではデフォルトで様々なバリデーションルールを準備してくれており、生PHPと比べてかなり簡単にバリデーションを設定することができます。

その中で、以下の3つのalpha系のルールには注意が必要というお話をします。

alpha系のバリデーションルール

alpha：全てアルファベット
alpha_dash：全部アルファベットと数字、ダッシュ(-)、下線(_)
alpha_num：全部アルファベットと数字

「そもそもバリデーションって何」って方は

こちらの記事でバリデーションについて解説しているので読んでみてください。

結論：全角文字を通してしまう

このalpha系のバリデーションルールの最大の落とし穴は全角文字を通してしまうことです。

例えば、ユーザー登録時のパスワードのバリデーションに『8文字以上の半角英数字』という条件をつけたいとします。

app/Http/Controllers/Auth/RegisterController.phpのvalidatorメソッドをこのように修正する方が多いのではないかと思います。

    protected function validator(array $data)
    {
        return Validator::make($data, [
            'name' => ['required', 'string', 'max:255'],
            'email' => ['required', 'string', 'email', 'max:255', 'unique:users'],
            // alpha_numを追加
            'password' => ['required', 'string', 'alpha_num', 'min:8', 'confirmed'],
        ]);
    }

実はこれだと、ダメなんですよね。

あああasyr552hdhbxiのようにあ（全角ひらがな）が入っている場合でもバリデーションをクリアしてユーザー登録が完了してしまいます。

同様に漢字、全角カタカナが入っている場合、全てそれらの場合でもバリデーションが通ってしまいます。

公式ドキュメントに『アルファベット文字』と書いているけど…。バグなのでしょうか？そもそもこういう仕様？

調べてみたのですが、解決に至らなかったのでalpha系のバリデーションルールは全角文字を通してしまうということを覚えておこうと思います。

正規表現を使ってバリデーションルールを設定しよう

Laravelで『8文字以上の半角英数字』というルールのバリデーションを実装する方法ですが、正規表現を使います。

デフォルトでregexというルールを準備してくれています。以下は公式ドキュメントでの説明。

regex:正規表現
フィールドが指定された正規表現にマッチすることをバリデートします。
このルールは内部でPHPのpreg_match関数を使用しています。パターンは有効なデリミタを使用していることも含め、preg_matchが求めているフォーマットにしたがって指定する必要があります。たとえば：'email' => 'regex:/^.+@.+$/i'
注目： regexとnot_regexパターンを使用する場合はルールをパイプ（縦棒）で区切らず、ルールの配列で指定する必要があります。とくに正規表現に縦棒を含んでいる場合に該当します。
https://readouble.com/laravel/6.x/ja/validation.html#rule-regex

このようにregex:の後に正規表現を書くことで入力値がそれにマッチしているかどうかをチェックしてくれます。

'email' => 'regex:/^.+@.+$/i'

というわけで『8文字以上の半角英数字』を表す正規表現を実装します。

    protected function validator(array $data)
    {
        return Validator::make($data, [
            'name' => ['required', 'string', 'max:255'],
            'email' => ['required', 'string', 'email', 'max:255', 'unique:users'],
            // 正規表現を追加（min:8も不要なので削除）
            'password' => ['required', 'string', 'regex:/\A([a-zA-Z0-9]{8,})+\z/u', 'confirmed'],
        ]);
    }

'regex:/\A([a-zA-Z0-9]{8,})+\z/u'で表現しています。（min:8が不要になるので削除しています）

正規表現についてはこちらの記事でチートシートとしてまとめられています。

murashun.jp