gabrola/email-normalizer

A library that will normalize email addresses for cases when different email addresses all point towards a single email account

Maintainers

Details

github.com/Gabrola/email-normalizer

Source

Issues

Installs: 45 550

Dependents: 0

Suggesters: 0

Security: 0

Stars: 17

Watchers: 4

Forks: 8

Open Issues: 3

2.1.0 2020-06-05 19:14 UTC

Requires

  • php: >=5.6

Requires (Dev)

MIT 3bde78e0de4d8428dc9b2a3966846590b3e79af1

  • Youssef Gaber <1728215+Gabrola.woop@users.noreply.github.com>

This package is auto-updated.

Last update: 2025-01-10 14:06:10 UTC

README

This library will normalize email addresses for cases when different email addresses all point towards a single email account. For example user.name+whatever@gmail.com points to username@gmail.com. This is useful for cases such as when you want to limit a single user using a single email account to signup using different email addresses.

Packagist Version Packagist Downloads Codecov GitHub license

Installation

composer require gabrola/email-normalizer

Usage

<?php
use Gabrola\EmailNormalizer\EmailNormalizer;
use Gabrola\EmailNormalizer\EmailRules;

$emailNormalizer = new EmailNormalizer(new EmailRules());
$normalizedEmail = $emailNormalizer->normalize('username+whatever@gmail.com');

echo $normalizedEmail; //Returns username@gmail.com

Rule Types

  • Plus Tags: username+tag@gmail.com normalizes as username@gmail.com
  • Hyphen Tags: username-tag@yahoo.com normalizes as username@yahoo.com
  • Dots: first.last@gmail.com normalizes as firstlast@gmail.com
  • Subdomain Addressing: whatever@username.fastmail.com normalizes as username@fastmail.com
  • Aliases: username@googlemail.com normalizes as username@gmail.com

Providers

  • Gmail
  • Outlook
  • Yahoo
  • Fastmail
  • Apple iCloud
  • Yandex
  • Mail.ru
  • ProtonMail