README

描述

这个库为 PHP 5 提供了方便的面向对象访问 IPGeoBase XML API。

IpGeoBase 是一个免费服务，允许您将俄罗斯和乌克兰的 IP 地址解析为地理位置，精确到城市级别。数据库每天更新。

特性

• 使用最新的 Guzzle 5 库通过 HTTP 进行通信
• 符合 PSR 标准
• 支持 Composer
• 以方便使用和易于访问的 模型 返回响应
• 提供可区分的、可捕获的 异常
• 免费提供给商业产品（MIT 许可证）

安装

使用 Composer 安装库

composer require betsol/ipgeobase-client

使用

// Creating a client:
$ipGeoBaseClient = new Betsol\IpGeoBase\Api\Client;

// You can pass API's base URL to it if required:
$ipGeoBaseClient = new Betsol\IpGeoBase\Api\Client('http://ipgeobase.ru:7020');

// Looking up IP address:
$response = $ipGeoBaseClient->lookupIp('93.184.216.119');

// Getting country:
$response->getCountry();
// "RU"

// Getting city:
$response->getCity();
// "Москва"

// Getting region:
$response->getRegion();
// "Москва"

// Getting district:
$response->getDistrict();
// "Центральный федеральный округ"

// Accessing IP range:
$ipRange = $response->getIpRange();

$ipRange->getStartIp();
// "213.180.200.192"

$ipRange->getEndIp();
// "213.180.208.255"

// Returning IP range as a string:
(string) $ipRange;
// "213.180.200.192 - 213.180.208.255"

// Accessing coordinates:
$coordinates = $response->getCoordinates()

$coordinates->getLatitude();
// float(55.755787)

$coordinates->getLongitude();
// float(37.617634)

// Returning coordinates as a string:
(string) $coordinates;
// string(20) "55.755787, 37.617634"

反馈

如果您发现库中的错误或有其他问题，请在此 GitHub 仓库中 创建一个问题。

如果您有问题，请提交到 StackOverflow 并将链接发送到 s.fomin@betsol.ru。我很乐意帮助您。

有任何想法或建议？请通过 电子邮件 联系我。

谢谢！

赞助商

本库由 Winners Academy 赞助。

许可证

MIT 许可证 (MIT)

版权所有 (c) 2014 Slava Fomin II

特此免费授予任何获得此软件及其相关文档文件（以下简称“软件”）副本的个人，在软件上不受限制地处理的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本，并允许向软件提供者提供软件的个人这样做，前提是满足以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、针对特定目的的适用性和非侵权性保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任承担责任，无论是基于合同、侵权或其他方式，源于、因或与软件或软件的使用或其他交易有关。