萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP IP 黑白名單過濾實作:支援 CIDR 與範圍匹配的完整類別

簡易版:文字檔白名單檢查

適用於「僅允許特定 IP 存取」的輕量需求,支援 C 類網段(如 192.168)。

<?php
$ip = $_SERVER['REMOTE_ADDR'];
$ipArray = file('ip.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);

foreach ($ipArray as $ipTest) {
    if (strpos($ip, $ipTest) === 0) { // 前綴匹配
        echo 'ok'; // 允許存取
        // 執行相關業務邏輯
        exit;
    }
}
echo 'Access Denied';
?>

ip.txt 範例內容:

192.168
211.67.188
211.67.191.25

進階版:block_ip 類別(支援範圍、萬用字元、黑名單模式)

<?php
class BlockIp {
    private $rules = [
        '192.168.1.1',      // 單一 IP
        '210.10.2.1-20',    // IP 範圍
        '222.34.4.*',       // 萬用字元
    ];
    
    public function checkIP() {
        $patterns = $this->buildPatterns();
        $clientIp = $this->getClientIp();
        
        foreach ($patterns as $pattern) {
            if (preg_match($pattern, $clientIp)) {
                exit('IP Error: ' . $clientIp);
            }
        }
    }
    
    private function buildPatterns() {
        $patterns = [];
        foreach ($this->rules as $rule) {
            $regex = $this->ruleToRegex($rule);
            $patterns[] = '/' . $regex . '/';
        }
        return $patterns;
    }
    
    private function ruleToRegex($rule) {
        // 處理範圍 1-20
        if (strpos($rule, '-') !== false) {
            $parts = explode('.', $rule);
            $regexParts = [];
            foreach ($parts as $part) {
                if (strpos($part, '-') !== false) {
                    [$start, $end] = explode('-', $part);
                    $regexParts[] = '(' . implode('|', range($start, $end)) . ')';
                } else {
                    $regexParts[] = $part;
                }
            }
            return implode('\.', $regexParts);
        }
        
        // 處理萬用字元 *
        $rule = str_replace('.', '\.', $rule);
        $rule = str_replace('*', '\d{1,3}', $rule);
        return $rule;
    }
    
    private function getClientIp() {
        $headers = ['HTTP_CLIENT_IP', 'HTTP_X_FORWARDED_FOR', 'REMOTE_ADDR'];
        foreach ($headers as $header) {
            if (!empty($_SERVER[$header]) && $_SERVER[$header] !== 'unknown') {
                // 取第一個非代理 IP
                $ips = explode(',', $_SERVER[$header]);
                return trim($ips[0]);
            }
        }
        return 'unknown';
    }
}

// 使用方式
$blocker = new BlockIp();
$blocker->checkIP();
// 通過檢查才會繼續執行後續程式
?>

關鍵設計重點

  • 正則轉換:將人類可讀的規則(範圍、萬用字元)編譯為高效正則表達式。
  • 代理支援:正確解析 X-Forwarded-For 取得真實客戶端 IP。
  • 效能考量:規則編譯可快取,避免每請求重複建構正則。
  • 擴充性:規則可從資料庫/快取讀取,支援動態更新。

部署建議

  1. 放置於應用程式進入點(如 index.php 最上方)。
  2. 白名單模式適合後台管理介面;黑名單模式適合防禦已知攻擊源。
  3. 搭配 Web Server 層面封鎖(Nginx deny、Apache Require not ip)效能更佳。
copyright © 萬盛學電腦網 all rights reserved