README

A lightweight library to map array data into PHP immutable objects, collections and strongly typed arrays via constructors.

Benchmark

Check benchmark/ directory for more details about the implementation.

Installation

composer require guennichi/mapper

Usage

use Guennichi\Collection\Collection;

final class Person
{
    public function __construct(public readonly string $name) {}
}

/**
 * @extends Collection<Person>
 */
final class PersonCollection extends Collection
{
    public function __construct(Person ...$elements)
    {
        parent::__construct(...$elements);
    }
}

$input = [
    ['name' => 'Person1'],
    ['name' => 'Person2'],
    ['name' => 'Person3'],
];

$mapper = new Guennichi\Mapper\Mapper(/** dependencies */)

$output = $mapper->map($input, PersonCollection::class);
// Result instance of PersonCollection(Person{"name": "Person1"}, Person{"name": "Person2"}, Person{"name": "Person3"})

Dedication

Special thanks to my colleague @Gabriel Ostrolucký for his support and advices to make this happen.