Simple enumeration system with Symfony integration

Installs: 66 119

Dependents: 0

Suggesters: 0

Security: 0

Stars: 11

Watchers: 5

Forks: 6

Open Issues: 4


v4.0.3 2022-03-28 12:21 UTC


Tests Coverage Contributors License

Latest Stable Version Latest Unstable Version Total Downloads Downloads Monthly

This repository aims to provide simple enumeration implementation to Symfony.


Add the bundle as a dependency with Composer

$ composer require yokai/enum-bundle

Enable the bundle in the kernel

return [
    Yokai\EnumBundle\YokaiEnumBundle::class => ['all' => true],

Getting started

Let's take an example : our application has some members and each member has a status which can be :

  • new, labelled as "New"
  • validated, labelled as "Validated"
  • disabled, labelled as "Disabled"

Creating the enum

We first need to create the class that will handle our enum :



namespace App\Enum;

use Yokai\EnumBundle\Enum;

class StatusEnum extends Enum
    public function __construct()
        parent::__construct(['New' => 'new', 'Validated' => 'validated', 'Disabled' => 'disabled']);

That's it, the bundle now knows your enum.

note : every enum has a name. That name is the enum identifier across your application. You can use any string for that purpose, as long it is unique. Using the enum class here is a very common way to do.

Configuring validation

We will now be able to configure Member's model validation :



namespace App\Model;

use App\Enum\StatusEnum;
use Yokai\EnumBundle\Validator\Constraints\Enum;

class Member
     #[Enum(enum: StatusEnum::class)]
    public ?string $status = null;

note both PHP Attributes & Annotations are supported :

     * @Enum(StatusEnum::class)
    public ?string $status = null;

Setting up the form

Now that validation is configured, the only thing we have to do is to add a field on our form :



namespace App\Form\Type;

use App\Model\Member;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class MemberType extends AbstractType
    public function buildForm(FormBuilderInterface $builder, array $options): void
            // Because we added the #[Enum] constraint to Member::$status property
            // the bundle will be able to find out the appropriate form type automatically

    public function configureOptions(OptionsResolver $resolver): void
        $resolver->setDefault('data_class', Member::class);

Rendering enum label

Display label of any enum value within a Twig template :

{{ member.status|enum_label('App\\Enum\\StatusEnum') }}

Translating your enum

Now, maybe you will need to display the enum label in different locales.

We got you covered here with a dedicated base class for your translated enums :



namespace App\Enum;

use Symfony\Contracts\Translation\TranslatorInterface;
use Yokai\EnumBundle\TranslatedEnum;

class StatusEnum extends TranslatedEnum
    public function __construct(TranslatorInterface $translator)
        parent::__construct(['new', 'validated', 'disabled'], $translator, 'status.%s');

Now you can create the translation keys in your catalog :

# translations/messages.en.yaml
status.new: New
status.validated: Validated
status.disabled: Disabled
# translations/messages.fr.yaml
status.new: Nouveau
status.validated: Validé
status.disabled: Désactivé

note : the translation key format is generated using the $transPattern constructor argument, which must be valid a sprintf pattern (containing one %s)

More examples

See examples from unit test suite & associated tests.

See example Symfony project in integration test suite.


MIT License

License can be found here.


The bundle was originally created by Yann Eugoné. See the list of contributors.

Thank's to PrestaConcept for supporting this bundle.