Translation bundle to help with rendering pretty names for enum-like classes.

Installs: 84 455

Dependents: 0

Suggesters: 0

Security: 0

Stars: 5

Watchers: 7

Forks: 7

Open Issues: 1


1.0.8 2022-05-04 13:38 UTC

This package is auto-updated.

Last update: 2024-04-04 17:50:34 UTC


This bundle allows the automation of translating an enum value to a human readable string, for example, displaying a status text instead of the enum-value of a status code.

In it's essence, it allows to map a value to a translation within the domain that is the class name. What this means in practice is that you can use it as follows:

$status_text = $translator->trans(SetupStatus::DONE, [], SetupStatus::class);

Or in a twig template:

{{ constant('AppBundle\\Entity\\SetupStatus::DONE') | trans([], 'AppBundle\\Entity\\SetupStatus') }}


The entity translation bundle requires at least php 7.3 and the symfony translation component. For specific requirements, please check composer.json


Installing is pretty straightforward, this package is available on packagist.


$ composer require hostnet/entity-translation-bundle

Register The Bundle in your AppKernel

This bundle makes use of the translator which is registered by the framework bundle. So make sure you register this bundle after the FrameworkBundle.

class AppKernel extends Kernel
    public function registerBundles()
        $bundles = [
            // ...
            new AppBundle\AppBundle(),
            new Hostnet\Bundle\EntityTranslationBundle\HostnetEntityTranslationBundle(),
            // ...

        return $bundles;


Simply add an enum.en.yml to the translations folder in the Resources folder of one of your bundles. This will contain the translations for a given enum. The translation keys are the fully qualified namespaces in lowercase and an _ between CamelCase words. So for instance the enum AppBundle\Entity\SetupStatus would become app_bundle.entity.setup_status.

Consider the following class:

namespace AppBundle\Entity;

final class SetupStatus
    const PENDING           = 1;
    const DONE              = 2;
    const ERROR             = 3;
    const REVERTING_CHANGES = 4;

Your AppBundle/Resources/translations/enum.en.yml could look as followed:

            pending           : Installation Pending.
            done              : Installation Complete.
            error             : An error occured.
            reverting_changes : Reverting changes.

The translator will then pick up all enum classes defined in your translation file.