simonisme/array-to-dto

2.0.2 2017-09-03 13:41 UTC

Requires

• php: >=7.1.0

Requires (Dev)

• phpunit/phpunit: 6.0

MIT

README

This is simple library to convert array to specified value object classes.

Example

Simple object

class EmailAddress
{
	public $email;

	public function __construct(string $email)
	{
		$this->email = $email;
	}

}

$arrayToDtoParse = new ArrayToDtoParser();
$result  = $arrayToDtoParse->parseToDto(EmailAddress::class, [
    '[e-mail]';
]);

//  $result variable contains correct EmailAddress object
echo $result->email; // [e-mail]

Nested object

class User
{
	public $emailAddress;
	public $number;
	public $birthDate;

	public function __construct(EmailAddress $emailAddress, string $name, \DateTime $birthDate)
	{
		$this->emailAddress = $emailAddress;
		$this->number = $name;
		$this->birthDate = $birthDate;
	}
}

class Nested
{
	public $user;
	public $emailAddress;

	public function __construct(User $user, EmailAddress $emailAddress)
	{
		$this->user = $user;
		$this->emailAddress = $emailAddress;
	}
}

class EmailAddress
{
	public $email;

	public function __construct(string $email)
	{
		$this->email = $email;
	}
}

class Dto
{
	public $user;
	public $nested;

	public function __construct(User $user, Nested $nested)
	{
		$this->user = $user;
		$this->nested = $nested;
	}
}

$arrayToDtoParse = new ArrayToDtoParser();
$result  = $arrayToDtoParse->parseToDto(Dto::class, [
    'user' => [
        'emailAddress' => '[e-mail]',
        'name' => 'Simon',
        'birthDate' => '1991-01-02',
    ],
    'nested' => [
        'user' => [
            'emailAddress' => '[e-mail]',
            'name' => 'Simon',
            'birthDate' => '1991-01-02',
        ],
        'emailAddress' => '[e-mail]'
    ]
]);

For more examples please look into /tests directory.

Important

Keys in the array and constructor's parameters have to have the same names!