Symfony表单提交处理需据请求类型选择方式：HTML表单用handleRequest()；JSON请求需手动解码后submit()；PUT/PATCH须启用方法覆盖；文件上传依赖FileType及move()；集合字段须配置by_reference=false、@Assert\Valid及正确prototype。
Symfony 表单提交处理的核心在于“请求数据如何绑定到表单、何时触发验证、以及怎样适配不同客户端行为”。它不是简单调用一个方法就完事，而是要根据请求来源（HTML 表单、AJAX、JSON API）、HTTP 方法（POST/PUT/PATCH）、是否含文件、是否为集合字段等，选择匹配的处理路径。
标准 HTML 表单：用 handleRequest() 一步到位
这是最常见场景。Symfony 自动识别 POST/GET 请求，提取 $_POST 或 $_GET 数据，并完成绑定与初步解析。
- 控制器中创建表单后，直接调用 $form->handleRequest($request)
- 该方法内部会检查请求方法、读取原始数据、解码、映射字段，同时自动处理 CSRF 校验
- 之后只需判断 $form->isSubmitted() && $form->isValid()，验证失败时错误会自动挂载到对应字段
- 验证通过后，$form->getData() 返回的是已填充的对象或数组，可直接用于保存或业务逻辑
JSON 请求：手动解码 + submit() 替代 handleRequest()
当前端发来 Content-Type: application/json 的请求时，handleRequest() 不起作用——它不解析原始请求体。
- 先获取原始内容：$json = $request->getContent()
- 解码为数组：$data = json_decode($json, true)
- 跳过自动请求检测，直接提交：$form->submit($data)
- 仍需手动检查 $form->isValid()，错误信息结构和 HTML 场景一致
- 注意：若 JSON 中含嵌套对象或空值，确保表单类型配置了合适的 empty_data 和 required
PUT/PATCH 请求：确保方法支持并启用覆盖机制
Symfony 默认只对 POST/GET 启用自动解析。PUT/PATCH 需额外配置才能让 handleRequest() 正常工作。
- 路由中明确声明允许方法，例如 @Method({"PUT", "POST"})
- 启用 HTTP 方法覆盖监听器（默认开启），这样表单可通过隐藏字段 _method=PUT 模拟
- 确保 framework.http_method_override 在配置中为 true（Symfony 5.4+ 默认启用）
- 如果使用原生 PUT 请求（非模拟），需确认 Web 服务器（如 Nginx/Apache）未拦截或丢弃 PUT body
文件上传：FileType 字段 + move() 是关键动作
文件不走普通字段流程，必须用 FileType，且不能依赖 getData() 直接拿路径。
- 表单中定义字段时，加上约束：['required' => true, 'constraints' => [new File(['maxSize' => '5M'])]]
- handleRequest() 会把 $_FILES 映射为 UploadedFile 对象
- 验证通过后，从数据中取出文件对象：$file = $data['attachment']
- 必须调用 $file->move($uploadDir, $safeName) 才能真正保存；不能存 getRealPath()，那是临时路径
- 若用 AJAX 上传，改用 $request->files->get('field_name') 手动提取 UploadedFile
CollectionType（一对多）：by_reference、prototype、Valid 缺一不可
集合字段容易“看似提交了，实则没进数据”，问题多出在配置和前端配合上。
- 设 'by_reference' => false，否则 Symfony 不调用 addXxx() 方法，新子项不会加入集合
- 子实体类上加 @Assert\Valid，否则子项字段上的 NotBlank 等约束完全不生效
- 前端 JS 动态添加行时，name 属性必须严格匹配 Symfony 渲染的 prototype，比如 tags[2][name]，不能漏掉索引或写错层级
- 模板里用 {{ form_widget(form.tags) }} 渲染，JS 克隆时替换所有 __name__ 为实际数字索引
