Elements

Email

Laminas\Form\Element\Email is meant to be paired with the FormEmail helper for HTML5 inputs with type "email". This element adds filters and validators to its input filter specification in order to validate HTML5 valid email address on the server.

Basic Usage

This element automatically adds a type attribute of value email.

use Laminas\Form\Element;
use Laminas\Form\Form;

$form = new Form('my-form');

// Single email address:
$email = new Element\Email('email');
$email->setLabel('Email Address')
$form->add($email);

// Comma separated list of emails:
$emails = new Element\Email('emails');
$emails->setLabel('Email Addresses');
$emails->setAttribute('multiple', true);
$form->add($emails);

Using array notation:

use Laminas\Form\Element;
use Laminas\Form\Form;

$form = new Form('my-form');

// Single email address:
$form->add([
    'type' => Element\Email::class,
    'name' => 'email',
    'options' => [
        'label' => 'Email Address',
    ],
]);

// Comma separated list of emails:
$form->add([
    'type' => Element\Email::class,
    'name' => 'emails',
    'options' => [
        'label' => 'Email Addresses',
    ],
    'attributes' => [
        'multiple' => true,
    ],
]);

Set multiple attribute before calling prepare

Note: the multiple attribute should be set prior to calling Laminas\Form::prepare(). Otherwise, the default input specification for the element may not contain the correct validation rules.

Public Methods

The following methods are specific to the Email element; all other methods defined by the parent Element class are also available.

Method signature Description
getInputSpecification() : array See description below.
setValidator(ValidatorInterface $validator) : void Sets the primary validator to use for this element.
getValidator() : ValidatorInterface Get the primary validator.
setEmailValidator(ValidatorInterface $validator) : void Sets the email validator to use for multiple or single email addresses.
getEmailValidator() : void Get the email validator to use for multiple or single email addresses. The default Regex validator in use is to match that of the browser validation, but you are free to set a different (more strict) email validator such as Laminas\Validator\Email if you wish.

getInputSpecification() returns an input filter specification, which includes a Laminas\Filter\StringTrim filter, and a validator based on the multiple attribute:

  • If the multiple attribute is unset or false, a Laminas\Validator\Regex validator will be added to validate a single email address.
  • If the multiple attribute is true, a Laminas\Validator\Explode validator will be added to ensure the input string value is split by commas before validating each email address with Laminas\Validator\Regex.