api-skeletons/zf-doctrine-data-fixture

Doctrine Data Fixture Console Route with Service Manager configured Fixtures

Saturday, July 7, 2018
by tom_anderson
Repository
1 Watchers
8 Stars
3,223 Installations

PHP
2 Dependents
1 Suggesters
68 Forks
1 Open issues
34 Versions
18 % Grown

The README.md

ZF Doctrine Data Fixture

, _(*1)

This provides command line support for Doctrine Fixtures in Zend Framework 2. Often projects will have multiple sets of fixtures for different object managers or modules such as from a 3rd party API. When this is the case a tool which can run fixtures in groups is needed. Additionally dependency injection must be available to the fixtures. To accomplish these needs this module uses a Zend Service Manager configurable on a per-group basis., _(*2)

Releases

The 4.x release tags support PHP 5.6 and 7.0., _(*3)

The 5.x release tags support PHP 7.1 and above., _(*4)

Installation

Installation of this module uses composer. For composer documentation, please refer to getcomposer.org., _(*5)

$ composer require api-skeletons/zf-doctrine-data-fixture ^2.0

Add this module to your application's configuration:, _(*6)

'modules' => [
   ...
   'ZF\Doctrine\DataFixture',
],

zf-component-installer

If you use zf-component-installer, that plugin will install zf-doctrine-data-fixture as a module for you., _(*7)

Configuration

This module builds on top of Doctrine configuration. The configuration in a module which implements fixtures is:, _(*8)

return [
    'doctrine' => [
        'fixture' => [
            'group1' => [
                'object_manager' => 'doctrine.entitymanager.orm_default',
                'invokables' => [
                    'ModuleName\Fixture\FixtureOne' => 'ModuleName\Fixture\FixtureOne',
                ],
                'factories' => [
                    'ModuleName\Fixture\FixtureTwo' => 'ModuleName\Fixture\FixtureTwoFactory',
                ]
            ],
            'group2' => [
                'object_manager' => 'doctrine.entitymanager.orm_zf_doctrine_audit',
                ...
            ],
        ],
    ],
];

Each group is a Zend ServiceManager configuration. This allows complete dependency injection control of your fixtures., _(*9)

Listing Fixtures

index.php data-fixture:list [<group>]

List all object managers and their groups, list all groups for a given object manager, or specify object manager and group to list all fixtures for a group., _(*10)

Executing Fixtures from Command Line

index.php data-fixture:import <group> [--purge-with-truncate] [--do-not-append]

The <group> is required., _(*11)

The default was to not append and this was constantly overridden with --append. Append is now to the default option. This is inversed with the new --do-not-append, _(*12)

Options:, _(*13)

--purge-with-truncate if specified will purge the object manager's tables before running fixtures., _(*14)

--do-not-append will delete all data in the database before running fixtures., _(*15)

Executing Fixtures from Code

For unit testing or other times you must run your fixtures from within code you must fetch the DataFixtureManager with build and pass the group name to the service manager then load the fixtures into the Loader manually., _(*16)

use Doctrine\Common\DataFixtures\Executor\ORMExecutor;
use Doctrine\Common\DataFixtures\Purger\ORMPurger;
use ZF\Doctrine\DataFixture\Loader;

// Run audit fixtures
$dataFixtureManager = $application->getServiceManager()
    ->build('ZF\Doctrine\DataFixture\DataFixtureManager', ['group' => 'zf-doctrine-audit']);

$loader = new Loader($dataFixtureManager);
$purger = new ORMPurger();
$executor = new ORMExecutor($auditEntityManager, $purger);

foreach ($dataFixtureManager->getAll() as $fixture) {
    $loader->addFixture($fixture);
}

$executor->execute($loader->getFixtures(), true);

Getting Help

index.php data-fixture:help

Important Notes

You can only run one group at a time from the command line. If you need to run more create a script to run them in sequence.
The ServiceManager is injected into each DataFixtureManager at getServiceLocator() so you can use instantiators which run from that level. This makes the DataFixtureManager work like a plugin manager defined with $serviceListener->addServiceManager().
You cannot use abstract factories. Each fixture must be individually configured.

History

Version 1.0 of this module grouped groups by partial object manager alias. This limited grouping of 3rd party fixtures and the flexibility of using ODM., _(*17)

This module is a near complete rewrite of hounddog/doctrine-data-fixture-module. All the patterns have changed and the code was reduced. That module served me and the community well for a long time., _(*18)

The Versions

07/07 2018

dev-master

9999999-dev https://apiskeletons.com

Doctrine Data Fixture Console Route with Service Manager configured Fixtures

library zf-doctrine-data-fixture

Doctrine Data Fixture Console Route with Service Manager configured Fixtures

api-skeletons/zf-doctrine-data-fixture

The README.md

ZF Doctrine Data Fixture

Releases

Installation

zf-component-installer

Configuration

Listing Fixtures

Executing Fixtures from Command Line

Executing Fixtures from Code

Getting Help

Important Notes

History

The Versions

dev-master

The Requires

The Development Requires

by Tom Anderson

by Martin Shwalbe

5.0.8

The Requires

The Development Requires

by Tom Anderson

by Martin Shwalbe

5.0.7

The Requires

The Development Requires

by Tom Anderson

by Martin Shwalbe

5.0.6

The Requires

The Development Requires

by Tom Anderson

by Martin Shwalbe

5.0.5

The Requires

The Development Requires

by Tom Anderson

by Martin Shwalbe

5.0.4

The Requires

The Development Requires

by Tom Anderson

by Martin Shwalbe

5.0.3

The Requires

The Development Requires

by Tom Anderson

by Martin Shwalbe

5.0.2

The Requires

The Development Requires

by Tom Anderson

by Martin Shwalbe

5.0.1

The Requires

The Development Requires

by Tom Anderson

by Martin Shwalbe

dev-php56

The Requires

The Development Requires

by Tom Anderson

by Martin Shwalbe

4.0.3

The Requires

The Development Requires

by Tom Anderson

by Martin Shwalbe

5.0.0

The Requires

The Development Requires

by Tom Anderson

by Martin Shwalbe

4.0.2

The Requires

The Development Requires

by Tom Anderson