Create age validator (Deprecates minimumAge)

[Petah]

This resumes the discussion happened below until @caferrari comment:

1. Create an age validation rule: v::age($min, $max=null).
2. Deprecate (remove) mininumAge validation rule in favor of the age rule.

Original message (for historical purposes):

There is a minimumAge but no maximumAge.
Any reason, or just missed?

[augustohp]

Actually there is some legal complications on letting people below the legal age of the country signing for some services, but never heard of possible limitations for maximum age.

I do believe that if there are applications for that, than we should probably consider adding it or accept a pull request :)

@Petah Do you have some examples of use cases for that validator?

[Petah]

@augustohp we have had problems with people submitting an age in the incorrect format, and/or with typos causing us to require implementing validation rules around it. Also when asking for a date of birth, expecting the user to be under 120 years should be an acceptable limitation.

I will look at implementing this based off the minimumAge validator and sending you a pull request.

[henriquemoody]

@Petah I think that could be a good idea to create two rules, if you can: lessThan and greaterThan, so minimumAge and maximumAge may extends these classes. What you thing?
Btw, you can just create the maximumAge rule. Do what you think better. ;)

[alganet]

We already have min, max and between which are useful for validating ranges, and they work with dates as well. This works:

v::min('yesterday')->max('tomorrow')->validate(new DateTime('today'));

The minimumAge validator has a single difference from max though: the validation message is more specific, it tells you about ages, not just generic dates.

Perhaps an age validator would be something nice:

v::age('+18')->validate(...
v::age('-120')->validate(...

The string containing the sings + and - can be directly reused in a strtotime operation inside the validation implementation, we just need to append the "years" suffix:

strtotime("+18 years"); //It Works!

Thoughts?

[henriquemoody]

+0
Nothing, just agreed, btw I don't know if age is a good name...

[alganet]

ageDifference?

[nickl-]

ageDiff ?

[henriquemoody]

No, I thinks age is better.
+1 for age

[caferrari]

My suggestion is to validate ages from a date of birth, something like this:

// $format should be a date format
v::Age($format[, $min=0[, $max=120]])

To validate numbers we can use the between validator.

[alganet]

I'm not sure about the format. The same could be written like:

v::date($format)->age(18, 90);

I believe keeping them separate is more modular.

Anyway, your suggestion is by far the best. Removing the format parameter we can even make it backward-compatible with the minimumAge() validator and deprecate it.

+1 for v::age($min, $max)

[caferrari]

Nice, I've put format parameter because I was not sure that this kind of fluent validator was possible... so

+1 for v::age($min, $max)

[augustohp]

I've update the issue description to easy contributions and resume discussion until now.

[henriquemoody]

This rule is going to be available in 9.0 version.