[11.x] create new "has" validation rule

[browner12]

currently we have the "in" rule, which checks if given input is in a list of approved values. this new "has" rule is kind of the opposite of that. it checks that expected values are included in the given array of input.

for example, assume you are setting up the ability to restrict access to certain IP addresses. you might setup some rules like this:

return [
    'allowed_ips'   => ['present', 'nullable', 'array'],
    'allowed_ips.*' => ['required', 'ip'],
];

However, you want to make sure the current user's current IP address is included in the provided array of input. Current rules do not provide a way to do this. With the new has rule, the rules would change to:

return [
    'allowed_ips'   => ['present', 'nullable', 'array', 'has:' . $request->ip()],
    'allowed_ips.*' => ['required', 'ip'],
];

You may also pass multiple parameters to the has rule, which would require all of the passed parameters to exist in the given input.

[Jacobs63]

Based on the naming, I'd expect this to work as \Illuminate\Support\Arr::has, however, that is not the case.

Perhaps naming it to contains would make more sense?

I like the idea 👍

[browner12]

I like "contains" as well. Open to whatever the maintainers decide on.