wundii / data-mapper-symfony-bundle
A Symfony integration for wundii/data-mapper, modern and fast object mapper for PHP 8.2+. Strict types. Converts JSON, XML, YAML, NEON, arrays, and objects to PHP objects.
Installs: 258
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 0
Forks: 0
Open Issues: 0
Type:symfony-bundle
Requires
- php: >=8.2
- ext-json: *
- ext-pcre: *
- ext-reflection: *
- ext-simplexml: *
- ext-spl: *
- ext-xml: *
- symfony/config: ^6.4 || ^7.0
- symfony/console: ^6.4 || ^7.0
- symfony/dependency-injection: ^6.4||^7.0
- symfony/http-kernel: ^6.4||^7.0
- wundii/data-mapper: ^1.3.1
Requires (Dev)
- ext-dom: *
- ext-libxml: *
- nette/neon: ^v3.4
- phpstan/phpstan: ^2.0
- phpstan/phpstan-strict-rules: ^2.0
- phpunit/phpunit: ^11.4
- rector/rector: ^2.0
- symfony/var-dumper: ^7.0
- symfony/yaml: ^7.0
- symplify/easy-coding-standard: ^12.3
- wundii/phplint: ^0.3
README
A Symfony integration for wundii/data-mapper. This library is an extremely fast and strictly typed object mapper built for modern PHP (8.2+). It seamlessly transforms data from formats like JSON, NEON, XML, YAML, arrays, and standard objects into well-structured PHP objects.
Ideal for developers who need reliable and efficient data mapping without sacrificing code quality or modern best practices.
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
- Auto-casting for
float
types (eu to us decimal separator) - Target alias via Attribute for properties and methods
Supported Types
null
bool
|?bool
int
|?int
float
|?float
string
|?string
array
int[]
float[]
string[]
object[]
object
|?object
enum
|?enum
Supported Formats
optional formats are marked with an asterisk *
array
json
neon
*object
public property
public getters
method toArray()
attribute SourceData('...')
xml
yaml
*
Installation
Require the bundle and its dependencies with composer:
composer require wundii/data-mapper-symfony-bundle
Include the bundle in your bundles.php
:
return [ // ... Wundii\DataMapper\SymfonyBundle\DataMapperBundle::class => ['all' => true], ];
Create a Symfony configuration file config/packages/data_mapper.yaml
with the command:
bin/console data-mapper:default-config
Configuration File
The following setting options are available
data_mapper: data_config: approach: 'CONSTRUCTOR|PROPERTY|SETTER' # ApproachEnum::SETTER accessible: 'PRIVATE|PUBLIC' # AccessibleEnum::PUBLIC class_map: InterfaceOrClassName: 'ClassName', # Class mapping for interfaces or other classes ...: ...
Use as Symfony DataMapper version
<?php declare(strict_types=1); namespace App\Controller; use App\Dto\TestClass; use Symfony\Bundle\FrameworkBundle\Controller\AbstractController; use Symfony\Component\HttpFoundation\Request; use Symfony\Component\HttpFoundation\Response; use Symfony\Component\Routing\Attribute\Route; use Wundii\DataMapper\SymfonyBundle\DataMapper; final class YourController extends AbstractController { public function __construct( private readonly DataMapper $dataMapper, ) { } #[Route('/do-something/', name: 'app_do-something')] public function doSomething(Request $request): Response { // Automatic recognition of the format based on the content type of the request // returns an instance of TestClass or an Exception $testClass = $this->dataMapper->request($request, TestClass::class); // or you can use tryRequest to avoid exceptions, null will be returned instead $testClass = $this->dataMapper->tryRequest($request, TestClass::class); $this->dataMapper->getMapStatusEnum(); $this->dataMapper->getErrorMessage(); // Do something with $testClass return $this->json(...); } }
Use as native DataMapper version
<?php declare(strict_types=1); namespace App\Controller; use App\Dto\TestClass; use Symfony\Bundle\FrameworkBundle\Controller\AbstractController; use Symfony\Component\HttpFoundation\Request; use Symfony\Component\HttpFoundation\Response; use Symfony\Component\Routing\Attribute\Route; use Wundii\DataMapper\DataMapper; final class YourController extends AbstractController { public function __construct( private readonly DataMapper $dataMapper, ) { } #[Route('/do-something/', name: 'app_do-something')] public function doSomething(Request $request): Response { // you can use the native DataMapper methods directly $testClass = $this->dataMapper->json($request->getContent(), TestClass::class); // Do something with $testClass return $this->json(...); } }