rezzza/doctrine-schema-multi-mapping

Allow to use doctrine schema commands when multi mapping defined.

Doctrine Schema Multi Mapping

Installation on Symfony.

Activate the bundle in AppKernel:, _(*1)

    if (in_array($this->getEnvironment(), array('test'))) {
        $bundles[] = new Rezzza\DoctrineSchemaMultiMapping\App\Bundle\DoctrineSchemaMultiMappingBundle();
    }

Usage

./app/console rezzza:doctrine-multi-mapping:schema:create --em=default  --env=test
./app/console rezzza:doctrine-multi-mapping:schema:update --em=default  --env=test
./app/console rezzza:doctrine-multi-mapping:schema:drop --em=default  --env=test

You should consider this bundle has not to be used in a production environment., _(*2)

Why are we using it ?

In Doctrine2, if you define multiple mappings for the same entity then doctrine:schema:* commands will fail because it will try to create 2 SQL tables with the same name instead of combining all entities mappings representing the same entity from various points of view., _(*3)

Example: Acme e-commerce application with many User entities

We want to express a User model in different bounded contexts., _(*4)

Definition of User entity in Account bounded context

We have a \Acme\User\Account\User.php entity., _(*5)

In this bounded context, we need to manage User authentication & signin so a (simple) mapping could be:, _(*6)

    - id
    - username
    - password
    - first_name
    - last_name

Definition of User entity Cart bounded context

We have a \Acme\User\Cart\User.php entity., _(*7)

In this bounded context, we don't have to bother with autentication concerns, we just need to know user's e-commerce relative informations., _(*8)

    - id
    - first_name
    - last_name
    - is_first_order

This kind of application in your production environment could work with a shared database and you would have to manually define migrations, _(*9)

With this example, Doctrine will have 2 times a definition for table user and will throw an exception., _(*10)

This library merge the 2 entities mappings ONLY for doctrine:schema:* commands., _(*11)

This bundle provide by this way 3 commands, to replace doctrine:schema:* command, you have to replace namespace by rezzza:doctrine-multi-mapping:schema:*., _(*12)

Which doctrine mapping features are not supported?

At the moment, only inheritance type “none“ and “single_table“ are supported, feel free to make a PR to support others., _(*13)