wmde/email-address

Email Address value object written in PHP 7

Email Address

, _(*1)

Email Address value object that can, _(*2)

• split username and domain
• normalize Internationalized Domain names (IDN).

class EmailAddress {
    public function __construct( string $emailAddress ) {
        // Validation
    }
    public function getUserName(): string {}
    public function getDomain(): string {}
    public function getNormalizedDomain(): string {}
    public function getFullAddress(): string {}
    public function getNormalizedAddress(): string {}
    public function __toString(): string {}
}

Installation

To use the Email Address library in your project, simply add a dependency on wmde/email-address to your project's composer.json file. Here is a minimal example of a composer.json file that just defines a dependency on Email Address 2.x:, _(*3)

{
    "require": {
        "wmde/email-address": "~2.0"
    }
}

Development

Installing dependencies

To pull in the project dependencies via Composer, run:, _(*4)

make install

To update them, run, _(*5)

make update

Running the CI checks

To run all CI checks, which includes PHPUnit tests, PHPCS style checks and static analysis with PHPStan, run:, _(*6)

make

Running the tests

To run the PHPUnit tests run, _(*7)

make test

To run a subset of PHPUnit tests or otherwise pass flags to PHPUnit, run, _(*8)

docker compose run --rm app ./vendor/bin/phpunit --filter SomeClassNameOrFilter