GeoIP2 数据库及IP 地址段

项目介绍

项目选取更新较为频繁、广受好评、准确度高的 ipip.net 和 纯真 IP 数据库的中国大陆 IP 地址段信息进行合并、去重、整理操作，最终生成仅含有中国大陆 IP 信息的 GeoIP2 数据库。准确度高、用户使用体验好。

GeoIP2 数据库的大小仅为 111 KB，对比原来庞大的 4 MB 数据库，显得非常小巧实用，加载时间极短、查询效率极高。

项目直接托管于 GitHub，并使用 CDN 全球分发，无需注册，下载速度极快。

项目每隔 3 天通过全自动化部署自我更新，时刻保持最佳体验。

以PHP为例基于GeoIP2的整合应用

1. 通过Composer安装

要下载 Composer，请在项目的根目录中运行：
curl -sS https://getcomposer.org/installer | php
 

You should now have the file composer.phar in your project directory.

2. 安装依赖项

在你的项目根目录中运行：

php composer.phar require geoip2/geoip2:~2.0

You should now have the files composer.json and composer.lock as well as the directory vendor in your project directory. If you use a version control system, composer.json should be added to it.

3. 需要自动加载器

安装依赖项后，你需要在代码中引入 Composer 自动加载器：

require 'vendor/autoload.php';

4. 通过Phar安装

虽然我们强烈建议使用 Composer，但我们还提供了包含 GeoIP2 大部分依赖项的 phar archive。我们最新的 phar 档案可在官方的 Release page 找到。

5. 安装依赖项

为了使用 phar 存档，您必须安装并启用 PHP Phar 扩展。

如果您要发出 Web 服务请求，则必须安装 PHP cURL 扩展才能使用此存档。对于基于 Debian 的发行版，通常可以在 php-curl 包中找到。对于其他操作系统，请查阅相关文档。安装扩展后，您可能需要重新启动 Web 服务器。

如果您缺少此扩展，您将看到如下错误：

PHP Fatal error:  Uncaught Error: Call to undefined function MaxMind\WebService\curl_version()

6. 需要安装Package

要使用档案，只需在脚本中要求它即可：

require 'geoip2.phar';

7.  可选的 C 扩展

MaxMind DB API 包含一个可选的 C 扩展，您可以安装该扩展来显著提高 GeoIP2 或 GeoLite2 数据库中的查找性能。要安装，请按照该 API 附带的说明进行操作。

该扩展对 Web 服务查找没有影响。

8. IP 地理位置使用情况

IP 地理定位本质上是不精确的。位置通常位于人口中心附近。GeoIP2 数据库或网络服务提供的任何位置都不应用于识别特定地址或家庭。

9. 数据库阅读器

用法

要使用此 API，您必须创建一个新的 \GeoIp2\Database\Reader 对象，并将数据库文件的路径作为构造函数的第一个参数。然后，您可以调用与您正在使用的数据库相对应的方法。

如果查找成功，该方法调用将返回数据库中记录的模型类。此模型又包含多个容器类，用于数据的不同部分，例如 IP 地址所在的城市。

如果未找到记录，则抛出 \GeoIp2\Exception\AddressNotFoundException。如果数据库无效或损坏，将抛出 \MaxMind\Db\InvalidDatabaseException。

有关更多详细信息，请参阅 API 文档。

获取城市的案例方法

<?php
require_once 'vendor/autoload.php';
use GeoIp2\Database\Reader;

// This creates the Reader object, which should be reused across
// lookups.
$cityDbReader = new Reader('/usr/local/share/GeoIP/GeoIP2-City.mmdb');

// Replace "city" with the appropriate method for your database, e.g.,
// "country".
$record = $cityDbReader->city('128.101.101.101');

print($record->country->isoCode . "\n"); // 'US'
print($record->country->name . "\n"); // 'United States'
print($record->country->names['zh-CN'] . "\n"); // '美国'

print($record->mostSpecificSubdivision->name . "\n"); // 'Minnesota'
print($record->mostSpecificSubdivision->isoCode . "\n"); // 'MN'

print($record->city->name . "\n"); // 'Minneapolis'

