您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 相關知識

PHP 純真 IP 庫（qqwry.dat）離線查詢實現：二分搜索 + 記錄區解析完整代碼

編輯：PHP 相關知識

純真 IP 數據庫（qqwry.dat）是國內最經典的離線 IP 歸屬地查詢庫，體積小（~8MB）、無網絡依賴、查詢快（毫秒級）。本文深度解析其文件格式，提供可直接生產使用的 PHP 類，支援 IPv4 查詢、域名自動解析、編碼自動轉換。

qqwry.dat 文件結構速覽

區塊	偏移	結構	說明
文件頭	0-7	首索引偏移(4B) + 尾索引偏移(4B)	小端序
索引區	首索引~尾索引	每條 7B：起始IP(4B) + 記錄區偏移(3B)	按起始IP升序，固定長度
記錄區	索引區後	結束IP(4B) + 國家/地區1 + 國家/地區2	字符串以 `\0` 結尾，可能有重定向標誌 0x01/0x02

核心類完整代碼

<?php
class IpLocation {
    private $fp;
    private int $firstIndexOffset;
    private int $lastIndexOffset;
    private int $totalRecords;

    public function __construct(string $datFile = 'qqwry.dat') {
        if (!file_exists($datFile)) {
            throw new RuntimeException("qqwry.dat 不存在，請下載至當前目錄");
        }
        $this->fp = fopen($datFile, 'rb');
        $this->firstIndexOffset = $this->readInt4();
        $this->lastIndexOffset  = $this->readInt4();
        $this->totalRecords = ($this->lastIndexOffset - $this->firstIndexOffset) / 7;
        register_shutdown_function([$this, 'close']);
    }

    public function close(): void { fclose($this->fp); }

    // 讀 4 字節無符號整數（小端序）
    private function readInt4(): int {
        $bin = fread($this->fp, 4);
        return unpack('V', $bin)[1]; // V = little-endian unsigned long
    }

    // 讀 3 字節偏移（補齊 4 字節再 unpack）
    private function readOffset3(): int {
        $bin = fread($this->fp, 3) . "\0";
        return unpack('V', $bin)[1];
    }

    // 讀取以 \0 結尾的字符串
    private function readString(): string {
        $str = '';
        while (($ch = fread($this->fp, 1)) !== "\0") {
            $str .= $ch;
        }
        return $str;
    }

    // 讀取標誌位（1 字節）
    private function readFlag(): string { return fread($this->fp, 1); }

    // IP 字串轉 4 字節大端序二進制（用於與索引區比較）
    private function ip2bin(string $ip): string {
        return pack('N', ip2long($ip)); // N = big-endian unsigned long
    }

    // 二分查找索引區
    private function searchIndex(string $ipBin): int {
        $ip = $ipBin;
        $low = 0;
        $high = $this->totalRecords - 1;
        $offset = $this->lastIndexOffset; // 默認最後一條

        while ($low <= $high) {
            $mid = (($low + $high) >> 1);
            fseek($this->fp, $this->firstIndexOffset + $mid * 7);
            $startIpBin = fread($this->fp, 4); // 小端序
            $startIpBin = strrev($startIpBin); // 轉大端序比較

            if ($ip < $startIpBin) {
                $high = $mid - 1;
            } else {
                // 讀取記錄區偏移，獲取結束 IP
                fseek($this->fp, $this->firstIndexOffset + $mid * 7 + 4);
                $recOffset = $this->readOffset3();
                fseek($this->fp, $recOffset);
                $endIpBin = strrev(fread($this->fp, 4));
                if ($ip > $endIpBin) {
                    $low = $mid + 1;
                } else {
                    $offset = $this->firstIndexOffset + $mid * 7;
                    break;
                }
            }
        }
        return $offset;
    }

    // 解析記錄區（處理重定向 0x01/0x02）
    private function parseRecord(int $recOffset): array {
        fseek($this->fp, $recOffset);
        $endIp = long2ip($this->readInt4());
        $flag = ord($this->readFlag());
        $country = $area = '';

        switch ($flag) {
            case 0x01: // 國家重定向
                $countryOffset = $this->readOffset3();
                $flag2 = ord($this->readFlag());
                if ($flag2 === 0x02) { // 雙重定向
                    $areaOffset = $this->readOffset3();
                    fseek($this->fp, $countryOffset);
                    $country = $this->readString();
                    fseek($this->fp, $areaOffset);
                    $area = $this->readString();
                } else {
                    fseek($this->fp, $countryOffset);
                    $country = $this->readString();
                    $area = $this->parseRecord($recOffset + 4)['area']; // 區域可能再重定向
                }
                break;
            case 0x02: // 區域重定向
                $areaOffset = $this->readOffset3();
                $country = $this->readString();
                fseek($this->fp, $areaOffset);
                $area = $this->readString();
                break;
            default: // 無重定向
                fseek($this->fp, $recOffset + 4);
                $country = $this->readString();
                $area = $this->readString();
                break;
        }
        // 過濾純真廣告
        if (strpos($country, 'cz88.net') !== false) $country = '未知';
        if (strpos($area, 'cz88.net') !== false) $area = '';
        return ['country' => $country, 'area' => $area, 'end_ip' => $endIp];
    }

    // 公開查詢接口
    public function query(string $ipOrDomain): ?array {
        $ip = gethostbyname($ipOrDomain); // 域名自動解析
        if (!filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) return null;
        $ipBin = $this->ip2bin($ip);
        $indexOffset = $this->searchIndex($ipBin);
        fseek($this->fp, $indexOffset);
        $startIp = long2ip($this->readInt4());
        fseek($this->fp, $indexOffset + 4);
        $recOffset = $this->readOffset3();
        $record = $this->parseRecord($recOffset);
        return [
            'ip' => $ip,
            'start_ip' => $startIp,
            'end_ip' => $record['end_ip'],
            'country' => $record['country'],
            'area' => $record['area'],
        ];
    }
}

// 使用示例
$ip = new IpLocation('qqwry.dat');
print_r($ip->query('61.129.51.27'));
print_r($ip->query('www.baidu.com'));