PHP表单提交数据获取失败的排查与修复

核心问题：$_POST 数据为何获取不到？

在处理 HTML 表单提交到 PHP 的过程中，数据丢失通常源于前后端交互的两个关键环节：表单提交的触发机制和 PHP 对请求变量的读取逻辑。

第一步：检查提交按钮的 name 属性

目的：确保服务器能识别“提交”动作的发生。

在许多基础教程中，为了判断用户是否点击了提交按钮，开发者习惯在 PHP 代码中使用 if($_POST['submit']) 这种判断方式。这就要求对应的 HTML <input type="submit"> 标签中必须包含 name 属性。

• 错误示例：
  <input type="submit" value="提交" />
  此时 $_POST['submit'] 将为空或未定义，导致后续的赋值逻辑不被执行。
• 修正方法：为提交按钮添加唯一的 name 值。
  <input type="submit" name="submit" value="提交" />

第二步：核对 $_POST 变量名的大小写

目的：防止因键名不匹配导致的索引失败。

PHP 中的超级全局数组 $_POST 是严格区分大小写的。如果在接收数据时，将 $_POST 误写为 $_post 或 $_POST[name]（注意：name 作为键名若为非字符串常量且未加引号，在某些旧版本 PHP 中虽可能报警但极易出错，标准写法需加引号），会导致取值为 null。

• 规范写法：
  $value = $_POST["field_name"];

安全隐患与现代化改造

除了上述直接的技术错误外，原文示例中存在更严重的架构过时和安全风险问题，在实际开发中必须规避。

1. 废弃的 MySQL 连接方式

原文使用的 mysql_connect() 函数已在 PHP 7.0 中被移除，并在 PHP 5.5 中被标记为过时。继续使用会导致程序在服务器上崩溃。

• 推荐替代：使用 PDO (PHP Data Objects) 或 mysqli。两者均支持预处理语句，能有效防范 SQL 注入。

2. SQL 注入漏洞

原文直接将 $_POST['name'] 拼接到 SQL 语句中：
$sql="insert into test ... values ('','$_POST[name]',...);"

风险：攻击者可通过输入特殊字符（如 ' OR '1'='1）修改 SQL 逻辑，窃取或删除数据。

• 防御措施：必须使用参数化查询（Prepared Statements）。例如在 PDO 中：
  

  $stmt = $pdo->prepare('INSERT INTO test (name, sex) VALUES (:name, :sex)');
  $stmt->execute([':name' => $name, ':sex' => $sex]);

3. 编码问题优化

原文建议将页面编码设为 gb2312 以解决乱码。在现代 Web 开发中，UTF-8 是全球通用的编码标准。

• 操作建议：
  1. HTML 文件头部声明：<meta charset="UTF-8">
  2. 数据库连接设置：PDO 可设 charset=utf8mb4；MySQLi 可使用 set_charset("utf8mb4")
  3. 确保编辑器、数据库、PHP 输出层统一使用 UTF-8 编码

完整的安全代码结构示例

以下是基于现代 PHP 标准重构后的最小可行示例：

<?php
// db.php - 数据库配置
$host = 'localhost';
$db   = 'bbs';
$user = 'root';
$pass = '';
$charset = 'utf8mb4';

$dsn = "mysql:host=$host;dbname=$db;charset=$charset";
$options = [
    PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES   => false,
];
try {
    $pdo = new PDO($dsn, $user, $pass, $options);
} catch (\PDOException $e) {
    throw new \PDOException($e->getMessage(), (int)$e->getCode());
}

// add.php - 处理表单
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $name = $_POST['name'] ?? '';
    $sex = $_POST['sex'] ?? '';
    
    // 验证数据
    if (!empty($name)) {
        $stmt = $pdo->prepare('INSERT INTO test (name, sex) VALUES (?, ?)');
        $stmt->execute([$name, $sex]);
        echo "成功！";
    }
}
?>
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>提交表单</title>
</head>
<body>
<form action="add.php" method="post">
    <input type="text" name="name" placeholder="输入名字" required />
    <input type="text" name="sex" placeholder="输入性别" />
    <input type="submit" name="submit" value="提交" />
</form>
</body>
</html>

总结来说，解决表单提交问题的关键在于：前端确保所有需要传输数据的字段（尤其是判断触发的按钮）具有正确的 name 属性；后端准确引用 $_POST 中的小写键名，并彻底放弃老旧的 mysql_* 系列函数，转向安全的 PDO 或 MySQLi 扩展进行数据处理。