print($record->postal->code . "\n"); // '55455'

print($record->location->latitude . "\n"); // 44.9733
print($record->location->longitude . "\n"); // -93.2323

print($record->traits->network . "\n"); // '128.101.101.101/32'

获取匿名 IP 示例和方法

<?php
require_once 'vendor/autoload.php';
use GeoIp2\Database\Reader;

// This creates the Reader object, which should be reused across
// lookups.
$anonymousDbReader = new Reader('/usr/local/share/GeoIP/GeoIP2-Anonymous-IP.mmdb');

$record = $anonymousDbReader->anonymousIp('128.101.101.101');

if ($record->isAnonymous) { print "anon\n"; }
print($record->ipAddress . "\n"); // '128.101.101.101'
print($record->network . "\n"); // '128.101.101.101/32'

连接类型示例

<?php
require_once 'vendor/autoload.php';
use GeoIp2\Database\Reader;

// This creates the Reader object, which should be reused across
// lookups.
$connectionTypeDbReader = new Reader('/usr/local/share/GeoIP/GeoIP2-Connection-Type.mmdb');

$record = $connectionTypeDbReader->connectionType('128.101.101.101');

print($record->connectionType . "\n"); // 'Corporate'
print($record->ipAddress . "\n"); // '128.101.101.101'
print($record->network . "\n"); // '128.101.101.101/32'

区域案例

<?php
require_once 'vendor/autoload.php';
use GeoIp2\Database\Reader;

// This creates the Reader object, which should be reused across
// lookups.
$domainDbReader = new Reader('/usr/local/share/GeoIP/GeoIP2-Domain.mmdb');

$record = $domainDbReader->domain('128.101.101.101');

print($record->domain . "\n"); // 'umn.edu'
print($record->ipAddress . "\n"); // '128.101.101.101'
print($record->network . "\n"); // '128.101.101.101/32'

获取IP运营商案例

<?php
require_once 'vendor/autoload.php';
use GeoIp2\Database\Reader;

// This creates the Reader object, which should be reused across
// lookups.
$enterpriseDbReader = new Reader('/usr/local/share/GeoIP/GeoIP2-Enterprise.mmdb');

// Use the ->enterprise method to do a lookup in the Enterprise database
$record = $enterpriseDbReader->enterprise('128.101.101.101');

print($record->country->confidence . "\n"); // 99
print($record->country->isoCode . "\n"); // 'US'
print($record->country->name . "\n"); // 'United States'
print($record->country->names['zh-CN'] . "\n"); // '美国'

print($record->mostSpecificSubdivision->confidence . "\n"); // 77
print($record->mostSpecificSubdivision->name . "\n"); // 'Minnesota'
print($record->mostSpecificSubdivision->isoCode . "\n"); // 'MN'

print($record->city->confidence . "\n"); // 60
print($record->city->name . "\n"); // 'Minneapolis'

print($record->postal->code . "\n"); // '55455'

print($record->location->accuracyRadius . "\n"); // 50
print($record->location->latitude . "\n"); // 44.9733
print($record->location->longitude . "\n"); // -93.2323

print($record->traits->network . "\n"); // '128.101.101.101/32'

获取ISP 示例

<?php
require_once 'vendor/autoload.php';
use GeoIp2\Database\Reader;

// This creates the Reader object, which should be reused across
// lookups.
$ispDbReader = new Reader('/usr/local/share/GeoIP/GeoIP2-ISP.mmdb');

$record = $ispDbReader->isp('128.101.101.101');

print($record->autonomousSystemNumber . "\n"); // 217
print($record->autonomousSystemOrganization . "\n"); // 'University of Minnesota'
print($record->isp . "\n"); // 'University of Minnesota'
print($record->organization . "\n"); // 'University of Minnesota'

print($record->ipAddress . "\n"); // '128.101.101.101'
print($record->network . "\n"); // '128.101.101.101/32'

10. 数据库更新

您可以使用我们的 GeoIP 更新程序使您的数据库保持最新状态。在我们的开发者门户上了解有关 GeoIP 更新的更多信息。

11. 网络服务客户端

使用方法

