tsufeki/kayo-json-mapper

Map JSON data to PHP objects

Kayo JSON mapper

, _(*1)

Map JSON data to PHP objects and back. No custom annotations needed., _(*2)

Installation

With Composer:, _(*3)

$ composer require tsufeki/kayo-json-mapper

Usage

use Tsufeki\KayoJsonMapper\MapperBuilder;

$mapper = MapperBuilder::create()
    ->getMapper();

$serialized = '{"foo": [1, 2], "bar": "baz"}';

// Pass data and the expected type:
$object = $mapper->load(json_decode($serialized), AClass::class);

$serialized2 = json_encode($mapper->dump($object));

Configuration

Kayo is designed to load/dump data without the need for special per class configuration such as annotations etc. All necessary information is gathered from reflection and doc comments., _(*4)

However, its general behaviour can be customized in many ways through MapperBuilder methods., _(*5)

Types & loading

All types recognized by phpDocumentor can be loaded, even union type (A|B) -- but please note that objects are differentiated on their shape (i.e. properties) so throwOnMissingProperty(true) and throwOnUnknownProperty(true) are usually necessary., _(*6)

License

MIT - see LICENCE., _(*7)