How to make an array index not required in a validation with Respect Validation Key?

Question

I’m using the Respect\Validation to validate some fields in my form. I am using the method Validator::key() to be able to validate each value in an index of array that is sent from this form.

I have the following code:

Validator::key('nome', Validator::notOptional()->stringType())
      ->key('tipo', Validator::in(['f', 'j']))
      ->key('telefone', Validator::optional(
            Validator::regex('/^\(\d{2}\)\d{4}-\d{4}$/')
        ))
      ->key('celular', Validator::optional(
            Validator::regex('/^\(\d{2}\)\d{5}-\d{4}$/')
        ))
      ->key('email', Validator::email()->notOptional())
      ->key('cidade', Validator::notOptional()->stringType());

The value telefone and celular used Validator::optional() so that the fields did not need to exist, but if they did exist, they must be validated.

But when I send the form without completing it celular, I get the following error:

Key celular must be present

I wonder: how can I validate a key of an array with Respect Validation, but only if it exists?

References:

https://github.com/Respect/Validation/blob/master/docs/Key.md

Answer 1

From what I understood from documentation:

The method key has 3 parameters, where the third is "mandatory".

I imagine it would be so:

->key('celular', Validator::regex('/^\(\d{2}\)\d{5}-\d{4}$/'), false)

In the documentation there is this explanation:

v::key(string $name, v $validator, boolean $mandatory = true)