PHP项目怎么实现拉黑功能？

wen java案例 2026-07-21 2

本文目录导读：

PHP项目怎么实现拉黑功能？

核心实现思路
数据库设计
核心PHP代码实现
前端交互示例
进阶安全与性能
完整示例一览
常见问题

在PHP项目中实现拉黑功能,通常涉及数据存储、逻辑判断和交互处理三个核心环节，下面给出几种常见且实用的实现方案。

核心实现思路

数据存储：用户表增加 status 字段，或新建独立的黑名单表。
逻辑判断：在执行关键操作前（如登录、发帖、私信、查看资料），检查是否被拉黑。
交互处理：提供拉黑/取消拉黑的操作入口，并给被封禁用户友好的提示。

数据库设计

方案1：用户表直接扩展（简单，适合小型项目）

在 users 表中增加字段：

ALTER TABLE `users` ADD COLUMN `status` TINYINT(1) DEFAULT 0 COMMENT '0:正常 1:黑名单';

方案2：独立黑名单表（推荐，灵活，支持双向拉黑、拉黑原因、时间等）

CREATE TABLE `blacklist` (
  `id` INT PRIMARY KEY AUTO_INCREMENT,
  `user_id` INT NOT NULL COMMENT '执行拉黑的用户ID',
  `blocked_user_id` INT NOT NULL COMMENT '被拉黑的用户ID',
  `reason` VARCHAR(255) DEFAULT NULL COMMENT '拉黑原因',
  `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  UNIQUE KEY `uk_user_blocked` (`user_id`, `blocked_user_id`)
);

优点：支持双向、多人之间的黑名单关系，存储历史记录，便于扩展（如黑名单分组、有效期）。
适用场景：社交平台、论坛、即时通讯等。

核心PHP代码实现

以下以独立黑名单表方案为例，演示关键逻辑：

拉黑/取消拉黑

// 拉黑用户
function blockUser($currentUserId, $targetUserId, $reason = '') {
    $pdo = getDbConnection(); // 获取数据库连接
    // 防止重复拉黑
    $stmt = $pdo->prepare("INSERT IGNORE INTO blacklist (user_id, blocked_user_id, reason) VALUES (?, ?, ?)");
    return $stmt->execute([$currentUserId, $targetUserId, $reason]);
}
// 取消拉黑
function unblockUser($currentUserId, $targetUserId) {
    $pdo = getDbConnection();
    $stmt = $pdo->prepare("DELETE FROM blacklist WHERE user_id = ? AND blocked_user_id = ?");
    return $stmt->execute([$currentUserId, $targetUserId]);
}

检测是否被拉黑

// 检测用户B是否被用户A拉黑（即检测A拉黑了B）
function isBlocked($userIdA, $userIdB) {
    $pdo = getDbConnection();
    $stmt = $pdo->prepare("SELECT 1 FROM blacklist WHERE user_id = ? AND blocked_user_id = ? LIMIT 1");
    $stmt->execute([$userIdA, $userIdB]);
    return (bool)$stmt->fetchColumn();
}
// 更常用的检测：双方关系(双向检测)
function checkBlockRelation($userIdA, $userIdB) {
    $pdo = getDbConnection();
    $stmt = $pdo->prepare("SELECT user_id FROM blacklist WHERE (user_id = ? AND blocked_user_id = ?) OR (user_id = ? AND blocked_user_id = ?) LIMIT 1");
    $stmt->execute([$userIdA, $userIdB, $userIdB, $userIdA]);
    return $stmt->fetchColumn(); // 返回拉黑发起方的ID，或null
}

在业务逻辑中拦截

例如用户查看对方资料、发送私信时：

// 在私信发送前检查
function sendMessage($fromUserId, $toUserId, $content) {
    // 双向黑名单检查
    $blockerId = checkBlockRelation($fromUserId, $toUserId);
    if ($blockerId) {
        // 如果发起方是自己，说明发送方拉黑了接收方，一般允许自己不再接收消息？需根据业务定义
        // 通常逻辑：任意一方拉黑了对方，均不允许发送消息
        throw new \Exception('无法发送消息：对方已将你拉黑或你已将对方拉黑');
    }
    // 继续发送消息...
}

前端交互示例

以最简单的按钮 + AJAX 为例：

<button class="block-btn" data-user-id="123">拉黑</button>

$('.block-btn').click(function() {
    let targetUserId = $(this).data('user-id');
    $.post('/api/block.php', {action: 'block', target_id: targetUserId}, function(res) {
        if (res.success) {
            alert('已拉黑');
        }
    });
});

PHP处理请求：

// api/block.php
session_start();
if (!isset($_SESSION['user_id'])) {
    die(json_encode(['success' => false, 'msg' => '未登录']));
}
$currentUserId = $_SESSION['user_id'];
$targetUserId  = intval($_POST['target_id']);
$action        = $_POST['action'] ?? '';
if ($action === 'block') {
    blockUser($currentUserId, $targetUserId);
    echo json_encode(['success' => true]);
} elseif ($action === 'unblock') {
    unblockUser($currentUserId, $targetUserId);
    echo json_encode(['success' => true]);
}

进阶安全与性能

缓存：对于高频查询（如拉黑名单列表），可以使用 Redis 缓存用户的被拉黑ID集合，减少数据库压力。

// 伪代码：缓存拉黑列表
$blockedIds = $redis->sMembers("user:{$userId}:blocked");
if (empty($blockedIds)) {
    // 从DB加载并缓存
    $blockedIds = loadFromDB(...);
    $redis->sAddArray("user:{$userId}:blocked", $blockedIds);
    $redis->expire("user:{$userId}:blocked", 3600);
}

批量检测：当需要判断大量用户是否被拉黑时，使用 IN 查询 + 缓存批量处理。
拉黑屏蔽范围：根据业务定义被拉黑后影响哪些功能（私信、评论、查看动态、关注等），可以在 blacklist 表增加 type 字段区分。

完整示例一览

场景	简单方案（单用户表）	推荐方案（独立黑名单表）
数据存储	`users.status = 1`	`blacklist` 表
拉黑操作	`UPDATE users SET status=1`	`INSERT INTO blacklist`
检查逻辑	`SELECT status FROM users`	`SELECT 1 FROM blacklist WHERE user_id=? AND blocked_user_id=?`
灵活性	低（无法记录原因、时间，也无法双向）	高（支持双向、时间、原因、分组）