Skip to content

Transform any Array to PHP Object. Scale your data processing

License

Notifications You must be signed in to change notification settings

nobrainr/morphism-php

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Morphism PHP

Build Status

Helps you to transform any object structure to another.

This library is inspired by Yann Renaudin's : Morphism library

Contribution

Getting started 🚀

Install morphism-php using composer : composer require gmulti/morphism-php.

use Morphism\Morphism;

What does it do? 🤔

Morphism uses a semantic configuration to go through the collection of graph objects you have to process. Then it extracts and computes the value from the specified path(s). Finally, it sets this value to the destination property from the schema.

Usage 🍔

Morphism is curried function that allows a partial application with a semantic configuration. You can use it in many ways:

Example

// Target type you want to have
class User {
    public function __construct($firstName, $lastName, $phoneNumber){
        $this->firstName   = $firstName;
        $this->lastName    = $lastName;
        $this->phoneNumber = $phoneNumber;
        $this->city = null;
   }
}

// Data source you want to map
$data = array(
    "name"      => "Iron Man",
    "firstName" => "Tony",
    "lastName"  => "Stark",
    "address" => array(
        "city"    => "New York City",
        "country" => "USA"
    ),
    "phoneNumber" => array(
        array(
            "type"   => "home",
            "number" => "212 555-1234"
        ),
        array(
            "type"   => "mobile",
            "number" => "646 555-4567"
        )
    )
);

// Mapping Schema ( see more examples below )
$schema = array(
    "city" => "address.city",
    "name" => function($data){
        return strtoupper($data["name"]);
    }
);

Morphism::setMapper("User", $schema);

// Map using the registered type and the registry
$result = Morphism::map("User", $data);

/// *** OUTPUT *** ///

class User {
    public $city // string(13) "New York City"
    public $name  // string(8) "iron man"
}

Multidimensional array

// Target type you want to have
class User {
}

// Data source you want to map
$data = array(
    array(
        "name"      => "Iron Man",
        "firstName" => "Tony",
        "lastName"  => "Stark",
        "address" => array(
            "city"    => "New York City",
            "country" => "USA"
        ),
        "phoneNumber" => array(
            array(
                "type"   => "home",
                "number" => "212 555-1234"
            ),
            array(
                "type"   => "mobile",
                "number" => "646 555-4567"
            )
        )
    ),
    array(
        "name"      => "Spiderman",
        "firstName" => "Peter",
        "lastName"  => "Parker",
        "address" => array(
            "city"    => "New York City",
            "country" => "USA"
        ),
        "phoneNumber" => array(
            array(
                "type"   => "home",
                "number" => "999 999-9999"
            )
        )
    )
);

// Mapping Schema ( see more examples below )
$schema = array(
    "city" => "address.city",
    "name" => function($data){
        return strtoupper($data["name"]);
    }
);

Morphism::setMapper("User", $schema);

// Map using the registered type and the registry
$result = Morphism::map("User", $data);

/// *** OUTPUT *** ///

array(
    class User {
        public $city // string(13) "New York City"
        public $name  // string(8) "iron man"
    },
    class User {
        public $city // string(13) "New York City"
        public $name  // string(8) "spiderman"
    }
)

Schema Examples

Dataset sample

$data = array(
    "name"      => "Iron Man",
    "firstName" => "Tony",
    "lastName"  => "Stark",
    "address" => array(
        "city"    => "New York City",
        "country" => "USA"
    ),
    "phoneNumber" => array(
        array(
            "type"   => "home",
            "number" => "212 555-1234"
        ),
        array(
            "type"   => "mobile",
            "number" => "646 555-4567"
        )
    )
);

// Target type you want to have
class User {
}

Agregator

// Schema
$schema = array(
    "fullName" => array("firstName", "lastName")
);

Morphism::setMapper("User", $schema);

// Map using the registered type and the registry
$result = Morphism::map("User", $data);

/// *** OUTPUT *** ///

class User {
    public $fullName // "Tony Stark"
}

Computing over Flattening / Projection

// Schema
$schema = array(
    "city" => (object) array(
        "path" => "address.city",
        "fn"   => function($city) {
            return strtolower($city);
        }
    ),
    "nbContacts" => function($data){
        return count($data["phoneNumber"]);
    }
);

Morphism::setMapper("User", $schema);

// Map using the registered type and the registry
$result = Morphism::map("User", $data);

/// *** OUTPUT *** ///

class User {
    public $city // "new york city" <= strtolower
    public $nbContacts // 2 <= computed from the object
}

License

MIT © Thomas Deneulin

About

Transform any Array to PHP Object. Scale your data processing

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages