yarri/email-address-recognizer

Parses and validates email addresses from To: or Cc: headers, including named addresses, quoted display names, and RFC 2822 groups.

v0.2 2026-04-19 20:21 UTC

Requires

• php: >=5.6.0
• atk14/dictionary: 1.*

Requires (Dev)

• atk14/tester: 0.5.*

MIT

• Jaromir Tomek

README

Parses email addresses from a To: or Cc: header value. Handles plain addresses, named addresses, quoted display names, and RFC 2822 group syntax. The result is iterable, countable, and accessible as an array.

Installation

composer require yarri/email-address-recognizer

Basic Usage

$ear = new Yarri\EmailAddressRecognizer('John Doe <[e-mail]>, [e-mail]');

count($ear);        // 2
$ear->isValid();    // true
echo $ear;          // "John Doe <[e-mail]>, [e-mail]"

$ear[0]->getAddress();     // "[e-mail]"
$ear[0]->getName();        // "John Doe"
$ear[0]->getFullAddress(); // "John Doe <[e-mail]>"
$ear[0]->getDomain();      // "doe.com"
$ear[0]->isValid();        // true

$ear[1]->getAddress();     // "[e-mail]"
$ear[1]->getName();        // ""
$ear[1]->getFullAddress(); // "[e-mail]"

Supported Address Formats

// Plain address
new Yarri\EmailAddressRecognizer('[e-mail]');

// Named address
new Yarri\EmailAddressRecognizer('John Doe <[e-mail]>');

// Quoted display name (allows commas and special characters in the name)
new Yarri\EmailAddressRecognizer('"Doe, John" <[e-mail]>');

// Multiple addresses
new Yarri\EmailAddressRecognizer('[e-mail], Jane Doe <[e-mail]>');

// RFC 2822 group syntax
new Yarri\EmailAddressRecognizer('IT: John Doe <[e-mail]>, [e-mail];');

// Multiple groups
new Yarri\EmailAddressRecognizer('IT: John Doe <[e-mail]>, [e-mail]; Management: [e-mail], [e-mail];');

Iterating Over Addresses

EmailAddressRecognizer implements Iterator, Countable, and ArrayAccess:

$ear = new Yarri\EmailAddressRecognizer('[e-mail], Jane Doe <[e-mail]>');

foreach ($ear as $item) {
    echo $item->getAddress();  // "[e-mail]", then "[e-mail]"
}

count($ear);  // 2
$ear[0];      // RecognizedItem for [e-mail]

Validation

isValid() returns true only when every parsed address is valid. Individual addresses can be checked separately:

$ear = new Yarri\EmailAddressRecognizer('[e-mail], not-an-address');

$ear->isValid();       // false — at least one address is invalid

$ear[0]->isValid();    // true
$ear[1]->isValid();    // false
$ear[1]->getAddress(); // "" (empty for invalid addresses)

Input is normalized on output — extra whitespace is trimmed and trailing commas are dropped:

echo new Yarri\EmailAddressRecognizer('  [e-mail] ,  [e-mail]  ');
// "[e-mail], [e-mail]"

RFC 2822 Groups

Group names are available via getGroup():

$ear = new Yarri\EmailAddressRecognizer('IT: John Doe <[e-mail]>, [e-mail];');

$ear[0]->getGroup(); // "IT"
$ear[1]->getGroup(); // "IT"

RecognizedItem

A single address string can be parsed directly using RecognizedItem:

$item = new Yarri\EmailAddressRecognizer\RecognizedItem('"Doe, John" <[e-mail]>');

$item->isValid();        // true
$item->getAddress();     // "[e-mail]"
$item->getName();        // "Doe, John"
$item->getFullAddress(); // '"Doe, John" <[e-mail]>'
$item->getDomain();      // "doe.com"
$item->getGroup();       // ""
echo $item;              // '"Doe, John" <[e-mail]>'

RecognizedItem is invalid if the input contains zero or more than one address:

(new Yarri\EmailAddressRecognizer\RecognizedItem(''))->isValid();                             // false
(new Yarri\EmailAddressRecognizer\RecognizedItem('[e-mail], [e-mail]'))->isValid();   // false

Testing

composer install --dev
cd test
../vendor/bin/run_unit_tests

License

EmailAddressRecognizer is free software distributed under the terms of the MIT license