PHP 离线 IP 定位库 IP2region

ip2region/
├──src/                    # 核心源码
│   ├──Ip2Region.php      # 主类，支持 IPv4/IPv6 双协议
│   ├──XdbSearcher.php    # 官方 xdb 查询器封装
│   └──ChunkedDbHelper.php# 分片文件管理助手
├──db/                    # 分片数据库文件（自动生成）
│   ├──ip2region_v4.xdb.part1    # IPv4 数据库分片
│   └──ip2region_v6.xdb.part*    # IPv6 数据库分片（多个文件）
├──tools/                 # 工具脚本
│   ├──split_db.php       # 数据库分片工具（重要！）
│   ├──ip2region_v4.xdb   # IPv4 完整数据库（需要下载）
│   └──ip2region_v6.xdb   # IPv6 完整数据库（需要下载）
├──tests/                 # 测试文件
│   └──demo.php           # 演示程序
├──function.php           # 全局函数入口
├──composer.json          # Composer 配置
└──README.md              # 项目文档

# 安装 V3.0 版本（推荐，功能完整）
composer require zoujingli/ip2region:^3.0

# 或安装 V2.0 版本（轻量级，仅 IPv4）
composer require zoujingli/ip2region:^2.0

# 下载完整数据库文件到 tools/ 目录
# 然后生成分片文件
php tools/split_db.php v4    # IPv4 分片
php tools/split_db.php v6    # IPv6 分片

<?php
require'vendor/autoload.php';

// 最简单的使用方式
echo ip2region('61.142.118.231') . "\n"; // 中国广东省中山市【电信】
echo ip2region('2001:4860:4860::8888') . "\n"; // 美国加利福尼亚州圣克拉拉【专线用户】

// 使用不同查询方法
echo ip2region('61.142.118.231', 'search') . "\n"; // 中国|广东省|中山市|电信
echo ip2region('61.142.118.231', 'memory') . "\n"; // 返回数组格式

// 或者使用类方式
$ip2region = new \Ip2Region();
echo $ip2region->simple('61.142.118.231') . "\n"; // 中国广东省中山市【电信】

// 使用自定义数据库（可选）
$ip2region = new \Ip2Region('file', '/path/to/ip2region_v4.xdb', '/path/to/ip2region_v6.xdb');
echo $ip2region->simple('8.8.8.8') . "\n"; // 美国【Level3】
?>

# 测试 IPv4 查询
composer test:ipv4

# 测试 IPv6 查询
composer test:ipv6

# 测试不同查询方法
composer test:search    # 详细查询
composer test:memory    # 内存查询

# 查询指定 IP
composer query 61.142.118.231
composer query:search 61.142.118.231
composer query:memory 61.142.118.231

# 运行演示程序
composer demo

<?php
require'vendor/autoload.php';

// 简单查询
echo ip2region('61.142.118.231') . "\n";        // 中国广东省中山市【电信】
echo ip2region('2001:4860:4860::8888') . "\n"; // 美国加利福尼亚州圣克拉拉【专线用户】

// 使用不同查询方法
echo ip2region('61.142.118.231', 'search') . "\n"; // 中国|广东省|中山市|电信
echo ip2region('61.142.118.231', 'memory') . "\n"; // 返回数组格式

// 批量查询
$ips = ['61.142.118.231', '114.114.114.114', '2001:4860:4860::8888'];
foreach ($ips as $ip) {
    echo"$ip => " . ip2region($ip) . "\n";
}
?>

<?php
require'vendor/autoload.php';

try {
    // 默认模式（使用分片数据库）
    $ip2region = new \Ip2Region();
    
    // 如需使用自定义数据库，请参考下面的"自定义数据库配置"部分
    // $ip2region = new \Ip2Region('file', '/path/to/your/ip2region_v4.xdb', '/path/to/your/ip2region_v6.xdb');

    // 基础查询
    echo $ip2region->simple('61.142.118.231') . "\n";
    echo $ip2region->search('2001:4860:4860::8888') . "\n";

    // 获取详细信息
    $info = $ip2region->getIpInfo('61.142.118.231');
    print_r($info);
    // 输出: Array(
    //   [country] => 中国
    //   [region] => 广东省
    //   [province] => 中山市
    //   [city] => 电信
    //   [isp] =>
    //   [ip] => 61.142.118.231
    //   [version] => v4
    // )

    // 批量查询
    $results = $ip2region->batchSearch(['61.142.118.231', '114.114.114.114']);
    print_r($results);

    // 性能监控
    $stats = $ip2region->getStats();
    echo"内存使用: " . $stats['memory_usage'] . " bytes\n";
    echo"IPv4 已加载: " . ($stats['v4_loaded'] ? '是' : '否') . "\n";
    echo"IPv6 已加载: " . ($stats['v6_loaded'] ? '是' : '否') . "\n";

} catch (Exception $e) {
    echo"错误: " . $e->getMessage() . "\n";
}
?>

<?php
require'vendor/autoload.php';

try {
    // 使用自定义数据库路径（建议使用绝对路径）
    $ip2region = new \Ip2Region('file', '/path/to/your/ip2region_v4.xdb', '/path/to/your/ip2region_v6.xdb');

    // 查询IP
    echo $ip2region->simple('8.8.8.8') . "\n";

    // 检查是否使用自定义数据库
    $customStatus = $ip2region->isUsingCustomDb();
    echo"IPv4 使用自定义数据库: " . ($customStatus['v4'] ? '是' : '否') . "\n";
    echo"IPv6 使用自定义数据库: " . ($customStatus['v6'] ? '是' : '否') . "\n";

    // 动态设置数据库路径
    $ip2region->setCustomDbPaths('/path/to/v4.xdb', '/path/to/v6.xdb');

    // 获取数据库配置信息
    $dbInfo = $ip2region->getDatabaseInfo();
    echo"IPv4 路径: " . ($dbInfo['custom_v4_path'] ?: '默认分片') . "\n";
    echo"IPv6 路径: " . ($dbInfo['custom_v6_path'] ?: '默认分片') . "\n";

} catch (Exception $e) {
    echo"错误: " . $e->getMessage() . "\n";
}
?>