PHP会话无法注册、Header不跳转、登录页面空白问题求助

问题现象 #

• 部署login.php后，提交正确登录信息时出现空白页，无法完成跳转
• 输入错误邮箱/密码时，能显示错误提示，但无法跳转到指定的index.php?modal=loginModal页面
• PHP Session无法注册，无法获取会话中的用户关联信息（如SQL表内的姓名）
• 此前代码运行正常，修改后出现该故障

故障代码 #

<?php
    // 连接数据库
    require 'database.php';
    
    // 启动会话
    session_start();
    
    // 获取表单数据
    $email = htmlspecialchars($_POST['email'], ENT_QUOTES);
    $password = htmlspecialchars($_POST['password'], ENT_QUOTES);
    
    // 检查用户是否存在
    $sql = "SELECT * FROM utilisateurs WHERE email='$email'";
    $result = mysqli_query($conn, $sql);
    if (mysqli_num_rows($result) == 0) {
      // 显示错误提示
      echo '<div class="alert alert-danger" role="alert">错误：用户不存在。</div>';
      echo "<meta http-equiv='refresh' content='5;url=index.php?modal=loginModal'>";
    } else {
      // 获取用户哈希密码
      $utilisateur = mysqli_fetch_assoc($result);
      $password_hashed = $utilisateur['password'];
      
      // 验证密码
      if (password_verify($password, $password_hashed)) {
        
        // 将用户信息存入会话
        $_SESSION['utilisateur'] = $utilisateur;
        
        // 跳转到首页
        header("Location: index.php");
      } else {
        // 显示错误提示
        echo '<div class="alert alert-danger" role="alert">错误：密码不正确。</div>';
        echo "<meta http-equiv='refresh' content='5;url=index.php?modal=loginModal'>";
      }
    }
    
    // 关闭数据库连接
    mysqli_close($conn);
?>

修复方案 #

1. 空白页与跳转失效问题 #

• 核心原因：header("Location: ...")跳转要求执行前无任何输出（包括空格、HTML标签），否则会触发PHP警告并导致跳转失效；同时错误分支的<meta>跳转可能因脚本未终止、浏览器缓存等问题不生效。
• 修复步骤：
  • 检查database.php文件，确保其开头无任何输出（包括空格、UTF-8 BOM），否则会导致session_start()和header()失效
  • 跳转后立即添加exit()/die()终止脚本执行，避免后续代码干扰：

    // 正确跳转代码
    $_SESSION['utilisateur'] = $utilisateur;
    header("Location: index.php");
    exit(); // 必须添加，终止脚本
    

  • 错误分支替换为header跳转（更符合PHP规范），并在index.php中通过URL参数显示提示：

    // 替换用户不存在分支的代码
    header("Location: index.php?modal=loginModal&error=user_not_found");
    exit();
    
    // 替换密码错误分支的代码
    header("Location: index.php?modal=loginModal&error=wrong_password");
    exit();
    

    然后在index.php中添加提示逻辑：

    if (isset($_GET['error'])) {
        $errorMsg = match($_GET['error']) {
            'user_not_found' => '错误：用户不存在。',
            'wrong_password' => '错误：密码不正确。',
            default => ''
        };
        if ($errorMsg) {
            echo "<div class='alert alert-danger' role='alert'>$errorMsg</div>";
        }
    }
    

2. Session无法注册问题 #

• 核心原因：session_start()执行失败（通常因提前输出内容导致），或服务器Session存储目录无权限。
• 修复步骤：
  • 确保session_start()是脚本的第一个可执行语句（require 'database.php'中的文件也不能有输出）
  • 添加Session初始化检测：

    session_start();
    if (!session_id()) {
        die("会话初始化失败，请检查服务器配置");
    }
    

  • 检查服务器Session存储目录权限（Linux通常为/var/lib/php/sessions），确保PHP进程拥有读写权限

3. SQL注入风险修复（必做优化） #

当前代码直接拼接SQL语句存在严重注入风险，替换为预处理语句：

// 替换原用户查询代码
$sql = "SELECT * FROM utilisateurs WHERE email=?";
$stmt = mysqli_prepare($conn, $sql);
mysqli_stmt_bind_param($stmt, "s", $email);
mysqli_stmt_execute($stmt);
$result = mysqli_stmt_get_result($stmt);

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