miovisman/normemail

Normalization of email for bans, for request cache to SFS or for checking the uniqueness of new users.

1.0.0 2020-01-11 04:21 UTC

Requires

• php: >=5.6.0
• ext-intl: *
• ext-mbstring: *

MIT

• Visman

• email
• ban
• normalization
• canonical email

README

Installation

composer require miovisman/normemail

normalize() method

$nEmail = new MioVisman\NormEmail\NormEmail();

$email = $nEmail->normalize($email);

• Method does not validate email address

• Do not use normalized email to send emails

• Use a normalized email to check the ban or uniqueness of the email of a new user. Check on the normalized emails ;)
• The domain is lowercase (and in Punycode)
• The local part is lowercase unless otherwise specified
• The local part after the "+" is truncated (for Yahoo domains - after the "-")

// some string
                                      =>
ExampLe                               => example
ExampLe@                              => example@
exaMple.COM                           => example.com
.example.com                          => .example.com
@examPLe.com                          => example.com
"examPLe.com                          => "example.com
"[e-mail]              => "[e-mail]
googlemail.com                        => gmail.com
pm.me                                 => protonmail.com
yandex.tj                             => yandex.ru
ya.ru                                 => yandex.ru
.ya.ru                                => .yandex.ru

// Unicode
ПОЛЬЗОВАТЕЛЬ@домен.РУ                 => пользователь@xn--d1acufc.xn--p1ag
пользователь+тег@домен.ру             => пользователь@xn--d1acufc.xn--p1ag

// Gmail
[e-mail]               => [e-mail]
[e-mail] => [e-mail]

// Protonmail
[e-mail]                 => [e-mail]
[e-mail]               => [e-mail]

// Yahoo (.com, .ae, .at, ...)
[e-mail]                => [e-mail]
[e-mail]                => [e-mail]

// Yandex (13 domains)
user.name+tag@яндекс.рф               => [e-mail]
[e-mail]                  => [e-mail]
[e-mail]                        => [e-mail]

License

This project is under MIT license. Please see the license file for details.