计科知识库 计科知识库 8天前

使用ip2region实现评论者IP归属地

php

为什么选择ip2region？

ip2region在今年9月发布了v3.0版本，开始真正支持IPv6：

  1. IPv6能定位到地级市（虽然准确度还有提升空间）
  2. 数据数据格式规范，看着舒服
  3. 免费开源
  4. 项目还在持续更新维护

在主题文件夹中创建ip2region.php，添加下面的IP转换代码，注意代码中引用的文件路径。

  1. <?php
  2. /**
  3.  * Ip2region 是一个离线 IP 数据管理框架和定位库，支持 IPv4 和 IPv6。此代码版本支持 IPv4 和 IPv6。
  4.  *
  5.  * 官方社区：https://ip2region.net/
  6.  */
  8. require_once __DIR__ . '/xdb/Searcher.class.php';
  10. use \ip2region\xdb\Util;
  11. use \ip2region\xdb\Searcher;
  13. //初始化，使用向量索引
  14. function init_ip2region_vector($dbFile) {
  15.     if (!file_exists($dbFile)) {
  16.         error_log("IP数据库文件不存在: " . $dbFile);
  17.         return null;
  18.     }
  20.     try {
  21.         // 读取文件头，获取版本信息
  22.         $header = Util::loadHeaderFromFile($dbFile);
  23.         $version = Util::versionFromHeader($header);
  25.         // 加载向量索引
  26.         $vIndex = Util::loadVectorIndexFromFile($dbFile);
  28.         // 创建 Searcher
  29.         return Searcher::newWithVectorIndex($version, $dbFile, $vIndex);
  30.     } catch (Exception $e) {
  31.         error_log("IP数据库初始化失败: " . $e->getMessage());
  32.         return null;
  33.     }
  34. }
  36. // 全局 Searcher，显式初始化为 null
  37. global $ip2region_searcher_v4, $ip2region_searcher_v6;
  38. $ip2region_searcher_v4 = $ip2region_searcher_v4 ?? null;
  39. $ip2region_searcher_v6 = $ip2region_searcher_v6 ?? null;
  41. //获取 IPv4 或 IPv6 Searcher
  42. function get_ip_searcher($ip) {
  43.     global $ip2region_searcher_v4, $ip2region_searcher_v6;
  45.     // 判断 ip 类型
  46.     $isIpv6 = filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6);
  47.     $isIpv4 = filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4);
  49.     // 尝试加载 IPv6 searcher
  50.     if ($isIpv6) {
  51.         if ($ip2region_searcher_v6 === null) {
  52.             $dbFile_v6 = __DIR__ . '/data/ip2region_v6.xdb';
  53.             $ip2region_searcher_v6 = init_ip2region_vector($dbFile_v6);
  54.         }
  55.         if ($ip2region_searcher_v6 !== null) {
  56.             return $ip2region_searcher_v6;
  57.         }
  58.         // 如果 IPv6 DB 不可用，继续尝试加载 IPv4（fallback降级）
  59.     }
  61.     // IPv4 路径（或者作为fallback降级）
  62.     if ($ip2region_searcher_v4 === null) {
  63.         $dbFile_v4 = __DIR__ . '/data/ip2region_v4.xdb';
  64.         $ip2region_searcher_v4 = init_ip2region_vector($dbFile_v4);
  65.     }
  67.     return $ip2region_searcher_v4;
  68. }
  70. //判断 IP 类型
  71. function get_ip_type($ip) {
  72.     if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
  73.         return 'ipv4';
  74.     } elseif (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) {
  75.         return 'ipv6';
  76.     }
  77.     return false;
  78. }
  80. //判断内网IP并返回显示文本
  81. function is_private_ip($ip) {
  82.     $ip_type = get_ip_type($ip);
  84.     if ($ip_type === 'ipv4') {
  85.         if (filter_var(
  86.             $ip,
  87.             FILTER_VALIDATE_IP,
  88.             FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE
  89.         ) === false) {
  90.             return '内网IP';
  91.         }
  92.     } elseif ($ip_type === 'ipv6') {
  93.         if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE) === false) {
  94.             return '内网IP';
  95.         }
  96.         if ($ip === '::1') {
  97.             return '内网IP';
  98.         }
  99.         if (preg_match('/^fe80:/i', $ip)) {
  100.             return '内网IP';
  101.         }
  102.     }
  103.     return false;
  104. }
  106. //IP转换函数
  107. function convertip($ip, $withIsp = false, $simpleMode = false) {
  108.     if (!$ip) return '火星';
  110.     // 检查内网IP
  111.     $private_result = is_private_ip($ip);
  112.     if ($private_result !== false) {
  113.         return $private_result;
  114.     }
  116.     // 获取 searcher（延迟加载、并可降级）
  117.     $searcher = get_ip_searcher($ip);
  118.     if ($searcher === null) {
  119.         return '火星'; // 数据库不存在或加载失败
  120.     }
  122.     try {
  123.         $region = $searcher->search($ip);
  124.     } catch (Exception $e) {
  125.         return '火星';
  126.     }
  128.     $parts = explode('|', $region);
  129.     $country = ($parts[0] !== '0') ? $parts[0] : '';
  130.     $province = ($parts[1] !== '0') ? $parts[1] : '';
  131.     $city = ($parts[2] !== '0') ? $parts[2] : '';
  132.     $isp = ($parts[3] !== '0') ? $parts[3] : '';
  134.     $resultParts = [];
  136.     // 处理 "中国|0|0|ISP" 特殊情况
  137.     if ($country === '中国' && $province === '' && $city === '') {
  138.         $resultParts[] = '中国';
  139.         if ($withIsp && $isp) {
  140.             $resultParts[] = ' ' . $isp;
  141.         }
  142.         return implode('', $resultParts);
  143.     }
  145.     // 处理中国的专属逻辑
  146.     if ($country === '中国') {
  147.         // 直辖市列表
  148.         $municipalities = ['北京', '上海', '天津', '重庆'];
  150.         // 直辖市逻辑
  151.         if (in_array($province, $municipalities) || in_array($city, $municipalities)) {
  152.             $resultParts[] = $city ?: $province;
  153.         } else {
  154.             // 普通省份逻辑
  155.             if ($province === $city) {
  156.                 $resultParts[] = $city;
  157.             } else {
  158.                 if ($province) $resultParts[] = $province;
  159.                 if (!$simpleMode && $city) $resultParts[] = $city;
  160.             }
  161.         }
  162.     } else {
  163.         // 国外逻辑
  164.         if ($country) $resultParts[] = $country;
  165.         if ($province) $resultParts[] = $province;
  166.         if (!$simpleMode && $city) $resultParts[] = $city;
  167.     }
  169.     // 可选显示网络ISP
  170.     if ($withIsp && $isp) {
  171.         $resultParts[] = ' ' . $isp;
  172.     }
  174.     // 兜底，防止结果为空
  175.     if (empty($resultParts)) {
  176.         return $country ?: '火星';
  177.     }
  179.     return implode('', $resultParts);
  180. }
  182. //简版 - 国内只显示省，国外显示国家 + 省
  183. function convertipsimple($ip, $withIsp = false) {
  184.     return convertip($ip, $withIsp, true);
  185. }
  187. ?>

