如何在Symfony子表单中仅设置单个字段为必填项？

问题背景 #

父表单引入子表单后，希望子表单仅boo字段为必填，其余字段可选，但按以下方式配置后，子表单所有字段均为可选：

原父表单代码 #

// Parent form
public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder
        ->add('foo')
        ->add('bar', ChildFormType::class, [
            'inherit_data' => true
        ])
    ;
}

原子表单代码 #

// Child form
public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder
        ->add('baz')
        ->add('boo', null, ['required' => true])
    ;
}

public function configureOptions(OptionsResolver $resolver)
{
    $resolver->setDefaults([
        'required' => false,
    ]);
}

直接移除子表单的configureOptions并给每个非必填字段手动加['required' => false]虽然可行，但字段多的时候过于繁琐，且逻辑为反向配置，不够直观。

原因分析 #

子表单的全局required选项设为false时，会覆盖单个字段的required设置——Symfony表单的全局required选项优先级高于字段级配置，导致给boo设置的required: true不生效。

简洁解决方案 #

方案1：子表单内设置字段默认规则 #

在子表单的buildForm方法中，先给所有字段设置默认的required: false，再单独将boo字段设为必填：

// Child form
public function buildForm(FormBuilderInterface $builder, array $options)
{
    // 全局设置：所有字段默认可选
    $builder->setDefaultOptions(['required' => false]);

    $builder
        ->add('baz')
        ->add('boo', null, ['required' => true]) // 单独覆盖为必填
    ;
}

// 移除configureOptions中的全局required配置
public function configureOptions(OptionsResolver $resolver)
{
    $resolver->setDefaults([
        // 不再设置全局required
    ]);
}

方案2：父表单传递参数控制子表单字段 #

如果需要在父表单中灵活控制子表单的必填字段，可通过自定义选项传递：

子表单修改：

// Child form
public function buildForm(FormBuilderInterface $builder, array $options)
{
    $requiredFields = $options['required_fields'] ?? [];

    $builder
        ->add('baz', null, ['required' => in_array('baz', $requiredFields)])
        ->add('boo', null, ['required' => in_array('boo', $requiredFields)])
    ;
}

public function configureOptions(OptionsResolver $resolver)
{
    $resolver->setDefaults([
        'required_fields' => [], // 默认无必填字段
    ]);
}

父表单调用：

// Parent form
public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder
        ->add('foo')
        ->add('bar', ChildFormType::class, [
            'inherit_data' => true,
            'required_fields' => ['boo'] // 指定仅boo字段必填
        ])
    ;
}

方案3：利用表单事件动态调整字段属性 #

如果需要更灵活的逻辑，可在子表单中通过FormEvents::PRE_SET_DATA事件动态修改字段必填性：

// Child form
public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder
        ->add('baz')
        ->add('boo');

    // 动态设置字段必填规则
    $builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event) {
        $form = $event->getForm();
        // 所有字段默认设为可选
        foreach ($form as $child) {
            $child->setAttribute('required', false);
        }
        // 单独设置boo为必填
        $form->get('boo')->setAttribute('required', true);
    });
}

public function configureOptions(OptionsResolver $resolver)
{
    $resolver->setDefaults([
        // 无需全局required设置
    ]);
}

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