Deprecate validate() and add isValid() and isNotValid()

[rick-nu]

What

To have better readable code, we decided it would be better to rename validate() to isValid(). Also adding isNotValid() was requested. Since the Validator API is still visible in one auto-completion popup, I think it won't be a problem to add it.

ToDo

• Make sure that we want to add isNotValid()
• Update documentation

How to test

1. See that all tests pass with the new isValid() function
2. See that validate() still works, but is now deprecated
3. See that the documentation now also uses isValid()

[rick-nu]

[localheinz]

👍

[berry-langerak]

Actually, @localheinz, "the jury is still out on this" ;) I'm very much in doubt on whether to do take this approach or moving the isValid and isNotValid to Particle\Validator\ValidationResult and making validate always return a ValidationResult instead. So:

$v = new Validator;
$v->required('name')->length(4);

$result = $v->validate(['name' => 'Jane']);
if ($result->isNotValid()) {
   print_r($result->getMessages());
}

What do you think about that?

[localheinz]

@berry-langerak

Returning a ValidationResult makes sense to me, too. Totally fine with the result having methods like isValid() and isNotValid()!

[rick-nu]

I will pick that up then.