Default InputerFilter in Form creates Input, instead of ArrayInput for multi select elements

• I was not able to find an open or closed issue matching what I'm seeing.
• This is not a question. (Questions should be asked on slack (Signup for Slack here) or our forums.)

The default InputFilter of Forms creates always an Input for Elements within the Form. Even, if the Select Element has the multiple attribute. The problem is, when you create an InputFilter and set it to the Form, then the default InputFilter won't be replaced, it will merge Validators and Filters with the new ones. So you're given ArrayInput will be an Input in the form and the validators will fail, because they receive an array as value, but expect a string|number.

Code to reproduce the issue

Just create a Form with a multi select.

Expected results

The default Input for Select with multiple attribute should be ArrayInput.

Actual results

The default Input for Select is always Input.

Still no feedback? At the moment I do not have time to find the origin of the bug and provide a patch. But it is actually a critical bug and should be fixed. I am wondering, why no one reported it until now.

[weierophinney]

Still no feedback?

Please review the code of conduct; the majority of developers on this project are volunteers, and there are close to 200 repositories we maintain. We simply cannot jump on every issue or pull request as it comes in. Additionally, pull requests, even those that simply provide a failing test, get priority over issues generally, as they provide us with more concrete information on how the reporter is attempting to execute the code, and what their expectations are.

Just create a Form with a multi select.

Please demonstrate how you are doing this, so that we can verify that we are creating the scenario in the exact same manner you are; without that information, we may be unable to reproduce the issue. (E.g., the options you are passing to the multiselect may be invalid, or if you are using configuration, there might be a subtle typo leading to the scenario.)

I see. Thank you for your response! I will provide the relevant code within the next two weeks. I am a little busy right now.

$form = new \Zend\Form\Form;
$form->add([
    'name' => 'multiselect',
    'type' => 'select',
    'options' => [
        'value_options' => ['A', 'B', 'C']
    ],
    'attributes' => [
        'multiple' => true
    ]
]);

$multiSelectInput = get_class($form->getInputFilter()->get('multiselect'));
echo $multiSelectInput; // returns Zend\InputFilter\Input, should be Zend\InputFilter\ArrayInput

Here we go. I hope, this helps. Version of Zend-Form is "2.5.3".

[froschdesign]

@eweso
Please check this unit test and then update your value options:

public function testValidationWithOptionMultiple()
{
    // Element
    $element = new SelectElement('foobar');
    $element->setValueOptions(
        [
            'A' => 'A',
            'B' => 'B',
            'C' => 'C',
        ]
    );
    $element->setAttribute('multiple', true);
    $element->setUseHiddenElement(true);

    // Input filter
    $inputFilter = new InputFilter();
    $inputFilter->add($element->getInputSpecification());

    // Tests
    $inputFilter->setData([
        'foobar' => [
            'A',
            'B',
        ],
    ]);
    $this->assertTrue($inputFilter->isValid());

    $inputFilter->setData([
        'foobar' => 'A',
    ]);
    $this->assertTrue($inputFilter->isValid());

    $inputFilter->setData([
        'foobar' => 'D',
    ]);
    $this->assertFalse($inputFilter->isValid());
}

The Zend\InputFilter\ArrayInput is not needed, the validator Explode is used.

If you do not add a filter or validator, you don't need an ArrayInput, this is true. But if you create a dynamic multi-select and you want to validate and filter all of it's entries, you need to have an ArrayInput, to iterate through all items of the select. If not, all other validators, like EmailValidator will return false, because EmailValidator expects a string, not an array.

[froschdesign]

@eweso

If you do not add a filter or validator, you don't need an ArrayInput, this is true.

Filters and validators are already there:

zend-form/src/Element/Select.php

Line 288 in 4419eef

public function getInputSpecification()

But if you create a dynamic multi-select and you want to validate and filter all of it's entries, you need to have an ArrayInput…

If you set the the value_options before you validate your form, then everything works. No extra filters or validators needed.

---

I'm sorry, but you're only describing your conclusion and not the actual problem.
Please provide an unit test to illustrate the problem.

@froschdesign

If you set the the value_options before you validate your form, then everything works. No extra filters or validators needed.

This is not what I was talking about. I want another validator! I don't want to test, if the value is in the given set of value_options, I want to validate each value, because the client is allowed to manipulate the select values dynamically and the values which are set, are email addresses and those addresses need to be validated, before I work with them.

I'm sorry, but you're only describing your conclusion and not the actual problem.
Please provide an unit test to illustrate the problem.

Here we go. If you add another validator, like EmailAddress, than the validation process fails. Because the Input is not an ArrayInput, the Validator validates the array as the EmailAddress-Validator value.

    public function testValidationWithOptionMultiple()
    {
        // Element
        $element = new SelectElement('foobar');

        // Imagine that these values are set after post and on form creation but before form validation
        $element->setValueOptions(
            [
                'info@'           => 'info@',
                'info@test.de'    => 'info@test.de',
                'info@example.de' => 'info@example.de',
            ]
        );
        $element->setAttribute('multiple', true);
        $element->setUseHiddenElement(true);

        // Input filter
        $inputFilter = new InputFilter();
        $inputFilter->add($element->getInputSpecification());

        // Add Email Validator
        $inputFilter->get('foobar')->getValidatorChain()->attach(new EmailAddressValidator);

        // Tests
        $inputFilter->setData([
            'foobar' => [
                'info@test.de',
                'info@example.de',
            ],
        ]);
        $this->assertTrue($inputFilter->isValid());

        $inputFilter->setData([
            'foobar' => 'info@',
        ]);
        $this->assertFalse($inputFilter->isValid());

        $inputFilter->setData([
            'foobar' => 'info@not.de',
        ]);
        $this->assertFalse($inputFilter->isValid());
    }

[froschdesign]

@eweso

This is not what I was talking about. I want another validator!

And why is this info and code example missing in your first post?

Your usage is wrong. You must set the EmailAddress validator to the Explode validator - not to the validator chain!

See: https://docs.zendframework.com/zend-validator/validators/explode/#supported-options

---

The last line of your code example should be included assertTrue.

[kynx]

@froschdesign allah knows why I’ve been following this one, but I have. None of the solution you have finally given is obvious from the documentation.

GitHub is not the place for support. But you have, finally, given it. Why didn’t you suggest a PR on the docs?

[froschdesign]

@kynx
Wait wait. This is no support, it had to be clarified if this issue report a bug or something else. Therefore, no label was set until now.

But you are right, the conclusion of this issue report is to extend the documentation for the Select element, because the hint to the Explode validator is missing.
And we should add some more code examples.

https://docs.zendframework.com/zend-form/element/select/