要使用此 API，您必须使用您的 $accountId 和 $licenseKey 创建一个新的 \GeoIp2\WebService\Client 对象：

$client = new Client(42, 'abcdef123456');

您还可以使用其他参数调用构造函数。第三个参数指定在该客户端创建的模型类上使用 ->name 方法时的语言首选项。第四个参数是其他选项，例如 host 和 timeout。

例如，要调用 GeoLite2 Web 服务而不是 GeoIP2 Web 服务：

$client = new Client(42, 'abcdef123456', ['en'], ['host' => 'geolite.info']);

要调用 Sandbox GeoIP2 Web 服务而不是生产 GeoIP2 Web 服务：

$client = new Client(42, 'abcdef123456', ['en'], ['host' => 'sandbox.maxmind.com']);

创建客户端后，您现在可以调用与要查找的 IP 地址相对应的特定端点的方法，例如：

$record = $client->city('128.101.101.101');

如果请求成功，该方法调用将返回您调用的端点的模型类。此模型又包含多个记录类，每个记录类代表网络服务返回的部分数据。

如果出现错误，则会引发结构化异常。

有关更多详细信息，请参阅 API 文档。

案例：

<?php
require_once 'vendor/autoload.php';
use GeoIp2\WebService\Client;

// This creates a Client object that can be reused across requests.
// Replace "42" with your account ID and "license_key" with your license
// key. Set the "host" to "geolite.info" in the fourth argument options
// array to use the GeoLite2 web service instead of the GeoIP2 web
// service. Set the "host" to "sandbox.maxmind.com" in the fourth argument
// options array to use the Sandbox GeoIP2 web service instead of the
// production GeoIP2 web service.
$client = new Client(42, 'abcdef123456');

// Replace "city" with the method corresponding to the web service that
// you are using, e.g., "country", "insights".
$record = $client->city('128.101.101.101');

print($record->country->isoCode . "\n"); // 'US'
print($record->country->name . "\n"); // 'United States'
print($record->country->names['zh-CN'] . "\n"); // '美国'

print($record->mostSpecificSubdivision->name . "\n"); // 'Minnesota'
print($record->mostSpecificSubdivision->isoCode . "\n"); // 'MN'

print($record->city->name . "\n"); // 'Minneapolis'

print($record->postal->code . "\n"); // '55455'

print($record->location->latitude . "\n"); // 44.9733
print($record->location->longitude . "\n"); // -93.2323

print($record->traits->network . "\n"); // '128.101.101.101/32'

12. 用于数据库或数组键的值

我们强烈建议您不要将任何名称属性的值用作数据库或数组中的键。

这些名称可能会在不同版本之间发生变化。我们建议使用以下名称之一：

• GeoIp2\Record\City - $city->geonameId
• GeoIp2\Record\Continent - $continent->code or $continent->geonameId
• GeoIp2\Record\Country and GeoIp2\Record\RepresentedCountry - $country->isoCode or $country->geonameId
• GeoIp2\Record\Subdivision - $subdivision->isoCode or $subdivision->geonameId

14. 返回什么数据？

虽然许多端点返回相同的基本记录，但可以填充的属性在端点之间有所不同。此外，虽然端点可能提供特定的数据，但 MaxMind 并不总是拥有任何给定 IP 地址的所有数据。

由于这些因素，任何端点都可能返回部分或全部属性未填充的记录。

有关每个端点可能返回的数据的详细信息，请参阅 GeoIP2 Web 服务文档。

始终返回的唯一数据是 GeoIp2\Record\Traits 记录中的 ipAddress 属性。

15. 与 GeoNames 集成

GeoNames 提供网络服务和可下载的数据库，其中包含有关世界各地地理特征（包括人口稠密地区）的数据。他们提供免费和付费的高级数据。每个特征都由 geonameId（整数）唯一标识。

GeoIP2 网络服务和数据库返回的许多记录都包含 geonameId 属性。这是 GeoNames 数据库中地理特征（城市、地区、国家等）的 ID。

MaxMind 提供的部分数据也来自 GeoNames。我们从 GeoNames 高级数据集中获取地名、ISO 代码和其他类似数据。