Symfony 5中基于EntityType实现关联关系为Null的实体搜索表单

我之前在做类似的Symfony搜索表单时也遇到过这个困扰——EntityType确实不允许直接添加未持久化的实体到选项里，但有几个比较优雅的解决方案，根据你的需求推荐两种：

方法一：添加独立复选框（推荐，用户体验更清晰） #

这种方法把“搜索无颜色车辆”做成一个单独的复选框，和颜色选择下拉框分开，逻辑更清晰，用户也更容易理解，完全覆盖你的三个搜索场景。

表单代码修改 #

use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
use Symfony\Component\Form\Extension\Core\Type\EntityType;

class Search extends AbstractType {
    public function __construct(EntityManagerInterface $entityManager) {
        $this->entityManager = $entityManager;
    }

    private function getColorRepository(): ColorRepository {
        return $this->entityManager->getRepository(Color::class);
    }

    public function buildForm(FormBuilderInterface $builder, array $options) {
        $builder
            ->add('color', EntityType::class, [
                'class' => Color::class,
                'choice_label' => 'name',
                'multiple' => false,
                'expanded' => false,
                'required' => false,
                'placeholder' => 'Select a color ...', // 对应场景3：不筛选颜色
            ])
            ->add('showUncolored', CheckboxType::class, [
                'label' => 'Show vehicles without recorded color',
                'required' => false,
                'mapped' => false, // 不需要映射到实体，避免多余的字段
            ]);
    }
}

查询逻辑处理 #

在VehicleRepository中编写搜索方法，根据表单提交的值构建查询：

// VehicleRepository.php
public function searchVehicles(?Color $color, bool $showUncolored, ?int $doorCount = null) {
    $qb = $this->createQueryBuilder('v');

    // 处理颜色筛选逻辑
    if ($color) {
        // 场景1：搜索指定颜色的车辆
        $qb->andWhere('v.color = :color')
           ->setParameter('color', $color);
    } elseif ($showUncolored) {
        // 场景2：搜索未记录颜色的车辆
        $qb->andWhere('v.color IS NULL');
    }
    // 场景3：不添加颜色条件，即不对颜色进行筛选

    // 处理车门数量等其他筛选条件
    if ($doorCount) {
        $qb->andWhere('v.doorCount = :doorCount')
           ->setParameter('doorCount', $doorCount);
    }

    return $qb->getQuery()->getResult();
}

在Controller中调用这个方法：

$form->handleRequest($request);
if ($form->isSubmitted() && $form->isValid()) {
    $color = $form->get('color')->getData();
    $showUncolored = $form->get('showUncolored')->getData();
    $doorCount = $form->get('doorCount')->getData(); // 假设你有这个字段

    $vehicles = $this->vehicleRepository->searchVehicles($color, $showUncolored, $doorCount);
}

方法二：在下拉框中添加“未记录颜色”选项 #

如果你一定要在同一个下拉框里包含这个选项，可以通过自定义ChoiceType结合模型转换器实现，同时处理提交后的特殊值：

表单代码修改 #

use Symfony\Component\Form\CallbackTransformer;
use Symfony\Component\Form\Extension\Core\Type\ChoiceType;

class Search extends AbstractType {
    public function __construct(EntityManagerInterface $entityManager) {
        $this->entityManager = $entityManager;
    }

    private function getColorRepository(): ColorRepository {
        return $this->entityManager->getRepository(Color::class);
    }

    public function buildForm(FormBuilderInterface $builder, array $options) {
        $colors = $this->getColorRepository()->findAll();

        $builder
            ->add('colorChoice', ChoiceType::class, [
                'choice_label' => function ($choice) {
                    if ($choice === 'unidentified') {
                        return 'Not identified';
                    }
                    return $choice->getName();
                },
                'choice_value' => function ($choice) {
                    if ($choice === 'unidentified') {
                        return 'unidentified';
                    }
                    return $choice->getId();
                },
                'choices' => array_merge(
                    ['unidentified'], // 特殊标记代表未记录颜色
                    $colors
                ),
                'required' => false,
                'placeholder' => 'Select a color ...', // 对应场景3
            ]);

        // 添加模型转换器，处理特殊值和实体的转换
        $builder->get('colorChoice')->addModelTransformer(new CallbackTransformer(
            // 从数据到表单：无颜色时返回特殊标记
            function ($value) {
                if ($value === null) {
                    return 'unidentified';
                }
                return $value;
            },
            // 从表单到数据：特殊标记转成null，其他转成Color实体
            function ($value) {
                if ($value === 'unidentified') {
                    return null;
                }
                return $this->getColorRepository()->find($value);
            }
        ));
    }
}

查询逻辑处理 #

在Repository中判断表单提交的值：

public function searchVehicles($colorChoice, ?int $doorCount = null) {
    $qb = $this->createQueryBuilder('v');

    if ($colorChoice === 'unidentified') {
        // 场景2：未记录颜色的车辆
        $qb->andWhere('v.color IS NULL');
    } elseif ($colorChoice instanceof Color) {
        // 场景1：指定颜色的车辆
        $qb->andWhere('v.color = :color')
           ->setParameter('color', $colorChoice);
    }
    // 场景3：用户选择了placeholder，不添加颜色条件

    // 其他条件处理...

    return $qb->getQuery()->getResult();
}

为什么不推荐原来的未持久化实体方法？ #

用未持久化的Color实体虽然能显示选项，但表单提交时Symfony会尝试将其转换为数据库中存在的实体，这会直接抛出错误（因为ID为null的实体不存在），而且这种方式也不符合Doctrine的持久化规则，确实不够优雅。

以上两种方法都能完美覆盖你的三个搜索场景，推荐第一种，因为逻辑更清晰，用户操作也更直观。

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