Download the PHP package yethee/enum-bundle without Composer

BiplaneEnumBundle

This bundle provides a typed enumeration for your Symfony2 project.

Note: For Symfony 2.0.x, you need to use the 1.0.0 release of the bundle.

Note: For Symfony less than 2.7, you need to use the 1.2.0 release of the bundle.

Features

• Provides base implementation for enum type.
• Provides base implementation for flags enum type (treated as a bit field, that is a set of flags).
• Uses enum types with Symfony's Form Component.
• Contains normalizer for Symfony's Serializer Component.
• Contains the custom handler for JMSSerializerBundle.

Installation

Add this bundle to your project

Install the bundle by running in a shell:

Add the bundle to your application kernel

Usage

In order to create a typed enumeration, it's enough to extend the base class Biplane\EnumBundle\Enumeration\Enum

• define constants and implement getPossibleValues() and getReadables() methods. The first method should return an array of possible values of your enumeration, the second method returns a hash list of possible values and their human representations.

Below you can see a simple implementation of enumeration for user roles:

You can create a new instance of the enumeration via the create() factory method, which provides the base class:

$role = UserRoles::create(UserRoles::ADMIN);

If the argument contains an invalid value, an exception of Biplane\EnumBundle\Exception\InvalidEnumArgumentException type will be thrown.

The following code example shows how to get the raw value or the human representation of the enumeration value from the object:

$role->getValue(); // returns string 'ROLE_ADMIN'
$role->getReadable(); // returns string 'Admin'

You can also convert the object to a string to obtain the human representation of the enumeration value:

(string)$role;

Bit flags support

You can extend Biplane\EnumBundle\Enumeration\FlaggedEnum for an enumeration, if a bitwise operation is to be performed on a numeric value.

In this case define enumeration constants in powers of two, that is, 1, 2, 4, 8, and so on. This means the individual flags in combined enumeration constants do not overlap. Also you can create an enumerated constant for commonly used flag combinations, but the values of these constants must not be returned by getPossibleValues() method.

Below you can see the implementation of flags enumeration for permissions list:

You can use a bitwise operation on constants for creating a new instance of the enumeration:

$permissions = Permissions::create(Permissions::READ | Permissions::WRITE);

This type of enumeration provides some additional methods:

• getFlags() returns an array of bit flags of enumeration value. For the previous example this method returns array(1, 2).

• hasFlag() returns true if specified flag is set in an numeric value.

Using with Doctrine ORM

You can store a raw value of the enum in the entity, and use casting type in getter and setter:

Or you can create a custom type of DBAL for move the logic of casting type from the entity:

NOTE: You should manually convert the raw value to the valid type for your enumeration, before creating a new instance of the enumeration in convertToPHPValue method. Because into this method always passed the value as string (or null).

After that you should register your type, this can be done through config:

Set your type in the mapping of the entity:

JMSSerializerBundle support

This bundle provides a custom handler for the serializer to allow serialize the Enum object as scalar value to json or xml format. The custom handler uses only for those typed enumerations that are specified in the configuration.

You can to register your typed enumerations through config: