processFormData

The processFormData hook is triggered after a form has been submitted. It passes the form data array, the Data Container Array and the files array as arguments and does not expect a return value.

Parameters

  1. array $submittedData

    Form data submitted by the visitor.

  2. array $formData

    The form configuration from tl_form table.

  3. array $files

    Contains information about uploaded files (from “upload” widgets). Can be null.

  4. array $labels

    The field labels of the form.

  5. \Contao\Form $form

    The form instance.

Example

// src/EventListener/ProcessFormDataListener.php
namespace App\EventListener;

use Contao\CoreBundle\ServiceAnnotation\Hook;
use Contao\Form;
use Terminal42\ServiceAnnotationBundle\ServiceAnnotationInterface;

class ProcessFormDataListener implements ServiceAnnotationInterface
{
    /**
     * @Hook("processFormData")
     */
    public function onProcessFormData(
        array $submittedData, 
        array $formData, 
        ?array $files, 
        array $labels, 
        Form $form
    ): void
    {
        // Do something …
    }
}

References