Symfony 5.2表单：如何渲染空多对多关联并设为必填

1. 解决创建时默认选中用户的问题 #

问题根源是HTML的<select multiple>元素在无预设选中值且未设置占位符时，浏览器会自动选中第一个选项。要实现初始无选中项，需给关联字段添加空占位符，并确保新实体的关联集合为空。

表单类型配置调整 #

在InfluencerType中，针对users字段做如下配置：

use Symfony\Bridge\Doctrine\Form\Type\EntityType;
use App\Entity\User;

// ...

$builder->add('users', EntityType::class, [
    'class' => User::class,
    'multiple' => true,
    'expanded' => false, // 对应<select multiple>元素
    'placeholder' => '', // 添加空占位符，让初始状态无选中项
    'choice_label' => 'username', // 根据你的User实体实际字段调整
    'required' => false, // 先设为false，后续通过验证规则控制必填逻辑
]);

确保实体初始化正确 #

检查Influencer实体的构造函数，确保关联集合初始化为空集合，无默认添加用户的代码：

use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;

class Influencer
{
    // ...

    public function __construct()
    {
        $this->users = new ArrayCollection();
        // 禁止在此处添加$this->users->add(...)之类的代码
    }

    // ...
}

2. 实现新建必填、编辑不能全删的规则 #

直接使用required=true无法区分新建和编辑场景，推荐通过表单事件结合验证约束实现逻辑：

表单事件动态设置验证规则 #

在InfluencerType中添加表单事件监听，根据实体是否为新对象（新建/编辑）添加对应约束：

use Symfony\Component\Form\FormEvent;
use Symfony\Component\Form\FormEvents;
use Symfony\Component\Validator\Constraints\Count;

// ...

$builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event) {
    $influencer = $event->getData();
    $form = $event->getForm();

    $constraints = [];
    if (null === $influencer->getId()) {
        // 新建场景：必须至少选择1个用户
        $constraints[] = new Count([
            'min' => 1,
            'minMessage' => '必须至少关联一个用户',
        ]);
    } else {
        // 编辑场景：原有关联用户数>0时，不能移除所有用户
        $originalUserCount = $influencer->getUsers()->count();
        if ($originalUserCount > 0) {
            $constraints[] = new Count([
                'min' => 1,
                'minMessage' => '不能移除所有关联的用户',
            ]);
        }
    }

    $form->add('users', EntityType::class, [
        'class' => User::class,
        'multiple' => true,
        'expanded' => false,
        'placeholder' => '',
        'choice_label' => 'username',
        'constraints' => $constraints,
        'required' => false,
    ]);
});

进阶：自定义验证约束（复用场景） #

若需在多处复用该规则，可创建自定义验证约束：

1. 创建约束类AtLeastOneUser.php：

namespace App\Validator\Constraints;

use Symfony\Component\Validator\Constraint;

/**
 * @Annotation
 */
class AtLeastOneUser extends Constraint
{
    public $messageNew = '必须至少关联一个用户';
    public $messageEdit = '不能移除所有关联的用户';

    public function getTargets()
    {
        return self::CLASS_CONSTRAINT;
    }
}

2. 创建约束验证器AtLeastOneUserValidator.php：

namespace App\Validator\Constraints;

use Symfony\Component\Validator\Constraint;
use Symfony\Component\Validator\ConstraintValidator;

class AtLeastOneUserValidator extends ConstraintValidator
{
    public function validate($value, Constraint $constraint)
    {
        /* @var $constraint \App\Validator\Constraints\AtLeastOneUser */
        if (!$constraint instanceof AtLeastOneUser) {
            return;
        }

        $influencer = $value;
        $users = $influencer->getUsers();

        if (null === $influencer->getId()) {
            // 新建场景验证
            if ($users->count() === 0) {
                $this->context->buildViolation($constraint->messageNew)
                    ->addViolation();
            }
        } else {
            // 编辑场景：通过Doctrine获取原始关联数据，避免用户先加后删的情况
            $uow = $this->context->getObjectManager()->getUnitOfWork();
            $originalData = $uow->getOriginalEntityData($influencer);
            $originalUserCount = $originalData['users']->count();

            if ($originalUserCount > 0 && $users->count() === 0) {
                $this->context->buildViolation($constraint->messageEdit)
                    ->addViolation();
            }
        }
    }
}

3. 在Influencer实体上添加约束：

use App\Validator\Constraints as AppAssert;

/**
 * @AppAssert\AtLeastOneUser
 */
class Influencer
{
    // ...
}

此时表单只需保持users字段的基础配置即可，无需重复设置约束。

关键注意点 #

• 不要依赖HTML原生required属性，多选下拉的required在浏览器中行为不一致，且无法区分场景。
• 编辑场景中，通过Doctrine的UnitOfWork获取原始关联数，比直接用当前实体计数更准确。

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