Email.php

<?php

declare(strict_types=1);

namespace App\VO;

use InvalidArgumentException;

/**
 * Class Email обьект значение которое инкапсулирует в себе email значение
 */
final class Email
{
    /**
     * @var string email
     */
    private $email;

    /**
     * Email constructor.
     *
     * @param string $email
     */
    private function __construct(string $email)
    {
        $this->email = $email;
    }

    /**
     * Метод создает Обьект-значение Email из строки
     *
     * @param string $email
     *
     * @return self
     */
    public static function createFromString(string $email): Email
    {
        $email = mb_strtolower($email);
        if (! filter_var($email, FILTER_VALIDATE_EMAIL)) {
            throw new InvalidArgumentException('Переданное значение должно быть корректным email адресом');
        }

        return new self($email);
    }

    /**
     * Метод возвращает значение
     *
     * @return string
     */
    public function __toString(): string
    {
        return $this->email;
    }
}