控制局域网电脑上网的 PHP 哈希表 IP 黑名单过滤算法

<?php
/**
 * 控制局域网电脑上网的哈希表IP黑名单过滤类
 * 基于PHP关联数组实现，支持IP黑名单增删、过期清理、访问拦截判定
 */
class BlacklistHashFilter {
    private $blacklist;          // 哈希表：存储黑名单IP及策略（键：IP，值：[blockDuration, addTime]）
    private $defaultBlockTime;   // 默认限制时长（秒）
    private $expireCheckInterval;// 过期检查间隔（秒）
    private $lastCheckTime;      // 上次检查时间戳
    /**
     * 初始化黑名单过滤器
     * @param int $defaultBlockTime  默认限制时长（秒），默认3600
     * @param int $expireCheckInterval 过期检查间隔（秒），默认60
     */
    public function __construct(int $defaultBlockTime = 3600, int $expireCheckInterval = 60) {
        $this->blacklist = [];
        $this->defaultBlockTime = $defaultBlockTime;
        $this->expireCheckInterval = $expireCheckInterval;
        $this->lastCheckTime = time();
    }
    /**
     * 添加IP到黑名单（控制局域网电脑上网：拦截目标IP）
     * @param string $ip  局域网IP地址
     * @param int $blockDuration  限制时长（秒），未传则用默认值
     * @return bool  添加成功返回true，IP已存在返回false
     */
    public function addBlacklistIP(string $ip, int $blockDuration = 0): bool {
        // 校验IP格式（简化版局域网IP校验：192.168.x.x或10.x.x.x）
        if (!preg_match('/^(192\.168|10)\.\d+\.\d+\.\d+$/', $ip)) {
            throw new InvalidArgumentException("无效的局域网IP地址：{$ip}");
        }
        if (isset($this->blacklist[$ip])) {
            return false; // IP已在黑名单中
        }
        $actualBlockTime = $blockDuration > 0 ? $blockDuration : $this->defaultBlockTime;
        $this->blacklist[$ip] = [
            'blockDuration' => $actualBlockTime,
            'addTime' => time()
        ];
        return true;
    }
    /**
     * 从黑名单移除IP（控制局域网电脑上网：恢复目标IP访问）
     * @param string $ip  局域网IP地址
     * @return bool  移除成功返回true，IP不存在返回false
     */
    public function removeBlacklistIP(string $ip): bool {
        if (!isset($this->blacklist[$ip])) {
            return false;
        }
        unset($this->blacklist[$ip]);
        return true;
    }
    /**
     * 判定IP是否需拦截（控制局域网电脑上网的核心判定方法）
     * @param string $ip  局域网终端IP
     * @return bool  需拦截返回true，允许访问返回false
     */
    public function isIPBlocked(string $ip): bool {
        // 定时执行过期IP清理
        $currentTime = time();
        if ($currentTime - $this->lastCheckTime >= $this->expireCheckInterval) {
            $this->cleanExpiredIPs();
            $this->lastCheckTime = $currentTime;
        }
        // 检查IP是否在黑名单中
        if (!isset($this->blacklist[$ip])) {
            return false;
        }
        // 校验IP限制是否过期
        $ipInfo = $this->blacklist[$ip];
        if ($currentTime - $ipInfo['addTime'] >= $ipInfo['blockDuration']) {
            $this->removeBlacklistIP($ip); // 自动移除过期IP
            return false;
        }
        // 需拦截：控制局域网电脑上网的拦截条件触发
        return true;
    }
    /**
     * 清理过期的黑名单IP（私有方法：内部维护哈希表有效性）
     */
    private function cleanExpiredIPs(): void {
        $currentTime = time();
        foreach ($this->blacklist as $ip => $info) {
            if ($currentTime - $info['addTime'] >= $info['blockDuration']) {
                unset($this->blacklist[$ip]);
            }
        }
    }
    /**
     * 获取当前黑名单列表（用于管理员查看）
     * @return array  黑名单IP及策略
     */
    public function getBlacklist(): array {
        return $this->blacklist;
    }
}
// --------------- 模拟控制局域网电脑上网的场景 ---------------
// 1. 初始化过滤器：默认限制1小时，每60秒清理过期IP
$lanFilter = new BlacklistHashFilter(3600, 60);
// 2. 添加违规IP到黑名单（如192.168.2.105因下载违规文件被限制）
$lanFilter->addBlacklistIP("192.168.2.105");
$lanFilter->addBlacklistIP("10.0.3.22", 1800); // 10.0.3.22限制30分钟
// 3. 模拟3个局域网终端的上网请求
$testIPs = [
    "192.168.2.105",  // 违规IP（应拦截）
    "192.168.2.108",  // 正常IP（应允许）
    "10.0.3.22"       // 违规IP（应拦截）
];
foreach ($testIPs as $ip) {
    $isBlocked = $lanFilter->isIPBlocked($ip);
    $status = $isBlocked ? "拦截（控制局域网电脑上网）" : "允许访问";
    echo "[" . date("Y-m-d H:i:s") . "] 局域网IP {$ip}：{$status}\n";
}
// 4. 模拟180秒后，再次检查10.0.3.22（未到30分钟，仍拦截）
sleep(180);
$isBlocked = $lanFilter->isIPBlocked("10.0.3.22");
$status = $isBlocked ? "拦截（控制局域网电脑上网）" : "允许访问";
echo "[" . date("Y-m-d H:i:s") . "] 局域网IP 10.0.3.22：{$status}\n";
?>