wundii/data-mapper

Modern PHP 8.2+ mapping XML, JSON and Arrays into PHP classes

1.2.1 2025-04-14 12:13 UTC

Requires

• php: >=8.2
• ext-json: *
• ext-pcre: *
• ext-reflection: *
• ext-simplexml: *
• ext-spl: *
• ext-xml: *

Requires (Dev)

• phpstan/phpstan: ^2.0
• phpstan/phpstan-strict-rules: ^2.0
• phpunit/phpunit: ^11.4
• rector/rector: ^2.0
• symfony/var-dumper: ^6 || ^7
• symplify/easy-coding-standard: ^12.3
• wundii/phplint: ^0.3

MIT

• Andreas Wunderwald

• json
• xml
• array
• object
• mapper

README

This is a modern php 8.2+ mapper relies on strict data types, dependency capability and convenient processing for mapping xml, json and arrays into objects.

Features

• Mapping source data into objects
• Mapping source data with a list of elements into a list of objects
• Initialize object via constructor, properties or methods
• Map nested objects, arrays of objects
• Class mapping for interfaces or other classes
• Custom root element for starting with the source data

Supported Types

• null
• bool|?bool
• int|?int
• float|?float
• string|?string
• array
  • int[]
  • float[]
  • string[]
  • object[]
• object|?object
• enum|?enum

Supported Formats

• array
• json
• xml

Installation

Require the bundle and its dependencies with composer:

composer require wundii/data-mapper

Usage

Minimal usage

use Wundii\DataMapper\DataMapper;

/**
 * DataConfig default settings
 * - ApproachEnum::SETTER - will use the constructor to map the data
 * - AccessibleEnum::PUBLIC - will use only public properties/methods
 * - classMap = [] - will not map any classes 
 */

$dataMapper = new DataMapper();

$testClass = $dataMapper->array($array, TestClass::class);
$testClass = $dataMapper->json($json, TestClass::class);
$testClass = $dataMapper->xml($xml, TestClass::class);

Usage with custom configuration

use Wundii\DataMapper\DataConfig;
use Wundii\DataMapper\DataMapper;
use Wundii\DataMapper\Enum\ApproachEnum;

$dataConfig = new DataConfig(
        approachEnum: ApproachEnum::PROPERTY,
        classMap: [
            DateTimeInterface::class => DateTime::class,
        ],
    );
$dataMapper = new DataMapper($dataConfig);

$testClass = $dataMapper->array($array, TestClass::class);
$testClass = $dataMapper->json($json, TestClass::class);
$testClass = $dataMapper->xml($xml, TestClass::class);

ToDo`s

• ElementObjectResolver->CreateInstance(...) private properties/methods
• JsonSourceData phpstan issues
• Smaller performance todos