如何分离PHP与HTML文件并实现表单同页错误提示？

核心思路 #

当表单提交到独立的process.php后，验证结果（错误信息、用户输入值）无法直接传递回index.php，因此需要通过Session暂存这些数据，随后重定向回index.php，再从Session中读取数据渲染错误提示和保留用户输入，最后清理Session避免刷新页面时重复显示。

具体实现步骤 #

1. 初始化Session（两个文件必须都加） #

跨页面传递数据依赖Session，需在两个文件的最顶部开启Session：

<?php
session_start();
?>

2. 修改index.php：读取Session数据渲染表单 #

在HTML表单中，从Session读取错误信息和用户输入值，渲染到对应位置：

<?php
session_start();
// 从Session获取错误信息和用户输入
$errors = $_SESSION['errors'] ?? [];
$formData = $_SESSION['form_data'] ?? [];
// 读取后立即清理Session，避免刷新页面重复显示提示
unset($_SESSION['errors'], $_SESSION['form_data']);
?>

<!DOCTYPE html>
<html>
<body>
  <h2>表单示例</h2>
  <form method="post" action="process.php">
    <div>
      <label>姓名:</label>
      <input type="text" name="name" value="<?php echo htmlspecialchars($formData['name'] ?? ''); ?>">
      <?php if(isset($errors['name'])): ?>
        <span style="color:red;">* <?php echo $errors['name']; ?></span>
      <?php endif; ?>
    </div>
    <div>
      <label>邮箱:</label>
      <input type="email" name="email" value="<?php echo htmlspecialchars($formData['email'] ?? ''); ?>">
      <?php if(isset($errors['email'])): ?>
        <span style="color:red;">* <?php echo $errors['email']; ?></span>
      <?php endif; ?>
    </div>
    <div>
      <input type="submit" name="submit" value="提交">
    </div>
  </form>
</body>
</html>

3. 修改process.php：处理验证、暂存数据并重定向 #

在process.php中完成表单验证，把错误和用户输入存入Session，然后重定向回index.php：

<?php
session_start();
$errors = [];
$formData = [];

if ($_SERVER["REQUEST_METHOD"] == "POST") {
  // 保存用户提交的原始输入
  $formData['name'] = $_POST['name'] ?? '';
  $formData['email'] = $_POST['email'] ?? '';

  // 姓名验证
  if(empty($formData['name'])) {
    $errors['name'] = '姓名不能为空';
  }

  // 邮箱验证
  if(empty($formData['email'])) {
    $errors['email'] = '邮箱不能为空';
  } elseif(!filter_var($formData['email'], FILTER_VALIDATE_EMAIL)) {
    $errors['email'] = '请输入有效的邮箱地址';
  }

  // 无错误时执行数据库操作
  if(empty($errors)) {
    // 这里编写你的数据库插入/更新逻辑
    // 操作完成后可添加成功提示
    $_SESSION['success'] = '表单提交成功！';
  }

  // 将错误信息和表单数据存入Session
  $_SESSION['errors'] = $errors;
  $_SESSION['form_data'] = $formData;

  // 重定向回表单页面
  header("Location: index.php");
  exit;
}
?>

关键注意事项 #

• session_start()必须在输出任何HTML内容之前调用，否则会触发报错。
• 重定向后要立即调用exit或die，终止后续代码执行。
• 使用htmlspecialchars()转义用户输入，防止XSS攻击。
• 如果需要显示提交成功提示，可在index.php中读取$_SESSION['success']，显示后同样清理该Session项。

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