2017 © Pedro Peláez
 

symfony-bundle doctrine-entity-data-mapper-bundle

Makes it easy to map data coming from client-side onto your Doctrine ORM managed entities.

image

sergeil/doctrine-entity-data-mapper-bundle

Makes it easy to map data coming from client-side onto your Doctrine ORM managed entities.

  • Saturday, December 31, 2016
  • by sergeil
  • Repository
  • 2 Watchers
  • 1 Stars
  • 61 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 0 Forks
  • 1 Open issues
  • 1 Versions
  • 0 % Grown

The README.md

SliDoctrineEntityDataMapperBundle Build Status

Bundle provides tools that simplify mapping data coming from client-side onto Doctrine ORM managed entities., (*1)

Features: * All basic scalar types mapping (boolean, numbers ...) * All types of associations are supported (+bidirectional aspect of relations is taken care of out of the box) * Complex data types transformation and mapping - when a value before being mapped onto an entity is transformed * Additional DI services injection to a setter method when a value is mapped * Flexible mapping of date/datetimes, (*2)

Teaser with ManyToMany relation

For an illustration purpose let's take a classical example of User and Group entities and assume that they are bidirectionally linked to each other., (*3)

User and Group, (*4)

Now, let's take a look at several sample array data-structures that you may pass to EntityDataMapperService and have it properly mapped data onto your entity. For the illustration purpose we assume that we have two users - "Jane Doe" and "John Doe" with corresponding IDs of 1 and 2, and three groups: "Admins", "Users", "Moderators" with IDs 1, 2, 3., (*5)

$em = $container->get('doctrine.orm.entity_manager');
$mapper = $container->get('sli_doctrine_entity_data_mapper.mapping.entity_data_mapper');

$adminsGroup = $em->find('MyBundle:Group', 1);
$usersGroup = $em->find('MyBundle:Group', 2);
$moderatorsGroup = $em->find('MyBundle:Group', 3);

$john = new User('John Doe');
$jane = new User('Jane Doe');

$userParams = array(
    'groups' => [1, 2]
);

$mapper->mapEntity($john, $userParams, array_keys($userParams));

$em->persist($john);
$em->persist($jane);
$em->flush();

echo count($john->groups); // two elements, groups "Admins" and "Users" were fetched from database by their IDs
echo count($adminGroup->users); // one element
echo count($usersGroup->users); // one element
echo count($moderatorsGroup->users); // zero elements

Now let's presume that during next request we want that $john user would belong only to "Moderators" group:, (*6)

$userParams = array(
    'groups' => [3]
);

$mapper->mapEntity($john, $userParams, array_keys($userParams));

Several things just happened: * "Admins" and "Users" group were removed from User's side Collection * "John Doe" was removed from "Admins" and "Users" Group's Collections * "John Doe" was added to "Moderators" group * "Moderators" group was added to John Doe's groups collection, (*7)

Installation

Add this dependency to your composer.json:, (*8)

"sergeil/doctrine-entity-data-mapper-bundle": "dev-develop"

Update your AppKernel class and add this:, (*9)

new Sli\DoctrineEntityDataMapperBundle\SliDoctrineEntityDataMapperBundle(),

Documentation

See Resources/doc/index.md., (*10)

Licensing

This bundle is under the MIT license. See the complete license in the bundle: Resources/meta/LICENSE, (*11)

The Versions

31/12 2016