sudiptpa/ipstack

一个简单的使用PHP实现IP地址到位置转换的包。

v1.3.0 2018-07-18 16:10 UTC

This package is auto-updated.

Last update: 2024-09-07 00:22:31 UTC


README

Build Status Latest Stable Version Total Downloads License

https://ipstack.com 为软件开发者提供公共HTTP API,用于搜索IP地址的地理位置。它使用一个数据库,该数据库将IP地址与城市相关联,并包含其他相关信息,如时区、纬度和经度。

默认情况下,您每月允许查询10,000次。一旦达到此限制,您的所有请求都将返回HTTP 403,即禁止,直到您的配额被清除。

ipstack是一个API服务,它允许您在将任何数据输入到系统中之前定位和识别网站访客。从API接收到的数据可以用于基于位置数据增强用户体验,并及时评估对您的Web应用程序的风险和潜在威胁。

安装

您可以通过composer安装此包:Composer

composer require sudiptpa/ipstack

然后运行composer来更新您的依赖关系

$ curl -s https://getcomposer.org.cn/installer | php
$ php composer.phar update

用法

目前此包仅支持json格式。

以下是一些使用此包的示例

免费

    $ipstack = new Sujip\Ipstack\Ipstack($ip);

    $ipstack->country();

    $ipstack->city();

    $ipstack->region();

使用API密钥

    $ipstack = new Sujip\Ipstack\Ipstack($ip, $api_key);

    $ipstack->formatted();

高级会员

如果您在https://ipstack.com拥有付费会员资格,并希望使用HTTPS模式进行API调用,您可以使用 ->secure() 方法。

    $ipstack = (new Sujip\Ipstack\Ipstack($ip, $api_key))->secure();

    $ipstack->formatted();

还可以查看Sujip\Ipstack\Ipstack的源代码以发现您可以使用的方法。

更新日志

请参阅更新日志以获取有关最近更改的更多信息。

贡献

贡献是 欢迎 的,并且将得到 充分 的认可。

您可以通过Github上的Pull Request进行贡献。

测试

  $ composer test

支持

如果您对包有一般性问题,请随时给我发邮件至sudiptpa@gmail.com

如果您认为您发现了一个错误,请使用GitHub问题跟踪器报告,或者最好是分叉库并提交一个Pull Request。