divineomega/uxdm-doctrine

Doctrine package for the UXDM data migrator

v1.0.1 2019-04-30 15:42 UTC

Requires

• divineomega/uxdm: ^3.0.0
• doctrine/orm: ^2.5
• symfony/property-access: ^3.4

Requires (Dev)

• fzaninotto/faker: ^1.6
• php-coveralls/php-coveralls: ^2.0
• phpunit/phpunit: ^7.0||^8.0

LGPL-3.0-only

• Jordan Hall

README

The UXDM Doctrine package provides a UXDM destination for the Doctrine ORM, commonly used in Symfony projects.

Doctrine Destination

The UXDM Doctrine destination allows you to migrate data into an Doctrine entity. This can be handy if you need to migrate data into a system using the Doctrine ORM, such as a Symfony project.

Creating

To create a new Doctrine destination, you must provide it with your Doctrine ORM EntityManager instance, and the class name of the Doctrine entity you wish to use.

The following example creates a Doctrine destination object, using a Doctrine entity called User. It is assumed that your $entityManager has already been created elsewhere.

$doctrineDestination = new DoctrineDestination($entityManager, User::class);

Assigning to migrator

To use the Doctrine destination as part of a UXDM migration, you must assign it to the migrator. This process is the same for most destinations.

$migrator = new Migrator;
$migrator->setDestination($doctrineDestination);

Alternatively, you can add multiple destinations, as shown below. You can also specify the fields you wish to send to each destination by passing an array of field names as the second parameter.

$migrator = new Migrator;
$migrator->addDestination($doctrineDestination, ['field1', 'field2']);
$migrator->addDestination($otherDestination, ['field3', 'field2']);