PHP 防止表单重复提交快速上手指南（新手必看）

聊聊防止表单重复提交的重要性

前两天帮同事排查一个 bug，最后定位到问题出在防止表单重复提交上。类似的坑我见过不止一次，索性把防止表单重复提交相关的经验整理成这篇文章，希望对你有帮助。

用好防止表单重复提交，记住这几点

1. 防止表单重复提交的文档注释写清楚参数含义和返回值，降低别人（和未来的自己）的理解成本。
2. 别在生产环境直接试防止表单重复提交的新写法，先在测试环境验证。
3. 注意防止表单重复提交在边界条件下的表现，例如空数据、超长数据等特殊情况。
4. 使用防止表单重复提交前先评估有没有更简单的替代方案，最简单的往往最可靠。

在进入代码之前，先把防止表单重复提交的思路理清楚。

动手实践：防止表单重复提交

来看一个具体的例子——token 防止表单重复提交：

<?php
session_start();

// 渲染表单时生成一次性 token
if (empty($_SESSION['form_token'])) {
    $_SESSION['form_token'] = bin2hex(random_bytes(16));
}

// 提交时校验并立即作废
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    if (!hash_equals($_SESSION['form_token'] ?? '', $_POST['token'] ?? '')) {
        exit('请勿重复提交');
    }
    unset($_SESSION['form_token']); // 一次性使用
    // 正常处理业务……
}

这些细节要注意

• 注释要解释「为什么」而不是「是什么」，代码本身已经说明了是什么。
• 权限不足导致的报错往往信息不明确，排查时别忘了检查文件和目录权限。
• 配置文件不要用记事本编辑，编码问题会让你怀疑人生。

回顾一下

如果你觉得本文对你有帮助，建议收藏备用——防止表单重复提交这种东西，用到的时候翻出来看两眼，比临时搜索靠谱。

---

遇见问题加 QQ23979811 协助处理