php-extended/php-email-address-object

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

Maintainers

Details

gitlab.com/php-extended/php-email-address-object

Homepage

Source

Issues

Installs: 167 752

Dependents: 8

Suggesters: 0

Security: 0

5.0.0 2022-12-18 11:26 UTC

Requires

Requires (Dev)

MIT 90e4d5a1a3bb1c2d6c2258c835894e29b1714e28

phpaddressemailimplementationRFC5322

This package is auto-updated.

Last update: 2023-05-18 12:22:25 UTC

README

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

coverage build status

Installation

The installation of this library is made via composer and the autoloading of all classes of this library is made through their autoloader.

  • Download composer.phar from their website.
  • Then run the following command to install this library as dependency :
  • php composer.phar php-extended/php-email-address-object": "^5"

Basic Usage

To use this interface, you may do the following :


use PhpExtended\Email\EmailAddress;
use PhpExtended\Email\Mailbox;
use PhpExtended\Email\MailboxGroup;
use PhpExtended\Email\MailboxGroupList;

$email = new EmailAddress('example', 'example.com'); // example@example.com
$email->__toString(); // echo example@example.com

$mailbox = new Mailbox($email, 'Example, Inc');
$mailbox->__toString(); // echo "Example, Inc" <example@example.com>

$mailboxList = new MailboxList([$mailbox]);
$mailboxList->__toString(); // echo "Example, Inc" <example@example.com>

$mailboxGroup = new MailboxGroup($mailboxList, 'All Examples');
$mailboxGroup->__toString(); // echo "All Examples": "Example, Inc" <example@example.com>

$mailboxGroupList = new MailboxGroupList([$mailboxGroup]);
$mailboxGroupList = $mailboxGroupList->withEmailAddress(new EmailAddress('example2', 'example.com'), 'Example2, Inc', 'Other Examples');
$mailboxGroupList->__toString(); // echo "All Examples": "Example, Inc" <example@example.com>; "Other Examples": "Example2, Inc" <example2@example.com>

$emails = $mailboxGroupList->collectEmailAddresses();
echo implode(', ', iterator_to_array($emails)); // echo "example@example.com, example2@example.com"

To parse email addresses, you may do the following :


use PhpExtended\Email\EmailAddressParser;

$parser = new EmailAddressParser();
$email = $parser->parse('email@example.com');
// $email instanceof \PhpExtended\Email\EmailAddress

or, for headers of requests :


use PhpExtended\Email\MailboxGroupListParser;

$parser = new MailboxGroupListParser();
$list = $parser->parse('Group: Toto toto@example.com; Group2: toto2@example.com, "Tata \"" tata@example.com');
// $list instanceof \PhpExtended\Email\MailboxGroupList

echo $list->collectEmailAddresses();
// echo "toto@example.com, toto2@example.com, tata@example.com"

Test data

This library was tested against the following data sets:

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).