kevbradwick/drift

A lightweight PHP library for mapping data to PHP classes

Drift

, _(*1)

Drift is a PHP library for mapping arbitrary data to PHP classes., _(*2)

Installation

Drift is available on Packagist, so you can use composer;, _(*3)

composer require kevbradwick/drift

Usage

Say you have a class with private member variables like this;, _(*4)

namespace Application;

class Actor
{
    /**
     * @Drift\String()
     */
    private $name;

    /**
     * @Drift\Int()
     */
    private $age;

    /**
     * @Drift\Date(field="date_of_birth")
     */
    private $dateOfBirth;
}

And you have some data, possibly consumed from an API, that looks like this;, _(*5)

$data = [
    'name' => 'Arnold Schwarzenegger',
    'age' => 68,
    'date_of_birth' => 'July 30, 1947'
]

You can then use Drift\Mapper to create a new instance of the class, initialised with the data., _(*6)

use Drift\Mapper;
use Drift\Reader\AnnotationReader;
use Application\Actor;

$mapper = new Mapper(new AnnotationReader());
$mapper->setData($data);

$actor = $mapper->instantiate(Actor::class);

In addition to annotations, you can specify mapping using Yaml or plain old php., _(*7)

Full documentation can be found on the Wiki., _(*8)