Symfony表单提交后getData()与传入对象获取数据的区别

两种实现的代码对比 #

无预绑定对象的写法 #

$form->handleRequest($request); 
if ($form->isValid()) { 
     // 该场景下必须通过getData获取提交数据
      $objectHoldingDataSubmittedIntheForm = $form->getData();        
}

预传入绑定对象的写法 #

$form = $this->createForm(MyFormType::class, $objectHoldingDataSubmittedIntheForm);
$form->handleRequest($request);
if ($form->isSubmitted() && $form->isValid()) {
    // 该场景下预先传入的$objectHoldingDataSubmittedIntheForm已经被填充了所有提交数据
}

核心疑问解答 #

handleRequest()确实会在表单提交且校验通过后，把用户提交的字段数据映射到表单绑定的数据载体上，要不要调用$form->getData()，完全取决于创建表单时的参数传法：

• 如果创建表单时没有传入第二个参数（即预绑定的数据对象），Symfony会按照表单的data_class配置自动生成对应的数据载体：如果配置了实体类就生成实体实例，没配置就生成关联数组。这个自动生成的载体你之前没有持有任何引用，必须通过$form->getData()才能拿到。
• 如果创建表单时已经手动传入了自定义对象作为第二个绑定参数，handleRequest()映射数据时会直接修改你传入的这个对象的属性值，这种场景下你完全可以直接使用原来的对象，不需要额外调用getData()。此时$form->getData()返回的就是你当初传进去的对象本身，二者是同一个引用，数据没有任何区别。

额外细节说明 #

• 第二种写法里额外判断$form->isSubmitted()是官方推荐的规范写法：未提交的表单调用isValid()虽然也会返回false，但先判断提交状态可以跳过不必要的校验逻辑，代码语义也更清晰。
• 很多教程里即使预传了绑定对象，依然会写$form->getData()来拿数据，只是编码习惯问题，不存在功能差异，两种写法效果完全一致。

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