如何创建登录会话？实现PHP与HTML分离的登录验证方案

完全理解你不想让PHP代码混杂在HTML里的想法，这种分离式写法不仅更易维护，也让代码结构更清晰。下面是一套适配你需求的实现方案，所有核心PHP逻辑都放在独立目录中：

1. 目录结构规划 #

先梳理清晰项目结构，确保PHP文件和HTML/视图文件完全分开：

你的项目根目录/
├── php/                  # 所有PHP逻辑文件存放目录
│   ├── session-check.php # 会话验证核心脚本
│   ├── login-process.php # 登录表单处理脚本
│   └── logout.php        # 登出处理脚本
├── login.php             # 登录页面（仅含少量必要PHP提示）
├── dashboard.php         # 需登录访问的示例页面
└── ...其他需要验证的页面

2. 编写独立的会话验证脚本 #

在php/session-check.php中编写纯PHP的会话验证逻辑，仅处理校验和跳转，不涉及任何HTML：

<?php
session_start();

// 获取当前访问页面的文件名，避免登录页循环跳转
$current_page = basename($_SERVER['PHP_SELF']);
$excluded_pages = ['login.php', 'login-process.php'];

// 如果是登录相关页面，直接跳过验证
if (in_array($current_page, $excluded_pages)) {
    return;
}

// 验证会话有效性：未登录则跳转到登录页
if (!isset($_SESSION["login"]) || empty($_SESSION["login"])) {
    header("Location: login.php");
    exit; // 必须调用exit，防止后续代码执行
}
?>

3. 在需要验证的页面引入脚本 #

对于所有需要登录才能访问的页面（比如dashboard.php），只需在页面最顶部单独一行引入会话验证脚本，其余部分保持纯HTML：

<?php
// 注意路径要根据实际目录结构调整，确保能找到php目录下的脚本
require_once './php/session-check.php';
?>
<!DOCTYPE html>
<html>
<head>
    <title>用户仪表盘</title>
</head>
<body>
    <h1>欢迎回来，<?php echo $_SESSION["login"]; ?></h1>
    <p>这是仅登录用户可见的内容</p>
    <a href="./php/logout.php">点击登出</a>
</body>
</html>

4. 登录表单与处理逻辑分离 #

登录页面（login.php） #

这个页面几乎是纯HTML，仅在需要显示错误提示时加少量PHP：

<!DOCTYPE html>
<html>
<head>
    <title>用户登录</title>
</head>
<body>
    <h1>请登录</h1>
    <!-- 仅在登录失败时显示错误提示 -->
    <?php if (isset($_GET['error'])): ?>
        <p style="color: #dc3545;">用户名或密码错误，请重试</p>
    <?php endif; ?>
    
    <!-- 表单提交到独立的PHP处理脚本 -->
    <form action="./php/login-process.php" method="post">
        <div>
            <label>用户名：</label>
            <input type="text" name="username" required>
        </div>
        <div>
            <label>密码：</label>
            <input type="password" name="password" required>
        </div>
        <button type="submit">登录</button>
    </form>
</body>
</html>

登录处理脚本（php/login-process.php） #

所有验证用户凭据、写入会话的逻辑都放在这里，纯PHP无HTML：

<?php
session_start();

// 获取表单提交的参数
$username = trim($_POST['username'] ?? '');
$password = trim($_POST['password'] ?? '');

// 这里替换为你的MySQL查询验证逻辑
// 示例：模拟从数据库查询到的有效用户（实际项目请用密码哈希存储！）
$valid_user = 'demo_user';
$valid_pass = 'demo_pass123';

if ($username === $valid_user && $password === $valid_pass) {
    // 验证成功，写入会话标识
    $_SESSION["login"] = $username;
    // 跳转到登录后的页面
    header("Location: ../dashboard.php");
    exit;
} else {
    // 验证失败，跳回登录页并携带错误标识
    header("Location: ../login.php?error=1");
    exit;
}
?>

5. 登出功能实现 #

在php/logout.php中编写纯PHP的会话销毁逻辑：

<?php
session_start();
// 清空会话变量
session_unset();
// 销毁会话
session_destroy();
// 跳回登录页
header("Location: ../login.php");
exit;
?>

进阶优化：自动引入验证脚本 #

如果不想在每个需要验证的页面都手动写require_once，可以通过PHP配置实现自动引入：

1. 在项目根目录创建.htaccess文件（Apache服务器适用），添加以下内容：

php_value auto_prepend_file "./php/session-check.php"

2. 这样所有PHP页面都会自动在顶部引入session-check.php，无需手动写引入代码，进一步简化页面结构。

这种方案完全实现了PHP逻辑与HTML视图的分离，所有核心业务代码都集中在独立的php目录中，HTML页面保持干净整洁，非常便于后续维护和扩展。

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