# IP2Location-PHP-Module

**Repository Path**: kuotong/IP2Location-PHP-Module

## Basic Information

- **Project Name**: IP2Location-PHP-Module
- **Description**: 这个PHP 版可以让用户利用 IP2Location 数据库 进行 地理定位查询。

用户们只需要通过IP地址便能查找该IP的地理位置信息，如国家，地区，城市，坐标，邮政编码，ISP，域名，时区，连接速度，IDD代码，区号，气象站代码，气象站名称， 使用类型等任何IP地址或主机名称来源。https://www.ip2location.com

- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2018-03-20
- **Last Updated**: 2024-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

IP2Location （PHP模块）
========================
[![Latest Stable Version](https://img.shields.io/packagist/v/ip2location/ip2location-php.svg)](https://packagist.org/packages/ip2location/ip2location-php)
[![Total Downloads](https://img.shields.io/packagist/dt/ip2location/ip2location-php.svg?style=flat-square)](https://packagist.org/packages/ip2location/ip2location-php)  

*这是由 IP2Location.com 推出的官方版本*

这个由IP2Location提供的PHP模块 能够让网站用户们通过IP地址快速查询该IP地址的地理位置如国家，地区，城市，经纬度，邮政编码，时区，互联网服务提供商（ISP），域名，连接速度，IDD代码，区号，气象站代码，气象站名称，移动国家代码（MCC），移动网络代码（MNC）和运营商品牌，IP地址或主机名的使用类型。此模块使用 IP2Location.com 提供的BIN格式数据库文件读取地理位置信息 

这个模块可用于许多类型的项目中，当中包括了：

1. 选择最接近地理位置的镜像
2. 分析您网络服务器的数据以确定访问者的国家/地区
3. 信用卡欺诈检查
4. 软件输出管理
5. 显示当地语言及货币
6. 防止密码共享以及滥用服务 
7. 广告的地理位置

 ## 数据示例

您可以选择下载IP2Location LITE免费数据或者商业版。 
* IP2Location LITE数据可在此网址中寻获 https://lite.ip2location.com（免费，准确度有限）
* 商业数据可在此网址中寻获 https://www.ip2location.com （精准的准确度）

IP2Location LITE 和商业的数据都将以每个月定时更新。

## 主要功能

1. **支持IPv4 以及IPv6。** 倘若您希望启用支持IPv6的文件，您只需替换您当前的BIN文件到能支持IPv6的文件即可，无需进行任何的代码修改。
2. **扩展性。** 如果您需要不同的IP资料，您可以访问 [IP2Location.com](https://www.ip2location.com/databases) 以便让您下载更多相关的BIN文件，有关的资料您都可以在里面寻获。
3. **全面的信息。** 您可以从IP地址中检测出超过13种类型的资料。想了解更多详情请浏览 [IP2Location.com](https://www.ip2location.com/databases)。

## 安装程序

要安装此模块，请解压缩该软件包并将一下文件复制到您的网络文件中。
* IP2Location.php
* example.php
* databases/IP-COUNTRY-SAMPLE.BIN
* databases/IPV6-COUNTRY-SAMPLE.BIN
 
若想测试此安装，请使用网络浏览器浏览example.php。

## 运作

以下是该class里可使用的功能说明：

| 功能名称 | 说明 |
|---|---|
|Constructor|预计输入2个parameters：<ol><li>IP2Location BIN数据文件的完整路径。</li><li>文件打开模式<ul><li>	SHARED_MEMORY</li><li>MEMORY_CACHE</li><li>FILE_IO</li></ul></li></ol>对于SHARED_MEMORY和MEMORY_CACHE，它将要求您的服务器拥有足够的内存来存放BIN数据，否则将会在object初始化的过程中引发错误。|
|getDate|根据数据库里编译日期的形式呈现日期，如： “年年年年-月月-日日”|
|getType|DB1到DB24分别返回数据库的类型，1到24. 若想了解更多详情，请访问 https://www.ip2location.com/databases |
|getModuleVersion|返回模块的版本|
|getDatabaseVersion|返回数据库的版本|
|lookup|IP的信息将以排列的方式返回出来。以下是返回的信息：<ul><li>ipNumber</li><li>ipVersion</li><li>ipAddress</li><li>countryCode</li><li>countryName</li><li>regionName</li><li>cityName</li><li>latitude</li><li>longitude</li><li>areaCode</li><li>iddCode</li><li>weatherStationCode</li><li>weatherStationName</li><li>mcc</li><li>mnc</li><li>mobileCarrierName</li><li>usageType</li><li>elevation</li><li>netSpeed</li><li>timeZone</li><li>zipCode</li><li>domainName</li><li>isp</li></ul>您可以访问[IP2Location](https://www.ip2location.com/databases/db24-ip-country-region-city-latitude-longitude-zipcode-timezone-isp-domain-netspeed-areacode-weather-mobile-elevation-usagetype)以获取每个字段的说明。注意：虽然以上的名字与连接中的名字并不完全一致，但是它们都是自我描述的。|

## DEPENDENCIES（IP2LOCATION BIN数据文件）

此库需要IP2Location BIN数据文件才能运行。您可以在以下网址中下载BIN数据文件：
* IP2Location LITE BIN数据（免费）：https://lite.ip2location.com
* IP2Location Commercial BIN数据（全面）：https://www.ip2location.com

数据库文件夹中提供了一个没有更新的BIN数据库让您以作测试之用。我们建议您访问以上所提供的连接下载最新的BIN数据库。

## IPv4 BIN与IPv6 BIN
* 如果您只希望查询IPv4的地址，请使用IPv4 BIN文件。
* 如果你需要查找IPv4和IPv6的地址，请使用IPv6 BIN文件。

## 其他框架库
以下所提的列表是可以让您立即安装及使用的框架库。
* [IP2Location Laravel](https://github.com/ip2location/ip2location-laravel)
* [IP2Location CakePHP](https://github.com/ip2location/ip2location-cakephp)
* [IP2Location CodeIgniter](https://github.com/ip2location/codeigniter-ip2location)

## 版权和许可证

IP2Location.com版权所有（C）2015-2018

MIT授权