umanit/doctrine-singleton-bundle

Singleton entities working with Doctrine and Sonata

Doctrine Singleton Bundle

This bundle intends to easily create complex singleton entities (totally unique, or based on some properties). Sonata Admin friendly with automatic integration., _(*1)

Install

Register the bundle to your 'app/AppKernel.php', _(*2)

    new Umanit\DoctrineSingletonBundle\UmanitDoctrineSingletonBundle(),

That's it!, _(*3)

Usage

Tell that your entity is a singleton

Just need to implement the Umanit\DoctrineSingletonBundle\Model\SingletonInterface, _(*4)

<?php

namespace App\Entity\Content;

use Doctrine\ORM\Mapping as ORM;
use Umanit\DoctrineSingletonBundle\Model\SingletonInterface;

#[ORM\Table(name="page")]
class Page implements SingletonInterface 
{
}

Now, if you try to create 2 entities of type "Page", you'll get a NonUniqueException, _(*5)

More complex unicity

If you want to implement a more complex unicity, for example, you want the entity to be unique per local, you can subscribe to the FilterSingletonEvent::SINGLETON_FILTER_EVENT event to modify the filters (filters are used in a findBy() clause), _(*6)

e.g (from TranslationBundle), _(*7)

 <?php

namespace Umanit\TranslationBundle\EventSubscriber;

use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Umanit\DoctrineSingletonBundle\Event\FilterSingletonEvent;
use Umanit\TranslationBundle\Doctrine\Model\TranslatableInterface;

class SingletonSubscriber implements EventSubscriberInterface
{
    public static function getSubscribedEvents()
    {
        return [FilterSingletonEvent::SINGLETON_FILTER_EVENT => ['onFilterEvent']];
    }

    public function onFilterEvent(FilterSingletonEvent $event)
    {
        $entity  = $event->getEntity();
        $filters = $event->getFilters();

        if ($entity instanceof TranslatableInterface) {
            $filters['locale'] = $entity->getLocale();
        }

        $event->setFilters($filters);
    }
}

services.yml, _(*8)

 services:
    umanit_translation.event_subscriber.doctrine_singleton_filter:
        class: Umanit\TranslationBundle\EventSubscriber\SingletonSubscriber
        tags:
            - { name: kernel.event_subscriber } 

Get singleton

In order to get your singleton instances, you can use the provided helpers for your PHP code or twig :, _(*9)

<?php

$this->get('umanit_doctrine_singleton.helper')->getSingleton('App\Entity\Page::class');

{% set singleton = get_singleton('App\\Entity\\Page') %}

The method getSingleton($className, array $filters = [], $instantiateIfNotFound = false) can take from 1 to 3 arguments : - $className : FQCN of the class to get - $filters : Filters to apply to get the singleton (e.g. : getSingleton("MyClass", ["locale" => "en"])) - $instantiateIfNotFound : If the entity is not found, returns an empty entity instead of null, _(*10)

Integrating into SonataAdmin

The bundle will automatically remove add and list button from the list and the edit view., _(*11)

If you use the UmanitDoctrineSingletonBundle:Sonata\SingletonCRUD as a controller for your admin class, you'll have a redirection to create if there's no entity found, to edit if there's only one, and to list if you have more than one., _(*12)

e.g :, _(*13)

     app.admin.page:
         class: App\Admin\PageAdmin
         arguments: [~, App\Entity\Content\Page, UmanitDoctrineSingletonBundle:Sonata\SingletonCRUD ]
         tags:
             - { name: sonata.admin, manager_type: orm, group: 'Content', label: 'Page' }