ojezu / configurable-discrimination-bundle
Symfony2 bundle that allows configuring Doctrine discrimination maps in children bundles.
Installs: 7 722
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 1
Open Issues: 1
Requires
- doctrine/orm: ^2.5
- symfony/config: ^3.0 || ^2.7
- symfony/dependency-injection: ^3.0 || ^2.7
- symfony/http-kernel: ^3.0 || ^2.7
Requires (Dev)
README
This Bundle solves Doctrine problem with inheritance: discriminatorMap has to be declared on parent entity, and has to have all children declared in it. If you leave it empty, Doctrine will scan ALL files to look for classes that extend the parent class, and will auto-generate entries for them in discriminatorMap along with discriminator values - over which programmer in that case has absolutely no control - they will be derived from name of child class and that's it.
That is especially nasty, if some of the children classes are in other bundles, programmer has to make the parent bundle aware of all the child classes!
This Bundle allows specifying discriminator values and children classes in child bundle configuration - making the code of parent bundle clear of any references to children bundles, avoids scanning all class files in search of children classes and allows specifying custom discriminator values.
Installation
composer require ojezu/configurable-discrimination-bundle
Usage
Register this bundle in app/appKernel.php:
class AppKernel extends Kernel { public function registerBundles() { $bundles = array( new OJezu\ConfigurableDiscriminationBundle\ConfigurableDiscriminationBundle(), // app bundles new Acme\TestBundle\ParentBundle(), new Acme\TestBundle\ChildABundle(), new Acme\TestBundle\ChildBBundle(), ); return $bundles; } }
In ParentBundle:
You have to declare non-empty discriminatorMap or otherwise Doctrine will try to auto-generate it. OJezu/ConfigurableDiscriminationBundle will only add entries to it.
#Acme/AcmeParent/Entity/AcmeParent.php /** * (...) * @ORM\DiscriminatorMap({"base" = "AcmeParent"}) */ class AcmeParent { (...) }
In ChildABundle:
Add some faux-services tagged with ojezu.configurable_discrimination
to your
bundle internal config so that OJezu/ConfigurableDiscriminationBundle can read
your custom configuration.
Name of the service does not matter.
# service.yml services: acme.acme_entity.acme_child_a: class: 'Acme\AcmeChildA\Entity\AcmeChildA' public: false tags: - name: ojezu.configurable_discrimination discriminator_value: 'acme_child_a'
Acme\AcmeChildA\Entity\AcmeChildA
of course must be defined, and directly
extend Acme\AcmeParent\Entity\AcmeParent
In ChildBBundle:
# service.yml services: acme.acme_entity.acme_child_b: class: 'Acme\AcmeChildB\Entity\AcmeChildB' public: false tags: - name: ojezu.configurable_discrimination discriminator_value: 'acme_child_b'
Acknowledgments
Thanks to https://github.com/sredni who helped me to get into Symfony and did some code reviewing of this package.
This package is somewhat based on DCSDynamicDiscriminatorMapBundle and on Defining Discriminator Maps at Child-level in Doctrine 2
License
MIT