Serialization issues in 4.2.17

[kralmichal]

API Platform version(s) affected: 4.2.17

Description
When uprading from 4.2.16 Enum is no longer serialzed th same. See $locale

enum Locale: string
{
    case CS = 'cs';
    case EN = 'en';
}

#[Groups(['user:read', 'api:read', 'log:context']), ]
final readonly class UserSummaryView
{
    /**
     * @param (value-of<UserRole>)[] $roles
     */
    public function __construct(
        public UuidInterface $id,
        public string $name,
        public Locale $locale,
    ) {
    }
}

4.2.16

{
    "@context": "\/api\/contexts\/UserSummaryView",
    "@id": "\/api\/v1\/users\/me",
    "@type": "UserSummaryView",
    "id": "019bf62e-9883-70ae-b4e4-b75a7a568ea5",
    "name": "michal3",
    "locale": "cs",
}

4.2.17

{
    "@context": "\/api\/contexts\/UserSummaryView",
    "@id": "\/api\/v1\/users\/me",
    "@type": "UserSummaryView",
    "id": "019bf62e-9883-70ae-b4e4-b75a7a568ea5",
    "name": "michal3",
    "locale": {
        "@type": "Locale",
        "@id": "\/api\/.well-known\/genid\/b5b354de979217933bf9"
    },
}

[soyuka]

#7779 is in cause. It should work if your enum is a resource though, I'll work on a patch.

[kralmichal]

@soyuka Thanks

[jeandanyel]

I can confirm this still happens on API Platform 4.2.17 when a DTO contains an array of PHP backed enums.

Reproduction

DTO output (constructor typing):

/**
 * @param list<OrderStatus> $statuses
 */
final readonly class OrderSummaryOutput
{
    public function __construct(
        public string $id,
        public array $statuses = [],
    ) {}
}

Where OrderStatus is a PHP 8.1+ backed enum (e.g. enum OrderStatus: string { ... }).

Expected

Enums should be normalized as their backed values, e.g.:

"statuses": ["PENDING", "SHIPPED"]

Actual

API Platform normalizes the enum values as objects/resources (JSON-LD-ish), e.g.:

"statuses": [
  {
    "@type": "OrderStatus",
    "@id": "/api/.well-known/genid/054e233768e67244fb6b",
    "name": "Pending",
    "value": "PENDING"
  }
]

This also impacts client generation (e.g. Orval), because the schema is no longer an enum string array.

Thanks.

[soyuka]

It is fixed by 2e0b8ff will be released friday.

[azriel49]

It is fixed by 2e0b8ff will be released friday.

Merci pour ce fix 🙏

[fcharrier-okwind]

Thanks a lot!

[soyuka]

4.2.18 could you update and let me know if serialization issues are fixed? ping @daFish I think your issue was related if not let me know