xsolve-pl/model-factory-bundle

This bundle provides a versatile skeleton for organizing model factories.

, _(*1)

Table of contents

• Introduction
• License
• Getting started
• Usage examples
  • Grouping model factories into collections

Introduction

This bundle wraps xsolve-pl/model-factory library and allows to compose collections of model factories declared as services with the use of tags., _(*2)

See the library documentation for more details on specific use cases., _(*3)

License

This bundle is under the MIT license. See the complete license in LICENSE file., _(*4)

Getting started

Include this bundle in your Symfony project using Composer as follows (assuming it is installed globally):, _(*5)

$ composer require xsolve-pl/model-factory-bundle

For more information on Composer see its Introduction., _(*6)

Afterwards you need to enable this bundle by adding a line to app/AppKernel.php file of your project:, _(*7)

<container xmlns="http://symfony.com/schema/dic/services"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">

    <services>

        <service id="example.model_factory_collection.first"
                 class="Xsolve\ModelFactoryBundle\ModelFactoryCollection\ModelFactoryCollection"
        />

        <service id="example.model_factory_collection.second"
                 class="Xsolve\ModelFactoryBundle\ModelFactoryCollection\ModelFactoryCollection"
        />

        <service id="example.model_factory.foo"
                 class="Example\FooModelFactory"
        >
            <tag name="xsolve.model_factory_bundle.model_factory"
                 model-factory-collection-id="example.model_factory_collection.first"
            />
            <tag name="xsolve.model_factory_bundle.model_factory"
                 model-factory-collection-id="example.model_factory_collection.second"
            />
        </service>

    </services>

</container>

This snippet defines two model factory collections (with ids example.model_factory_collection.first and example.model_factory_collection.second respectively). It also defines a single model factory (with id example.model_factory.foo). This service has a tag assigned with name attribute equal xsolve.model_factory_bundle.model_factory (which will result in it being processed by Xsolve\ModelFactoryBundle\DependencyInjection\CompilerPass\ModelFactoryCollectionCompilerPass) and model-factory-collection-id attribute containing service ids of respective collections., _(*8)