Symfony 6中动态ChoiceType字段提交后丢失值问题

问题原因 #

Symfony的ChoiceType字段默认会校验提交值是否存在于预定义的choices列表中。你的subPattern字段在表单初始化时未配置有效的choices（仅通过JavaScript动态渲染DOM选项），导致表单提交后，Symfony因提交值不在允许的选项列表内，将subPattern置为null。而PRE_SUBMIT阶段处于表单校验与数据绑定之前，因此该阶段能保留原始提交值。

解决方案 #

方法一：通过表单事件动态加载subPattern的选项（推荐） #

在表单类的buildForm方法中添加PRE_SUBMIT事件监听器，根据提交的pattern值动态生成subPattern的合法选项，确保表单校验时能识别提交值：

use Symfony\Component\Form\FormEvent;
use Symfony\Component\Form\FormEvents;

public function buildForm(FormBuilderInterface $builder, array $options): void
{
    $builder
        ->add('pattern', ChoiceType::class, [
            'label' => 'contact.form.pattern.title',
            'choices' => PatternEnum::getChoicesToString(),
            'required' => true,
        ])
        ->add('subPattern', ChoiceType::class, [
            'label' => 'contact.form.sub_pattern.title',
            'required' => true,
            'choices' => [], // 初始化空选项，后续通过事件更新
        ]);

    // 添加PRE_SUBMIT事件监听器
    $builder->addEventListener(FormEvents::PRE_SUBMIT, function (FormEvent $event) {
        $submittedData = $event->getData();
        $form = $event->getForm();

        // 仅当pattern值存在时更新subPattern选项
        if (!isset($submittedData['pattern'])) {
            return;
        }

        $patternValue = $submittedData['pattern'];
        try {
            // 根据pattern值获取对应subPattern选项，逻辑与控制器保持一致
            $subPatterns = match ($patternValue) {
                PatternEnum::AFTER_SALES_SERVICE->value => SubPatternEnum::getByAfterSalesService(),
                PatternEnum::DELIVERY_INFORMATION->value => SubPatternEnum::getByDepositInformation(),
                PatternEnum::PRODUCT->value => SubPatternEnum::getByAvailableProduct(),
                PatternEnum::ORDER_TRACKING->value => SubPatternEnum::getByOrderTracking(),
                PatternEnum::OTHER_REQUESTS->value => SubPatternEnum::getByOtherRequests(),
                PatternEnum::TECHNICAL_PROBLEMS->value => SubPatternEnum::getByTechnicalProblems(),
                default => [],
            };

            // 重新构建subPattern字段，传入合法选项
            $form->add('subPattern', ChoiceType::class, [
                'label' => 'contact.form.sub_pattern.title',
                'required' => true,
                'choices' => array_combine($subPatterns, $subPatterns), // 键值均为翻译键，与pattern逻辑一致
            ]);
        } catch (\InvalidArgumentException $e) {
            // 处理无效pattern值的情况，例如清空subPattern选项
            $form->add('subPattern', ChoiceType::class, [
                'label' => 'contact.form.sub_pattern.title',
                'required' => true,
                'choices' => [],
            ]);
        }
    });
}

方法二：关闭选项校验（不推荐，存在安全风险） #

若无需校验subPattern的选项合法性，可给subPattern字段添加'choice_loader' => null配置，绕过Symfony的选项校验：

->add('subPattern', ChoiceType::class, [
    'label' => 'contact.form.sub_pattern.title',
    'required' => true,
    'choice_loader' => null, // 关闭选项校验
])

此方法会绕过表单的安全校验，可能导致非法值提交，仅在特殊场景下使用。

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