Symfony集合表单（CollectionType）用于处理多实例子表单，需配置entry_type、allow_add/allow_delete、by_reference=false及prototype=true；前端用data-prototype动态增删；后端在PRE_SUBMIT事件中动态添加字段并过滤待删项；验证需分层设置。
Symfony 集合表单（CollectionType）用于处理一组相同结构的子表单，比如用户添加多个电话号码、文章关联多个标签、订单包含多个商品行等场景。它不是简单循环渲染几个字段，而是要让 Symfony 正确识别、验证、绑定和持久化整个集合数据。
核心配置：声明 CollectionType 字段
在表单类中添加集合字段时，必须指定 entry_type（每个子项的类型），并启用 allow_add 和/或 allow_delete 才能动态增删：
-
entry_type：必须是有效的表单类型类，如
PhoneType::class或内置类型TextType::class -
allow_add => true：允许前端 JS 添加新条目（需配合
data-prototype） -
allow_delete => true：允许标记某条目为“待删除”，需在实体中实现
removeXXX()方法或使用by_reference => false -
by_reference => false：推荐设为
false，确保 Symfony 调用addXXX()/removeXXX()方法，而不是直接操作数组 -
prototype => true：开启后，Twig 模板中可通过
form.xxx.vars.prototype获取 JS 可克隆的 HTML 片段
前端集成：用 data-prototype 动态插入
CollectionType 自动提供 data-prototype 属性，内含未编号的 HTML 模板。JS 不需要手动拼 name，只需替换索引即可：
- 原始 prototype：
form[phones][__name__][number] - 插入新行时，把
__name__替换为当前最大索引 +1，例如form[phones][2][number] - 确保所有子字段 name 符合
父名[索引][字段名]格式，且索引为连续数字（0,1,2…） - 删除某行时，不直接移除 DOM，而是给对应子表单容器加
data-delete="1"，并在提交前由 JS 清理
后端处理：PRE_SUBMIT 是关键时机
集合字段的动态增删逻辑必须放在 FormEvents::PRE_SUBMIT 中处理，否则新增字段无法被解析、验证会失败：
- 在事件回调里获取原始提交数据：
$data = $event->getData() - 检查是否有新条目（如
isset($data['phones']) && is_array($data['phones'])） - 根据实际数量调用
$form->add('phones', CollectionType::class, [...])—— 注意这里是对运行时$form实例操作，不是$builder - 如果要支持“软删除”，可在 PRE_SUBMIT 中过滤掉带
data-delete="1"的条目，再传给表单解析
数据映射与验证要点
集合中的每个子项默认映射到目标对象的数组属性（如 User::$phones）。验证需分层处理：
- 子表单类（如
PhoneType）内部定义字段级约束（如NotBlank、Regex） - 集合字段本身可加
constraints，如Count(min=1)控制最少几条 - 实体类中，集合属性应声明为
Collection|ArrayCollection，并配好 Doctrine 关联（@ORM\OneToMany） - 若子项是嵌套实体（如
Phone），确保其有独立的验证注解，且主表单未禁用验证组
