PHP 表单校验错误怎么回填：保留输入、定位字段和友好提示

PHP 表单校验失败后，最影响用户体验的不是“有错误”，而是页面把用户刚填的内容清空，只给一句笼统的提交失败。更稳的做法是把旧输入和字段错误分别保存：服务端负责校验并记录每个字段的问题，页面负责回填用户已经输入的内容，把焦点和提示放回出错字段附近。

下面用一个联系人表单做例子，字段包含姓名、邮箱和留言。代码不依赖框架，放到普通 PHP 项目里也能看清完整链路；如果项目使用 Laravel、Symfony 或 ThinkPHP，也可以把同样的结构迁移到各自的请求校验和模板渲染中。

为什么校验失败后不能只显示提交失败

用户填写表单时，最希望知道的是哪里错了、原来填的内容还在不在、下一步该改什么。如果页面只弹一句“提交失败”，用户要重新阅读整张表单，甚至可能因为内容被清空而直接离开。

一套体验更好的表单处理流程通常是这样：用户提交后，服务端校验每个字段；如果有错误，把可回显的旧输入保存起来，同时保存字段错误；页面重新展示时，输入框保留旧值，错误信息紧跟字段显示。这样用户只需要修正邮箱、电话或留言长度，不会被迫从头开始。

先把旧输入和字段错误分开保存

旧输入和错误信息不要混在一起。旧输入用于回填表单，字段错误用于展示提示和控制输入框状态。拆开保存后，模板代码会更清晰，也方便以后把错误返回给前端接口。

 cleanText($data['name'] ?? ''),
        'email' => cleanText($data['email'] ?? ''),
        'message' => cleanText($data['message'] ?? ''),
    ];

    $errors = [];

    if (mb_strlen($old['name'])  30) {
        $errors['name'] = '请填写 2 到 30 个字符的姓名';
    }

    if (!filter_var($old['email'], FILTER_VALIDATE_EMAIL)) {
        $errors['email'] = '请输入有效的邮箱地址';
    }

    $messageLength = mb_strlen($old['message']);
    if ($messageLength  500) {
        $errors['message'] = '留言内容请保持在 10 到 500 个字符';
    }

    return [$errors, $old];
}

这里的 $old 只保存可以展示给用户看的字段。密码、验证码、上传文件路径、内部状态等敏感或一次性字段不要回填，避免把不该展示的内容带回页面。

PHP 提交接口怎么返回字段级错误

普通表单提交可以采用 POST 后跳转回表单页的方式。校验失败时，把旧输入和字段错误放进 $_SESSION，再用 303 跳转到表单页面；渲染页面后立刻清掉这些临时数据，避免后续访问还看到旧错误。

303 跳转的价值在于让浏览器下一次打开的是 GET 页面。用户刷新时不会再次提交 POST 数据，这对联系表单、报名表单、订单前置表单都很重要。

表单页面怎么回填输入并定位错误字段

表单页面需要做三件事：读取一次性旧输入，读取字段错误，给出错字段加上可见状态。错误文案最好放在输入框下面，和对应字段保持近距离，避免用户看不出是哪一个输入项出了问题。

  姓名
  
= e(fieldError($errors, 'name')) ?>

  邮箱
  
= e(fieldError($errors, 'email')) ?>

  留言
  = e($old['message'] ?? '') ?>
= e(fieldError($errors, 'message')) ?>

  提交

模板里所有旧输入都经过 e() 转义，这是表单回填必须保留的安全习惯。用户输入的内容不应该原样输出到 HTML，否则一旦混入特殊字符，页面结构和安全边界都会被破坏。

提示文案、焦点和多标签页的边界处理

字段错误能显示出来只是第一步。真实项目里还要处理几个细节：错误文案要具体，第一处错误要容易找到，多标签页提交时不要让旧错误长期残留。

• 文案具体：尽量写“请输入有效的邮箱地址”，不要写“参数错误”。
• 焦点明确：页面加载后可以把焦点移动到第一个错误字段，键盘用户会更容易继续填写。
• 状态短暂：旧输入和字段错误属于一次性数据，渲染后就清掉，避免下次打开页面还看到旧提示。
• 敏感字段不回填：密码、验证码、支付信息、上传临时路径都不建议保存在旧输入里。
• 接口表单分开：普通 HTML 表单可用 session 临时保存；前后端分离接口可以直接返回 JSON 字段错误。

如果要把焦点自动移动到第一个错误字段，可以在页面底部放一小段脚本。脚本只负责改善体验，真正的校验仍然以服务端结果为准。

相关问题

PHP 表单校验应该放在前端还是后端？

前端校验适合提前提示格式问题，后端校验负责最终可信判断。只做前端校验不可靠，因为请求可以绕过页面直接发送。

旧输入能不能全部放进 session？

不要全部保存。只保存姓名、邮箱、留言这类可以重新展示的字段，密码、验证码、支付信息和上传临时路径应该排除。

为什么校验失败后建议跳转而不是直接输出页面？

跳转能把浏览器地址恢复成 GET 页面，刷新时不会重复提交表单。直接输出页面也能做，但要更仔细地处理刷新和重复提交。

前后端分离项目怎么处理字段错误？

接口可以返回统一结构，例如 { "errors": { "email": "请输入有效的邮箱地址" } }。前端根据字段名回填错误状态，旧输入通常保留在组件状态里。

总结

PHP 表单校验错误回填的关键，是把“用户已经填过什么”和“哪些字段错了”分开处理。服务端保存一次性旧输入和字段错误，页面回填字段并展示贴近输入框的提示，再配合 303 跳转、HTML 转义和焦点定位，表单体验会比一句“提交失败”可靠很多。