Symfony 7中如何向CollectionType嵌套表单传递自定义参数

问题原因 #

你遇到的报错The option "category" does not exist，是因为直接把自定义参数category加到了CollectionType的选项中，但CollectionType本身并没有这个选项。要传递参数给嵌套的AnimalType，必须通过entry_options配置项。

修正步骤 #

1. 修改ActivityType的CollectionType配置 #

将category参数移到entry_options里，这样每个嵌套的AnimalType实例都会收到该参数：

namespace App\Form;

use App\Entity\Activity;
use App\Entity\Animal;
use App\Entity\User;
use App\Form\AnimalType;
use Symfony\Component\Form\Extension\Core\Type\CollectionType;
use Symfony\Component\Form\Extension\Core\Type\SubmitType;
use Symfony\Bridge\Doctrine\Form\Type\EntityType;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class ActivityType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('date')
            ->add('shift')
            ->add('people', EntityType::class, [
                'class' => User::class,
                'multiple' => true,
            ])
            ->add('animals', CollectionType::class, [
                'entry_type' => AnimalType::class,
                'entry_options' => [
                    'label' => false,
                    'category' => $options['category'], // 把category放到entry_options里
                ],
                'allow_add' => true,
                'allow_delete' => true,
                'by_reference' => false,
            ])
            ->add('save', SubmitType::class);
        ;

        if ($options['category'] == 'asilo') {
            $builder->remove('people');
        }
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => Activity::class,
        ]);
        $resolver->setRequired(['category']); // 确保category参数必须被传递
    }
}

2. 在AnimalType中使用category参数 #

根据传入的category值，动态控制表单字段：

namespace App\Form;

use App\Entity\Animal;
use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class AnimalType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder->add('quantity');

        // 根据category动态添加字段
        if ($options['category'] === 'asilo') {
            $builder->add('type', ChoiceType::class, [
                'choices'  => [
                    'Full Day' => 1,
                    'Half Day' => 2,
                ],
            ]);
        } else {
            // 其他分类的字段逻辑，示例：添加专属字段
            $builder->add('special_field');
        }
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setRequired(['category']); // 声明category为必填选项
        $resolver->setDefaults([
            'data_class' => Animal::class, // 确保和你的实际实体类一致
        ]);
    }
}

3. 控制器中传递category参数 #

创建表单时正常传入category即可：

// 控制器代码示例
$activity = new Activity();
$form = $this->createForm(ActivityType::class, $activity, [
    'category' => 'asilo', // 这里传入你的分类值
]);

关键说明 #

• CollectionType的自定义参数必须通过entry_options传递给嵌套表单，不能直接添加到CollectionType的选项中
• 确保嵌套表单（AnimalType）的configureOptions里声明了category为必填选项，Symfony才会正确解析该参数
• 分类值在控制器中设置后，会传递到主表单，再通过entry_options传递给每个嵌套的AnimalType实例，实现动态字段控制

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