PHP项目邮箱验证与激活

wen PHP项目 2026-07-21 103

本文目录导读：

PHP项目邮箱验证与激活

整体流程
数据库设计
注册时生成激活令牌（PHP 示例）
激活处理（activate.php）
安全性注意事项
增强功能：重新发送激活邮件
邮件发送的最佳实践（推荐 PHPMailer）
完整流程图（文字版）
常见问题排查

在PHP项目中实现邮箱验证与激活功能是非常常见的需求,尤其是在用户注册流程中，下面是完整的实现思路、代码示例和安全建议。

整体流程

用户注册 -> 生成激活令牌 -> 发送验证邮件 -> 用户点击链接 -> 验证令牌 -> 激活账号

数据库设计

需要一张 users 表，包含以下关键字段：

CREATE TABLE `users` (
    `id` int(11) NOT NULL AUTO_INCREMENT,
    `username` varchar(50) NOT NULL,
    `email` varchar(100) NOT NULL,
    `password` varchar(255) NOT NULL,
    `activation_token` varchar(64) DEFAULT NULL,
    `is_active` tinyint(1) DEFAULT 0,
    `created_at` timestamp DEFAULT CURRENT_TIMESTAMP,
    `token_expires_at` datetime DEFAULT NULL,
    PRIMARY KEY (`id`),
    UNIQUE KEY `email` (`email`),
    UNIQUE KEY `activation_token` (`activation_token`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

注册时生成激活令牌（PHP 示例）

<?php
// 注册处理
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $username = $_POST['username'];
    $email = $_POST['email'];
    $password = password_hash($_POST['password'], PASSWORD_BCRYPT);
    // 1. 生成激活令牌（64位随机字符串）
    $activationToken = bin2hex(random_bytes(32));
    $tokenExpiresAt = date('Y-m-d H:i:s', strtotime('+24 hours')); // 24小时有效
    // 2. 插入数据库
    $stmt = $pdo->prepare("INSERT INTO users (username, email, password, activation_token, token_expires_at) VALUES (?, ?, ?, ?, ?)");
    $stmt->execute([$username, $email, $password, $activationToken, $tokenExpiresAt]);
    // 3. 发送邮件
    $activationLink = "https://yourdomain.com/activate.php?token=" . $activationToken;
    $subject = "请验证您的邮箱地址";
    $message = "
        <html>
        <body>
            <h2>欢迎注册，{$username}！</h2>
            <p>请点击以下链接激活您的账号（24小时内有效）：</p>
            <a href='{$activationLink}'>{$activationLink}</a>
        </body>
        </html>
    ";
    // 使用 mail() 或 PHPMailer
    $headers = "MIME-Version: 1.0\r\n";
    $headers .= "Content-Type: text/html; charset=UTF-8\r\n";
    mail($email, $subject, $message, $headers);
    echo "注册成功！请检查邮箱完成验证。";
}
?>

推荐使用 PHPMailer（支持 SMTP、附件、HTML 格式等），避免被垃圾邮件拦截。

激活处理（activate.php）

<?php
if (isset($_GET['token'])) {
    $token = $_GET['token'];
    // 1. 查询令牌是否存在且未过期
    $stmt = $pdo->prepare("SELECT id, token_expires_at, is_active FROM users WHERE activation_token = ?");
    $stmt->execute([$token]);
    $user = $stmt->fetch();
    if (!$user) {
        die("无效的激活链接。");
    }
    if ($user['is_active'] == 1) {
        die("该账号已被激活，无需重复操作。");
    }
    if (strtotime($user['token_expires_at']) < time()) {
        die("激活链接已过期，请重新注册或申请重新发送邮件。");
    }
    // 2. 更新用户为激活状态，清空令牌
    $stmt = $pdo->prepare("UPDATE users SET is_active = 1, activation_token = NULL, token_expires_at = NULL WHERE id = ?");
    $stmt->execute([$user['id']]);
    echo "账号激活成功！您现在可以登录了。";
} else {
    die("缺少激活参数。");
}
?>

安全性注意事项

问题	解决方案
令牌被猜解	使用 `random_bytes()` 生成64位随机数
令牌泄露	限制有效期（24小时）
重放攻击	激活后立即删除 token
邮件伪造	对链接使用 HTTPS 并签名
SQL 注入	必须使用参数化查询（PDO 或 mysqli）
大量注册	添加 CAPTCHA（验证码）

增强功能：重新发送激活邮件

<?php
if ($_POST['action'] === 'resend') {
    $email = $_POST['email'];
    // 检查用户是否存在且未激活
    $stmt = $pdo->prepare("SELECT id, username, activation_token, token_expires_at FROM users WHERE email = ? AND is_active = 0");
    $stmt->execute([$email]);
    $user = $stmt->fetch();
    if ($user) {
        // 可以生成新令牌（可选）
        $newToken = bin2hex(random_bytes(32));
        $newExpires = date('Y-m-d H:i:s', strtotime('+24 hours'));
        $stmt = $pdo->prepare("UPDATE users SET activation_token = ?, token_expires_at = ? WHERE id = ?");
        $stmt->execute([$newToken, $newExpires, $user['id']]);
        // 重新发送邮件（同上）
        // ...
        echo "已重新发送激活邮件。";
    } else {
        echo "该邮箱不存在或已激活。";
    }
}
?>

邮件发送的最佳实践（推荐 PHPMailer）

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;
require 'vendor/autoload.php';
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host       = 'smtp.gmail.com';
$mail->SMTPAuth   = true;
$mail->Username   = 'your-email@gmail.com';
$mail->Password   = 'your-app-password';
$mail->SMTPSecure = 'tls';
$mail->Port       = 587;
$mail->setFrom('noreply@yourdomain.com', 'Your App');
$mail->addAddress($email, $username);
$mail->isHTML(true);
$mail->Subject = $subject;
$mail->Body    = $message;
$mail->send();

完整流程图（文字版）

[用户注册]
    |
    v
[生成 token（random_bytes(32) → bin2hex）]
    |
    v
[存入数据库（activation_token, token_expires_at）]
    |
    v
[发送邮件（含激活链接）]
    |
    v
[用户点击链接 → activate.php?token=...]
    |
    v
[验证 token 是否存在、是否过期、是否已激活]
    |
    +-- 失败 → 显示错误信息
    |
    +-- 成功 → UPDATE is_active=1, 清空 token
               |
               v
          [用户可登录]