本文目录导读:

在PHP项目中实现“累计犯规次数达到危险阈值”的判定,核心思路是:记录犯规次数 + 设定阈值 + 触发预警,下面给出一个完整的实现方案。
数据库设计
-- 犯规记录表
CREATE TABLE foul_records (
id INT AUTO_INCREMENT PRIMARY KEY,
user_id INT NOT NULL COMMENT '用户ID',
foul_type VARCHAR(50) COMMENT '犯规类型',
foul_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '犯规时间',
description VARCHAR(255) COMMENT '描述',
INDEX idx_user (user_id)
);
-- 用户犯规统计表(可选,用于快速查询)
CREATE TABLE user_foul_stats (
user_id INT PRIMARY KEY,
total_count INT DEFAULT 0 COMMENT '累计犯规次数',
recent_count INT DEFAULT 0 COMMENT '近期犯规次数',
last_foul_time DATETIME,
danger_level TINYINT DEFAULT 0 COMMENT '0正常 1警告 2危险 3封禁',
updated_at DATETIME
);
核心判定逻辑
<?php
class FoulService
{
// 危险阈值配置
const THRESHOLDS = [
'warning' => 3, // 警告
'danger' => 5, // 危险
'banned' => 10, // 封禁
];
// 时间窗口(近期犯规统计周期,单位:天)
const RECENT_DAYS = 30;
private PDO $db;
public function __construct(PDO $db)
{
$this->db = $db;
}
/**
* 记录一次犯规并返回危险等级
*/
public function recordFoul(int $userId, string $foulType, string $desc = ''): array
{
// 1. 写入犯规记录
$stmt = $this->db->prepare(
"INSERT INTO foul_records (user_id, foul_type, description) VALUES (?, ?, ?)"
);
$stmt->execute([$userId, $foulType, $desc]);
// 2. 统计累计次数
$totalCount = $this->getTotalCount($userId);
// 3. 统计近期次数
$recentCount = $this->getRecentCount($userId);
// 4. 判定危险等级
$dangerLevel = $this->evaluateDangerLevel($totalCount, $recentCount);
// 5. 更新统计表
$this->updateStats($userId, $totalCount, $recentCount, $dangerLevel);
// 6. 若达到危险,触发预警
if ($dangerLevel >= 2) {
$this->triggerAlert($userId, $dangerLevel, $totalCount, $recentCount);
}
return [
'total_count' => $totalCount,
'recent_count' => $recentCount,
'danger_level' => $dangerLevel,
'is_dangerous' => $dangerLevel >= 2,
'level_name' => $this->levelName($dangerLevel),
];
}
/**
* 危险等级判定(可综合总量和近期量)
*/
private function evaluateDangerLevel(int $total, int $recent): int
{
// 近期高发直接判定危险(例如30天内≥3次)
if ($recent >= self::THRESHOLDS['warning']) {
return 2;
}
if ($total >= self::THRESHOLDS['banned']) {
return 3;
}
if ($total >= self::THRESHOLDS['danger']) {
return 2;
}
if ($total >= self::THRESHOLDS['warning']) {
return 1;
}
return 0;
}
private function getTotalCount(int $userId): int
{
$stmt = $this->db->prepare("SELECT COUNT(*) FROM foul_records WHERE user_id = ?");
$stmt->execute([$userId]);
return (int)$stmt->fetchColumn();
}
private function getRecentCount(int $userId): int
{
$stmt = $this->db->prepare(
"SELECT COUNT(*) FROM foul_records
WHERE user_id = ? AND foul_time >= DATE_SUB(NOW(), INTERVAL ? DAY)"
);
$stmt->execute([$userId, self::RECENT_DAYS]);
return (int)$stmt->fetchColumn();
}
private function updateStats(int $userId, int $total, int $recent, int $level): void
{
$stmt = $this->db->prepare(
"INSERT INTO user_foul_stats (user_id, total_count, recent_count, danger_level, updated_at)
VALUES (?, ?, ?, ?, NOW())
ON DUPLICATE KEY UPDATE
total_count = VALUES(total_count),
recent_count = VALUES(recent_count),
danger_level = VALUES(danger_level),
updated_at = VALUES(updated_at)"
);
$stmt->execute([$userId, $total, $recent, $level]);
}
/**
* 触发预警(发邮件/短信/通知管理员)
*/
private function triggerAlert(int $userId, int $level, int $total, int $recent): void
{
$msg = sprintf(
"【犯规预警】用户%d 累计犯规%d次,近%d天%d次,危险等级:%s",
$userId, $total, self::RECENT_DAYS, $recent, $this->levelName($level)
);
// 示例:写日志 + 发送通知
error_log($msg);
// Mailer::send('admin@example.com', '犯规预警', $msg);
}
private function levelName(int $level): string
{
return match ($level) {
0 => '正常',
1 => '警告',
2 => '危险',
3 => '封禁',
default => '未知',
};
}
}
使用示例
$db = new PDO('mysql:host=localhost;dbname=app;charset=utf8mb4', 'root', '');
$service = new FoulService($db);
$result = $service->recordFoul(1001, 'late_submit', '迟到提交');
if ($result['is_dangerous']) {
// 拦截操作 / 提示用户 / 限制权限
echo "当前用户处于{$result['level_name']}状态,请限制操作";
}
业务层面建议
阈值设置原则
- 警告:轻微提醒,一般 3 次左右
- 危险:限制部分功能,一般 5 次
- 封禁:严重处理,一般 10 次
判定维度建议
别只看累计总量,建议综合三个维度:
// 综合策略示例
$isDanger =
$totalCount >= 5 // 累计达5次
|| $recentCount >= 3 // 30天内达3次(高频)
|| $lastFoulWithinHour >= 2; // 1小时内连续2次(连续违规)
化解/恢复机制
// 定期衰减或人工清零
public function resetFoul(int $userId): void {
$this->db->prepare(
"UPDATE user_foul_stats SET total_count=0, recent_count=0, danger_level=0 WHERE user_id=?"
)->execute([$userId]);
}
性能优化
- 用
user_foul_stats缓存表避免每次COUNT(*) - 对
foul_records.foul_time建立索引 - 高频查询可用 Redis 计数
注意事项
- 避免误判:区分犯规类型,不同严重程度应加权(例如严重犯规=3分,轻微=1分)
- 可申诉:提供申诉入口,人工核销
- 留痕:所有预警触发记录日志,便于审计
- 合规:涉及封禁需符合平台规则并通知用户
如果你能说明具体业务场景(如考试系统、内容审核、游戏违规等),我可以给出更贴合的阈值和判定策略。
友情链接
版权声明:本站文章为原创整理,转载请注明出处。