README

A library that implements the php-extended/php-email-address-parser-interface interface library.

Installation

The installation of this library is made via composer. Download composer.phar from their website. Then add to your composer.json :

	"require": {
		...
		"php-extended/php-email-address-parser-object": "^4"
		...
	}

Then run php composer.phar update to install this library. The autoloading of all classes of this library is made through composer's autoloader.

Basic Usage

To parse email addresses, you may do the following :

use PhpExtended\Email\EmailAddressParser;

$parser = new EmailAddressParser();
$email = $parser->parse('[email protected]');
// $email instanceof \PhpExtended\Email\EmailAddress

or, for headers of requests :

use PhpExtended\Email\MailboxGroupListParser;

$parser = new MailboxGroupListParser();
$list = $parser->parse('Group: Toto [email protected]; Group2: [email protected], "Tata \"" [email protected]');
// $list instanceof \PhpExtended\Email\MailboxGroupList

echo $list->collectEmailAddresses();
// echo "[email protected], [email protected], [email protected]"

Test data

This library was tested against the following data sets:

• https://gist.github.com/cjaoude/fd9910626629b53c4d25
• https://github.com/dominicsayers/isemail/blob/master/test/tests.xml
• https://en.wikipedia.org/wiki/Email_address

If you can find other data sets to test against, just file an issue and i will try to test this library against it.

License

MIT (See license file).