Reference

Specifications

Laminas\InputFilter allows configuration-driven creation of input filters via Laminas\InputFilter\InputFilterAbstractServiceFactory. This abstract factory is responsible for creating and returning an appropriate input filter given named configuration under the top-level configuration key input_filter_specs.

It is registered with Laminas\InputFilter\InputFilterPluginManager, allowing you to pull the input filter via that plugin manager. A side effect is that forms pulled from Laminas\Form\FormElementManager can use these named input filters.

Setup

When using laminas-mvc version 2 releases, this functionality is disabled by default. To enable it, you must add the Laminas\InputFilter\InputFilterAbstractServiceFactory abstract factory to the Laminas\InputFilter\InputFilterPluginManager configuration, which is under the input_filters configuration key.

return [
    'input_filters' => [
        'abstract_factories' => [
            'Laminas\InputFilter\InputFilterAbstractServiceFactory',
        ],
    ],
];

For Mezzio when using the configuration manager, and for laminas-mvc v3 releases, the functionality is enabled by default, assuming you are using the component installer.

Example

In the following code, we define configuration for an input filter named foobar:

return [
    'input_filter_specs' => [
        'foobar' => [
            [
                'name' => 'name',
                'required' => true,
                'filters' => [
                    [
                        'name' => 'Laminas\Filter\StringTrim',
                        'options' => [],
                    ],
                ],
                'validators' => [],
                'description' => 'Hello to name',
                'allow_empty' => false,
                'continue_if_empty' => false,
            ],
        ],
    ],
];

When creating a controller, we might then pull the InputFilterPluginManager, and retrieve the foobar input filter we've defined in order to inject it:

use Laminas\InputFilter\InputFilterPluginManager;
use Laminas\ServiceManager\FactoryInterface;
use Laminas\ServiceManager\ServiceLocatorInterface;

class MyValidatingControllerFactory implements FactoryInterface
{
    public function createService(ServiceLocatorInterface $controllers)
    {
        // Retrieve the application service manager
        $services = $controllers->getServiceLocator();

        // Retrieve the InputFilterManager
        $filters = $services->get(InputFilterPluginManager::class);

        // Instantiate the controller and pass it the foobar input filter
        return new MyValidatingController($filters->get('foobar'));
    }
}

And you can use it as you already did with other input filters:

$inputFilter->setData([
    'name' => 'test',
]);

if (! $inputFilter->isValid()) {
    echo 'Data invalid';
}