【Laravel5.4】sometimes validationの動作について

質問

Laravel5.4でsometimes validationをつける際に、以下の3つの場合で動作の違いがあるか確認したく、質問致しました。

email => 'sometimes|required|email'
email => 'sometimes|email'
email => 'email'

sometimes制約の認識としては、与えたinput配列にfield(今回だとemail)があったときだけvalidationが走るというものだと思っています。
しかし、公式ドキュメントを見ると、以下のように sometiems|requied|email というようにrequired制約もついています。requiredは入力にfieldがチェックするものなので、 sometimes がついていれば必要ないように感じます。
また、 sometimes制約もつけなくても(パターン3)場合も、入力に指定したfield(email)がなければvalidationは走らないと思います。

sometimes制約の正しい書き方と、各パターンに動作の違いがあればご教授頂きたいです。
よろしくお願いいたしますm(__)m

php
1$v = Validator::make($data, [
2    'email' => 'sometimes|required|email',
3]);

補足

実際に以下のメソッドをEloquentに追加して php artisan tinker で、以下の2つを試してみましたが各パターンのValidation結果に違いはありませんでした。

入力にfieldがある場合の3パターン
入力にfieldがない場合の3パターン

php
1  public function validation_test() {
2      $inputs =  [
3          'id' => 1,
4        ];
5
6      $rules = [
7          'email' => 'sometimes|required|email',
8        ];
9
10      $validator = \Validator::make($inputs, $rules);
11
12      if ($validator->fails()) {
13          return $validator->errors()->all();
14      } elseif ($validator->passes()) {
15          return $this->create($inputs);
16      }
17
18  }

行動規範の内容に同意します

回答2件

確かに、sometimesについては、配列に値が無い場合にvalidateの対象外とします。
一方、emailについては、空文字ではエラーにはなりません。
よって、下記のケースはエラーとはなりません

PHP
1$inputs =  [
2     'id' => 1,
3     'email' => ''
4];
5$rules = [
6     'email' => 'sometimes|email',
7];

emailフィールドがあったときに入力必須にしたい場合には、'sometimes|required|email'が必要となるのです。

ただ、email => 'sometimes|email'とemail => 'email'については、結果的に同じ動作をすると思います。この様な単純なケースにおいてはsometimesを使うメリットはあまりないと理解しています。

投稿2017/06/28 03:31

編集2017/06/28 03:44

motuo

総合スコア3027

uramot

2017/06/28 04:32 編集

ご回答ありがとうございます！ email制約だと、空文字だとvalidation通ってしまうので`sometimes|required`とする必要があるんですね。required制約の動作で勘違いしていた部分があったみたいです。ありがとうございます！また、 `email => sometimes|email` と `email => email` は同じ動作になるのですね。`sometimes` は基本的に `required` とセットで使うという認識で良いですかね。

行動規範の内容に同意します

ベストアンサー

何が正しいかはどういう動作を期待するかによるのでなんともいえませんが、sometimesはパラメタが存在するときのみチェックをするという指定で、パラメタがなければたとえrequiredが指定されていてもOKになります(requiredより優先します)。

emailパラメタがそもそも存在しない場合、nullの場合、空文字列の場合、正しい場合でそれぞれの条件での結果を表示するプログラムと実行結果を示しますので参考にしてください。

php
1    public static function validation_test() {
2        $inputs = [
3            'missing' => [],
4            'null'    => ['email' => null],
5            'empty'   => ['email' => ''],
6            'valid'   => ['email' => 'someone@example.net'],
7        ];
8
9        $rules = [
10            'sometimes|required|email',
11            'required|email',
12            'email',
13        ];
14
15        foreach ($rules as $r) {
16            printf("%s\n", $r);
17            foreach ($inputs as $name => $i) {
18                $validator = \Validator::make($i, ['email' => $r]);
19                printf(
20                    "    %-7s %s\n",
21                    $name,
22                    $validator->fails()? implode(',', $validator->errors()->all()): 'ok'
23                ) ;
24            }
25            printf("\n");
26        }
27    }

sometimes|required|email
    missing ok
    null    The email field is required.
    empty   The email field is required.
    valid   ok

required|email
    missing The email field is required.
    null    The email field is required.
    empty   The email field is required.
    valid   ok

email
    missing ok
    null    The email must be a valid email address.
    empty   ok
    valid   ok

投稿2017/06/28 03:45