New in Symfony 6.2: Improved Enum Support

Symfony introduced PHP enums support in Symfony 5.4, which was released on November 2021. In Symfony 6.2 we continued adding Enums supports in different parts of the code.

Enums as Service Parameters

Contributed by
Aleksey Polyvanyi
in #48045.

In addition to holding service objects, the container also holds configuration, called service parameters. They support all kinds of PHP types (integers, booleans, arrays, strings, constants, etc.) In Symfony 6.2, when using PHP to configure services, you can include Enum values in these parameters:

// config/services.php
namespace Symfony\Component\DependencyInjection\Loader\Configurator;

use App\Entity\BlogPost;

return static function (ContainerConfigurator $container) {
    $container->parameters()
        // ...

        ->set('app.some_parameter', SomeEnum::Foo)
        ->set('app.another_parameter', [SomeEnum::Foo, SomeEnum::Bar]);
};

Enums in YAML Files

Contributed by
Nicolas Grekas
in #46771.

The previous feature only works when defining services in PHP. That's why in Symfony 6.2 we've also added support to reference PHP Enums in YAML files using the special prefix !php/enum.

The previous example looks as follows when using YAML:

# config/services.yaml
parameters:
    # ...
    app.some_parameter:    !php/enum SomeEnum::Foo
    app.another_parameter: [!php/enum SomeEnum::Foo, !php/enum SomeEnum::Bar]

Enums in Environment Variables

Contributed by
Jack Worman
in #46564.

The environment variable processors provided by Symfony transform the env var values (which can only be strings) into other kinds of values needed by your application (booleans, PHP constants, JSON documents, etc.)

In Symfony 6.2 we're adding a new env(enum:...) processor to turn env vars into PHP BackedEnum types. Imagine that you have this enum defined in your project:

# src/Enum/AppEnvironment.php
enum AppEnvironment: string {
   case Dev = 'dev';
   case Prod = 'prod';
   case Stage = 'stage';
   case Test = 'test';
}

In your YAML, XML or PHP configuration, you can now use something like this:

# config/services.yaml
parameters:
    app.some_parameter: '%env(enum:App\Enum\AppEnvironment:APP_ENV)%'

The value stored in the APP_ENV env var would be a string like 'Dev' but the application will use the AppEnvironment::Dev enum value.

            <hr style="margin-bottom: 5px" />
            <div style="font-size: 90%">
                <a href="https://symfony.com/sponsor">Sponsor</a> the Symfony project.
            </div>

https://symfony.com/blog/new-in-symfony-6-2-improved-enum-support?utm_source=Symfony%20Blog%20Feed&utm_medium=feed

Created 3y | Nov 16, 2022, 4:20:40 PM


Login to add comment

Other posts in this group

SymfonyOnline June 2025: Speakers, Stats & Replays!

Thank you for joining us at SymfonyOnline June 2025!

What a great edition of SymfonyOnline we’ve just wrapped up! 🎉

We were thrilled to welcome 300 participants from 35 different countries—a

Jun 18, 2025, 8:50:17 AM | Symfony
A Week of Symfony #963 (June 9–15, 2025)

This week, Symfony celebrated the SymfonyOnline June 2025 conference with great success. Meanwhile, development efforts focused on improving invokable commands for the upcoming Symfony 7.4 version. Th

Jun 15, 2025, 9:10:09 AM | Symfony
A Week of Symfony #962 (June 2–8, 2025)

This week, development activity focused on the upcoming Symfony 7.4 and 8.0 versions, which will deprecate and remove many features. In addition, we published a case study about Yousign. Finally, we'r

Jun 8, 2025, 7:50:05 AM | Symfony
Case study - Yousign: Scaling Trust with Smart, Scalable Architecture

As digital signatures become the norm in modern business, Yousign has established itself as a trusted leader across Europe. Behind its simple, intuitive interface is a powerful technical engine, handl

Jun 6, 2025, 7:10:24 AM | Symfony
SymfonyOnline June 2025 starts next week!

Get ready for the exciting SymfonyOnline June 2025, kicking off in a few days only! There’s still time to register and join the international online Symfony conference—along with pre-conferenc

Jun 5, 2025, 10:20:09 AM | Symfony
A Week of Symfony #961 (May 26 – June 1, 2025)

This week, Symfony released the stable version of Symfony 7.3, which includes lots of amazing new features. We also published the maintenance versions 6.4.22 and 7.2.7.

Symfony development highlights

Jun 1, 2025, 8:50:16 AM | Symfony
New in Symfony 7.3: DX Improvements (part 2)

This is the second part of the blog post showcasing the main DX (developer experience) features introduced in Symfony 7.3. Read the first part of this blog post.

Verify URI Signatures… https://symfon

May 29, 2025, 9:10:19 AM | Symfony