README

此模块为 Laminas 提供了 Doctrine 固定的命令行支持。通常项目会有多组针对不同对象管理器或模块的固定，例如来自第三方 API 的模块。在这种情况下，需要一个可以按组运行固定的工具。此外，固定必须可用依赖注入。为了满足这些需求，此模块使用可按组配置的服务管理器。

版本

6.x 版本支持 PHP 7.2 及以上。

安装

此模块使用 composer 进行安装。有关 composer 文档，请参阅 getcomposer.org。

$ composer require api-skeletons/doctrine-data-fixture

将此模块添加到应用程序配置中

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

laminas-component-installer

如果您使用 laminas-component-installer，则该插件将帮助您将 doctrine-data-fixture 作为模块进行安装。

配置

此模块基于 Doctrine 配置。实现固定的模块中的配置如下

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

每个组都是一个 Laminas ServiceManager 配置。这允许完全控制您的固定的依赖注入。

'executor' 和 'purger' 键是可选的，允许为这些功能自定义类。如果省略，将使用 Doctrine ORM 类。

列出固定

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

列出所有对象管理器和它们的组，列出给定对象管理器的所有组，或指定对象管理器和组以列出组的所有固定。

从命令行执行固定

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

<group> 是必需的。

追加是默认选项。这可以通过 --do-not-append 反转

选项

--purge-with-truncate 如果指定，将在运行固定之前清除对象管理器的表。

--do-not-append 将在运行固定之前删除数据库中的所有数据。

从代码执行固定

对于单元测试或其他必须从代码中运行固定的情况，您必须使用 build 获取 DataFixtureManager，然后将组名传递给服务管理器，然后手动将固定加载到 Loader 中。

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

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

$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);

获取帮助

index.php data-fixture:help

重要提示

• 您一次只能从命令行运行一个组。如果您需要运行多个，请创建一个脚本来按顺序运行它们。
• ServiceManager 注入到每个 DataFixtureManager 的 getServiceLocator() 中，因此您可以使用从该级别运行的实例化器。这使得 DataFixtureManager 的工作方式类似于使用 $serviceListener->addServiceManager() 定义的插件管理器。
• 您不能使用抽象工厂。每个固定必须单独配置。