PHP Enumerations, or "PHP enums" for short, is one of the most anticipated
new features of PHP 8.1 (released on November 25, 2021). Their most common use
case is to group several related values. In previous PHP versions you had to
define a series of related constants to achieve that. In PHP 8.1 you can do this:
PHP Enumerations are modeled as ADT (Algebraic Data Type) values, so they can
define methods, implement interfaces, define values, etc. In Symfony 5.4 we've
added support for PHP enums in different components.
PHP Enums Support in Symfony Forms
Contributed by
Alexander M. Turek
in #43095.
The Form component has added a new EnumType field so you can represent
PHP enums as a selection of values. Consider this example:
Use the new EnumType class to represent these PHP enums as form fields:
This is how the form will look like in Symfony 5.4:
PHP Enums Support in Symfony Serializer
Contributed by
Alexandre Daubois
in #40830.
PHP enums that define scalar values for their entries are called "backed enums".
When properties use that kind of PHP enum, the Symfony Serializer component
can normalize and denormalize those properties:
PHP Enums Support in other components
Alexandre Daubois also contributed other Pull Requests to add PHP enums
support in other Symfony components:
Pull Request #40857
added enums support when dumping the Dependency Injection container;
Pull Request #41072
added enums support to VarExporter component.
PHP Enumerations are fantastic and Symfony 5.4 will fully support them since day one.
Sponsor the Symfony project.