如何配置Sonata Admin表单处理User表JSON列的Enum类型？

实体的roles字段是数组类型（对应数据库JSON存储），但当前Sonata Admin表单使用EnumType默认返回单个UserRole枚举实例，与字段期望的数组类型不匹配，导致保存时触发类型错误。

根据业务需求选择以下两种方案：

方案1：支持多角色选择（推荐，符合RBAC常规设计） #

1. 修改表单配置，开启多选 #

protected function configureFormFields(FormMapper $form): void
{
    $form->add('roles', EnumType::class, [
        'class' => UserRole::class,
        'multiple' => true, // 允许选择多个角色
        'expanded' => true, // 用复选框展示，提升操作体验
        'required' => true,
    ]);
}

2. 调整实体的角色处理方法 #

确保枚举与数据库存储的字符串数组互相转换：

use App\UserModule\Entity\Enum\UserRole;

class User
{
    // ... 其他属性和方法

    public function getRoles(): array
    {
        // 将数据库存储的字符串数组转换为枚举数组，供表单回显
        return array_map(fn(string $role) => UserRole::from($role), $this->roles);
    }

    public function setRoles(array $roles): self
    {
        // 将枚举数组转换为字符串数组，存储到数据库
        $this->roles = array_map(fn(UserRole $role) => $role->value, $roles);
        return $this;
    }
}

方案2：仅支持单角色选择 #

如果业务只允许单个角色，通过数据转换器将单个枚举包装为数组：

use Symfony\Component\Form\CallbackTransformer;

protected function configureFormFields(FormMapper $form): void
{
    $roleField = $form->add('roles', EnumType::class, [
        'class' => UserRole::class,
        'required' => true,
    ])->get('roles');

    // 添加数据转换器，实现单个枚举与数组的互转
    $roleField->addModelTransformer(new CallbackTransformer(
        // 实体→表单：从数组中取出第一个枚举（默认值可根据业务调整）
        fn(array $roles) => $roles[0] ?? UserRole::DEFAULT,
        // 表单→实体：将单个枚举转换为数组
        fn(UserRole $role) => [$role->value]
    ));
}

修改后重新通过Sonata Admin保存用户，即可避免类型不匹配错误。控制台命令不受影响，因为原本已正确处理数组类型。

内容的提问来源于stack exchange，提问作者daddits Donovskiy