表单提交后字段值是否清空，往往不是单个函数调用就能彻底解决的问题。CodeIgniter 4 提供了验证库、请求对象、Session 和表单辅助函数，但它们对旧输入数据的处理方式并不完全相同。如果只是把控制器里的变量清空，而验证器里还保存着上一轮的 POST 数据，下一次加载页面时 set_value 仍可能把旧值带出来。因此在设计方案时，需要先理解提交、验证、重定向、渲染这条链路中数据分别存在哪里。
一、set_value 读取旧输入的基本机制
在 CodeIgniter 4 中，视图里的 set_value('title') 并不是简单读取 PHP 的 $_POST 数组。它通过表单辅助函数向验证库请求对应字段的旧值。通常，验证失败后调用 redirect()->back()->withInput() 时，这些旧输入会被写入 Session 的闪存数据，字段名作为键保存。下一次渲染表单页时，set_value 就能恢复用户刚填写的内容。
因此，是否清空表单值，关键不在于视图里的 HTML 是否写了 value 属性为空，而在于旧输入数据是否还存在。一个常见的误区是：控制器在验证成功后仍然返回同一个视图，却只把变量赋值为空数组。此时，验证服务里缓存的旧数据仍可能被 set_value 取到，页面看起来就像是清空失败。
下面这段视图代码展示了标准的表单字段写法，输入框的值完全交给 set_value 管理：
<form action="/news/create" method="post">
<input type="text" name="title" value="<?php echo set_value('title'); ?>">
<input type="email" name="email" value="<?php echo set_value('email'); ?>">
<button type="submit">提交</button>
</form>
如果后端在验证失败时执行了 withInput()，这些输入框会自动回填；如果后端没有调用 withInput()，字段则为空。这为清空表单提供了最基本的思路：验证成功时不要写入旧输入数据。
二、推荐方案：用 POST-Redirect-GET 模式隔离提交与展示
要彻底清空表单值，最稳定的做法是让提交请求和页面展示请求分离。用户提交表单时浏览器发出 POST 请求，服务端处理完成后返回重定向响应，浏览器再发起新的 GET 请求加载结果页面或表单页。由于新请求不再携带 POST 数据，也没有验证库暂存的旧输入，set_value 自然返回空值。
这种模式还能避免用户刷新页面时重复提交同一份数据。大多数浏览器在刷新 POST 结果页时会弹窗询问是否重新提交，而 PRG 模式把最后一次请求变成 GET，刷新就只是重新获取页面，不会再次写入数据。
控制器代码可以这样组织：
public function create()
{
$rules = [
'title' => 'required|min_length[3]',
'email' => 'required|valid_email',
];
if ($this->request->getMethod() === 'post' && $this->validate($rules)) {
$title = $this->request->getPost('title');
$email = $this->request->getPost('email');
// 模拟数据保存
$model = new \App\Models\NewsModel();
$model->insert([
'title' => $title,
'email' => $email,
]);
return redirect()->to('/news/success');
}
return view('news/create', [
'validation' => $this->validator,
]);
}
注意，验证成功后调用 redirect()->to() 时并没有链式调用 withInput()。这样 Session 闪存里不会写入旧字段值，下一次加载表单页时所有输入框都会显示为空。验证失败时，再进入 view 分支，这时验证库仍然持有当前 POST 数据，set_value 可以回填错误内容。
如果业务要求成功后返回原表单页而不是独立成功页，可以改用 redirect()->to('/news/create')。只要不在重定向前调用 withInput()，效果相同，表单仍会被清空。
三、验证失败与成功必须分成两条数据流
清空表单的难点在于区分验证失败和提交成功。失败时需要保留旧值，方便用户修正；成功时需要清除旧值，避免二次提交。若两条路径都写 withInput()，成功后自然还会看到旧数据；若两条路径都不写 withInput()，失败时用户要重新填写所有字段，体验较差。
推荐的失败处理使用 redirect()->back()->withInput()，并携带错误信息。重定向回到表单页后，set_value 会从 Session 闪存中恢复旧输入，错误提示也从 validation 对象中读取。成功处理则只做数据落库和重定向，不携带输入数据。
示例分支如下：
if ($this->validate($rules)) {
// 数据保存
return redirect()->to('/news/success');
}
return redirect()->back()->withInput()->with('errors', $this->validator->getErrors());
如果控制器没有跳转条件，必须原地渲染结果页，那么需要在验证成功后主动清空旧输入。可以调用验证器的重置方法：
$this->validation->reset();
session()->remove('_ci_old_input');
这两行代码分别清除验证库内存中的字段值和 Session 闪存中的旧输入键。执行之后，即使同一请求接着渲染视图，set_value('title') 也会返回空字符串。
四、前端 reset 方法的使用边界
浏览器原生提供的 form.reset() 方法可以快速恢复表单控件的默认值，但它并不总是等价于清空。对于没有显式设置 value 属性的文本框，reset() 会清空内容；对于设置了 value="默认文字" 的输入框，reset() 会把值恢复成默认文字，而不是空字符串。
在 AJAX 提交场景中，后端返回 JSON 而不会触发页面跳转，此时前端需要主动清空表单。可以在 fetch 或 XMLHttpRequest 的成功回调里执行 reset()。下面是一个不使用箭头函数的兼容示例：
document.getElementById('newsForm').addEventListener('submit', function (e) {
e.preventDefault();
fetch('/news/create', {
method: 'POST',
body: new FormData(this)
})
.then(function (response) {
return response.json();
})
.then(function (data) {
if (data.success) {
e.target.reset();
}
});
});
如果某个字段需要清空而不是恢复默认值，可以在 reset() 之后手动把目标控件的 value 设置为空字符串。另外，如果页面上有下拉框、单选按钮或复选框，reset() 会恢复 selected 和 checked 状态，需要根据业务判断是否符合预期。
五、Session 闪存数据的生命周期与手动清理
CodeIgniter 4 的 withInput() 使用 Session 闪存数据保存旧输入，这类数据只在紧接着的下一个请求中有效，之后自动销毁。如果把 PRG 模式执行到位，就不会有旧值残留。但有些场景下，失败重定向到表单页后，用户没有继续操作，而是直接访问另一个页面，旧输入仍可能作为闪存数据被消耗掉，并不会永久保留。
对于同一请求内需要连续渲染多个视图，或者在某些中间件里统一处理表单状态的情况，可以手动清除旧输入。除了 $this->validation->reset() 之外，还可以使用 Session 服务的 remove 方法删除指定键：
$session = session();
if ($session->has('_ci_old_input')) {
$session->remove('_ci_old_input');
}
需要注意的是，不要直接清空整个 Session，因为用户登录态、CSRF 令牌等数据也保存在 Session 中。只针对 _ci_old_input 这个键操作，既能达到清空表单旧值的目的，又不会影响其他状态。
综合来看，CodeIgniter 4 表单提交后的清空策略应当以服务端为主：验证成功走重定向且不携带旧输入，验证失败走重定向并携带旧输入；只有 AJAX 或原地渲染等特殊流程才引入前端 reset() 和手动 Session 清理。理解 set_value 的数据来源之后，就能避免为了清空字段而写出硬编码 value 为空字符串这类易漏易错的代码。
CodeIgniter 4表单重置表单提交清空修改时间：2026-09-25 10:09:37