包简介

[Official Release] IP2Location PHP API to get location info from IPv4 and IPv6 address.

README 文档

README

This is the official release maintained by IP2Location.com

This PHP module provides fast lookup of country, region, city, latitude, longitude, ZIP code, time zone, ISP, domain name, connection speed, IDD code, area code, weather station code, weather station name, MNC, MCC, mobile brand, elevation, and usage type from IP address by using IP2Location database. This module uses a file based database available at IP2Location.com.

This module can be used in many types of projects such as:

select the geographically closest mirror
analyze your web server logs to determine the countries of your visitors
credit card fraud detection
software export controls
display native language and currency
prevent password sharing and abuse of service
geotargeting in advertisement

Free IP2Location LITE and commerical databases are available for download.

LITE database is available at https://lite.ip2location.com (Free with limited accuracy)
Commercial database is availabe at https://www.ip2location.com (Comprehensive with high accuracy)

Monthly update is available for both IP2Location LITE and commercial database.

KEY FEATURES

Support both IPv4 and IPv6 with ease. If you would like to enable IPv6 support, you just need to replace your BIN file with IPv6 version. That's it, and no code modification needed.
Extensible. If you require different granularity of IP information, you can visit IP2Location.com to download the relevant BIN file, and the information will made ready for you.
Comprehensive Information. There are more than 13 types of information that you can retrieve from an IP address. Please visit IP2Location.com for details.

INSTALLATION

To install this module, unzip the package and copy the following files to your web folder.

IP2Location.php
example.php
databases/IP2LOCATION-LITE-DB1.BIN

To test this installation, please browse example.php using web browser.

USAGE

You can check the example.php file to learn more about usage.

Database Class

Below is the description of the functions available in the Database class.

Function Name	Description
Constructor	Expect 2 input parameters: Full path of IP2Location BIN data file. File Open Mode SHARED_MEMORY MEMORY_CACHE FILE_IO For SHARED_MEMORY and MEMORY_CACHE, it will require your server to have sufficient memory to hold the BIN data, otherwise it will raise the errors during the object initialization.
getDate	Return the database's compilation date as a string of the form 'YYYY-MM-DD'
getType	Return the database's type, 1 to 24 respectively for DB1 to DB24. Please visit https://www.ip2location.com/databases for details.
getModuleVersion	Return the version of module
getDatabaseVersion	Return the version of database
lookup	Return the IP information in array. Below is the information returned: ipNumber ipVersion ipAddress countryCode countryName regionName cityName latitude longitude areaCode iddCode weatherStationCode weatherStationName mcc mnc mobileCarrierName usageType elevation netSpeed timeZone zipCode domainName isp You can visit IP2Location for the description of each field. Note: although the above names are not exactly matched with the names given in this link, but they are self-described.
getCidr	Return an array of the sub-network of an IP address.

WebService Class

Below is the description of the functions available in the WebService class.

Function Name	Description
Constructor	Expect 3 input parameters: IP2Location API Key. Package (WS1 - WS24) Use HTTPS or HTTP
lookup	Return the IP information in array. country_code country_name region_name city_name latitude longitude zip_code time_zone isp domain net_speed idd_code area_code weather_station_code weather_station_name mcc mnc mobile_brand elevation usage_type continent name code hemisphere translations country name alpha3_code numeric_code demonym flag capital total_area population currency code name symbol language code name idd_code tld translations region name code translations city name translations geotargeting metro country_groupings time_zone_info olson current_time gmt_offset is_dst
getCredit	Return remaining credit of the web service account.

DEPENDENCIES

This library requires IP2Location BIN data file to function. You may download the BIN data file at

IP2Location LITE BIN Data (Free): https://lite.ip2location.com
IP2Location Commercial BIN Data (Comprehensive): https://www.ip2location.com

An outdated BIN database was provided in the databases folder for your testing. You are recommended to visit the above links to download the latest BIN database.

You can also sign up for IP2Location Web Service to lookup by IP2Location API.

IPv4 BIN vs IPv6 BIN

Use the IPv4 BIN file if you just need to query IPv4 addresses.
Use the IPv6 BIN file if you need to query BOTH IPv4 and IPv6 addresses.

OTHER FRAMEWORK LIBRARY

Below are the list of other framework library that you can install and use right away.

COPYRIGHT AND LICENCE

License under MIT

seeley/ip2location 适用场景与选型建议

seeley/ip2location 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 522 次下载、GitHub Stars 达 0，最近一次更新时间为 2020 年 07 月 27 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「geolocation」「ip2location」「ip2locationlite」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 seeley/ip2location 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 seeley/ip2location 我们能提供哪些服务？

定制开发 / 二次开发

基于 seeley/ip2location 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 seeley/ip2location 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

ip2location/ip2location-php 213

[Official Release] IP2Location PHP API to get location info from IPv4 and IPv6 address.

doublesecretagency/craft-googlemaps 12

Maps in minutes. Powered by the Google Maps API.

apiip/apiip.net 0

The official PHP library for apiip.net that allowing customers to automate IP address validation and geolocation lookup in websites, applications and back-office system. Visit our API docs at https://apiip.net/documentation

atchondjo/geoip2country 34

A lightweight but powerful IP address lookup database solution to determine visitors country

vitalybaev/sypexgeo 0

Supports GeoIP services (sypexgeo.net).

ip2location/ip2location-yii 6

Lookup for visitor's IP information, such as country, region, city, coordinates, zip code, time zone, ISP, domain name, connection type, area code, weather, MCC, MNC, mobile brand name, elevation and usage type.

seeley/ip2location

包简介

关键字：