Symfony 4：如何编辑指定表单控件并避免字段重置

这个问题其实是Symfony表单的默认行为导致的：当你调用$form->handleRequest($request)时，表单会把所有未在请求中提交的字段重置为它们的默认值（比如null或者实体类定义的初始值），因为表单默认采用的是“替换”模式，而非“增量更新”模式。你只渲染了邮箱、ID、CSRF令牌和提交按钮，其他字段没有出现在表单里，自然不会被提交，所以会被重置。

下面给你几个可行的解决方案：

方案1：手动提交表单时禁用清除未提交字段 #

在控制器里，不要直接用handleRequest，而是手动调用submit方法，并把第二个参数clearMissing设为false。这样表单只会更新你提交的字段，不会触碰其他字段。

示例代码：

// 假设你已经获取了$user对象和创建了$form
if ($request->isMethod('POST')) {
    // 手动提交表单数据，禁用清除未提交字段
    $form->submit($request->request->get($form->getName()), false);
    
    if ($form->isValid()) {
        $entityManager->flush();
        // 跳转或其他逻辑
    }
}

方案2：使用HTTP PATCH方法 #

PATCH方法本来就是用于增量更新资源的，Symfony表单支持这种模式。

步骤1：修改模板中的表单方法 #

把表单的提交方法改成PATCH：

{{ form_start(form, {'method': 'PATCH'}) }}
    {{ form_widget(form.id)}}
    {{ form_widget(form._token) }}
    {{ form_widget(form.email) }}
    {{ form_widget(form.submit) }}
{{ form_end(form, {'render_rest': false}) }}

步骤2：在控制器中处理PATCH请求 #

确保你的路由支持PATCH方法，然后正常处理表单即可。当表单接收到PATCH请求时，会自动采用增量更新模式，不会重置未提交的字段：

// 路由配置示例（注解方式）
/**
 * @Route("/user/{id}/edit-email", name="user_edit_email", methods={"GET", "PATCH"})
 */
public function editEmail(User $user, Request $request, EntityManagerInterface $entityManager)
{
    $form = $this->createForm(UserType::class, $user);
    $form->handleRequest($request);

    if ($form->isSubmitted() && $form->isValid()) {
        $entityManager->flush();
        return $this->redirectToRoute('user_show', ['id' => $user->getId()]);
    }

    return $this->render('user/edit_email.html.twig', [
        'user' => $user,
        'form' => $form->createView(),
    ]);
}

方案3：创建仅包含邮箱字段的专用表单类型 #

最规范的做法是创建一个只处理邮箱字段的表单类型，避免使用包含所有用户字段的表单。这样即使使用默认的handleRequest，也只会更新邮箱字段，不会影响其他字段。

创建专用表单类型 #

// src/Form/UserEmailEditType.php
namespace App\Form;

use App\Entity\User;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\EmailType;
use Symfony\Component\Form\Extension\Core\Type\SubmitType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class UserEmailEditType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('email', EmailType::class)
            ->add('submit', SubmitType::class, ['label' => '更新邮箱'])
        ;
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => User::class,
        ]);
    }
}

在控制器中使用这个表单 #

$form = $this->createForm(UserEmailEditType::class, $user);
$form->handleRequest($request);

if ($form->isSubmitted() && $form->isValid()) {
    $entityManager->flush();
    // 跳转逻辑
}

模板简化 #

因为表单只包含邮箱和提交按钮，模板可以更简洁：

{{ form_start(form) }}
    {{ form_widget(form.email) }}
    {{ form_widget(form.submit) }}
{{ form_end(form) }}

（CSRF令牌和ID会自动处理，不需要手动渲染）

这三个方案里，方案3最符合Symfony的最佳实践，因为它让表单职责更单一；方案1和2适合快速修改现有代码的场景。

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