在主题中加载

  1. require get_template_directory() . '/ip2region.php';

在评论中调用

想在评论里显示地理位置？用这几个函数就行：

  1. // 显示省市（无运营商）
  2. echo convertip(get_comment_author_IP());
  4. // 显示省市 + 运营商
  5. echo convertip(get_comment_author_IP(), true);
  7. // 只显示省份
  8. echo convertipsimple(get_comment_author_IP());
  10. // 只显示省份 + 运营商，
  11. echo convertipsimple(get_comment_author_IP(), true);
  13. //如果是国外，以上都会加上国家，只有中国时会过滤一下

只支持IPv4的版本

有些博客的服务器没有配置支持IPv6，那么其实是不会有IPv6的评论的，这样我们就只需支持IPv4就可以。其他不变，当然IPv6的数据库也就不需要了，将第2步的代码换成下面的代码就行。

  1. <?php
  2. /**
  3.  * Ip2region 是一个离线 IP 数据管理框架和定位库，支持 IPv4 和 IPv6。此代码版本只支持 IPv4 。
  4.  *
  5.  * 官方社区：https://ip2region.net/
  6.  */
  8. require_once __DIR__ . '/xdb/Searcher.class.php';
  10. use \ip2region\xdb\Util;
  11. use \ip2region\xdb\Searcher;
  13. // 全局 Searcher
  14. global $ip2region_searcher_v4;
  15. $ip2region_searcher_v4 = null;
  17. // 初始化 IPv4 Searcher（向量索引模式）
  18. function init_ip2region_vector($dbFile) {
  19.     if (!file_exists($dbFile)) {
  20.         error_log("IP数据库文件不存在: " . $dbFile);
  21.         return null;
  22.     }
  23.     try {
  24.         // 读取文件头，获取版本信息
  25.         $header = Util::loadHeaderFromFile($dbFile);
  26.         $version = Util::versionFromHeader($header);
  28.         // 加载向量索引
  29.         $vIndex = Util::loadVectorIndexFromFile($dbFile);
  31.         // 创建 Searcher
  32.         return Searcher::newWithVectorIndex($version, $dbFile, $vIndex);
  33.     } catch (Exception $e) {
  34.         error_log("IP数据库初始化失败: " . $e->getMessage());
  35.         return null;
  36.     }
  37. }
  39. // 获取 IPv4 searcher
  40. function get_ip_searcher() {
  41.     global $ip2region_searcher_v4;
  42.     if ($ip2region_searcher_v4 === null) {
  43.         $dbFile_v4 = __DIR__ . '/data/ip2region_v4.xdb';
  44.         $ip2region_searcher_v4 = init_ip2region_vector($dbFile_v4);
  45.     }
  46.     return $ip2region_searcher_v4;
  47. }
  49. // 检查内网 IPv4
  50. function is_private_ip($ip) {
  51.     return filter_var(
  52.         $ip,
  53.         FILTER_VALIDATE_IP,
  54.         FILTER_FLAG_IPV4 | FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE
  55.     ) === false;
  56. }
  58. // 主转换函数
  59. function convertip($ip, $withIsp = false, $simpleMode = false) {
  60.     if (!$ip) return '火星';
  61.     if (!filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
  62.         return '火星';
  63.     }
  65.     // 内网IP
  66.     if (is_private_ip($ip)) {
  67.         return '内网IP';
  68.     }
  70.     // 获取 Searcher
  71.     $searcher = get_ip_searcher();
  72.     if ($searcher === null) {
  73.         return '火星';
  74.     }
  76.     // 查询 IP
  77.     try {
  78.         $region = $searcher->search($ip);
  79.     } catch (Exception $e) {
  80.         return '火星';
  81.     }
  83.     $parts = explode('|', $region);
  84.     $country = ($parts[0] !== '0') ? $parts[0] : '';
  85.     $province = ($parts[1] !== '0') ? $parts[1] : '';
  86.     $city = ($parts[2] !== '0') ? $parts[2] : '';
  87.     $isp = ($parts[3] !== '0') ? $parts[3] : '';
  89.     $resultParts = [];
  91.     // 处理 "中国|0|0|ISP" 特殊情况
  92.     if ($country === '中国' && $province === '' && $city === '') {
  93.         $resultParts[] = '中国';
  94.         if ($withIsp && $isp) {
  95.             $resultParts[] = ' ' . $isp;
  96.         }
  97.         return implode('', $resultParts);
  98.     }
  100.     // 处理中国的专属逻辑
  101.     if ($country === '中国') {
  102.         // 直辖市列表
  103.         $municipalities = ['北京', '上海', '天津', '重庆'];
  105.         // 直辖市逻辑
  106.         if (in_array($province, $municipalities) || in_array($city, $municipalities)) {
  107.             $resultParts[] = $city ?: $province;
  108.         } else {
  109.             // 普通省份逻辑
  110.             if ($province === $city) {
  111.                 $resultParts[] = $city;
  112.             } else {
  113.                 if ($province) $resultParts[] = $province;
  114.                 if (!$simpleMode && $city) $resultParts[] = $city;
  115.             }
  116.         }
  117.     } else {
  118.         // 国外逻辑
  119.         if ($country) $resultParts[] = $country;
  120.         if ($province) $resultParts[] = $province;
  121.         if (!$simpleMode && $city) $resultParts[] = $city;
  122.     }
  124.     // 可选显示网络ISP
  125.     if ($withIsp && $isp) {
  126.         $resultParts[] = ' ' . $isp;
  127.     }
  129.     // 兜底，防止结果为空
  130.     if (empty($resultParts)) {
  131.         return $country ?: '火星';
  132.     }
  134.     return implode('', $resultParts);
  135. }
  137. //简版 - 国内只显示省，国外显示国家 + 省
  138. function convertipsimple($ip, $withIsp = false) {
  139.     return convertip($ip, $withIsp, true);
  140. }
  142. ?>

参考出处
https://www.weisay.com/blog/get-ip-locations-with-ip2region.html