Symfony表单提交报错：isEnabled方法参数不匹配求助

尝试使用Doctrine将简单表单数据保存至数据库，通过php bin/console make:entity生成的Brand实体含布尔属性is_enabled，代码未做修改：

#[ORM\Entity(repositoryClass: BrandRepository::class)]
class Brand
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
    private ?int $id = null;

    #[ORM\Column]
    private ?bool $is_enabled = null;

    public function getId(): ?int
    {
        return $this->id;
    }

    public function isEnabled(): ?bool
    {
        return $this->is_enabled;
    }

    public function setEnabled(bool $is_enabled): static
    {
        $this->is_enabled = $is_enabled;

        return $this;
    }
}

通过php bin/console make:crud生成BrandType表单类型：

class BrandType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('is_enabled', CheckboxType::class, [
                'required' => false,
                // 尝试过以下选项但无效：
                // 'empty_data' => false,
                // 'false_values' => [false],
                'value' => true
            ])
        ;
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => Brand::class,
        ]);
    }
}

表单处理逻辑如下：

#[Route('/brand')]
class BrandController extends AbstractController
{
    #[Route('/new', methods: ['GET', 'POST'])]
    public function new(Request $request, EntityManagerInterface $entityManager): Response
    {
        $brand = new Brand();
        $form = $this->createForm(BrandType::class, $brand);
        $form->handleRequest($request);

        if ($form->isSubmitted() && $form->isValid()) {
            $entityManager->persist($brand);
            $entityManager->flush();

            return $this->redirectToRoute('blah', [], Response::HTTP_SEE_OTHER);
        }

        return $this->render('brand/new.html.twig', [
            'brand' => $brand,
            'form' => $form,
        ]);
    }
}

提交表单时出现错误：

The method "isEnabled" in class "App\Entity\Catalog\Brand" requires 0 arguments, but should accept only 1.

异常指向$form->handleRequest($request);行。当前环境：PHP 8.3.6、Symfony 6.4.10，Doctrine包版本：

"doctrine/dbal": "^3",
"doctrine/doctrine-bundle": "^2.12",
"doctrine/doctrine-migrations-bundle": "^3.3",
"doctrine/orm": "^3.2",

解决方案 #

问题根源在于Symfony表单的字段名与实体的getter/setter方法不匹配：

• 实体中布尔属性is_enabled对应的getter是isEnabled()，setter是setEnabled()
• 表单中使用的字段名是is_enabled，Symfony表单会尝试按照命名规则调用setIsEnabled()方法，但实体中不存在该方法，反而错误地试图把值传给isEnabled()这个无参的getter方法，导致参数错误

解决方法有两种，任选其一即可：

方法1：修改表单字段名为enabled #

直接将BrandType中的字段名从is_enabled改为enabled，Symfony会自动映射到实体的isEnabled()和setEnabled()方法：

$builder
    ->add('enabled', CheckboxType::class, [
        'required' => false,
        'label' => 'Is Enabled' // 可手动设置表单显示的标签
    ])
;

方法2：显式指定属性路径 #

如果不想修改字段名，可以在表单字段选项中添加property_path，指定实体的属性对应的方法名：

$builder
    ->add('is_enabled', CheckboxType::class, [
        'required' => false,
        'property_path' => 'enabled' // 指向实体的enabled属性（对应isEnabled/setEnabled）
    ])
;

完成修改后，重新提交表单即可正常处理布尔值的保存。

内容的提问来源于stack exchange，提问作者amiry jd