PHPackages                             crgao/ip2region - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. crgao/ip2region

ActiveLibrary

crgao/ip2region
===============

Ip2Region for PHP

v1.0.0(7y ago)014Apache-2.0PHPPHP >=5.3

Since Nov 11Pushed 7y ago1 watchersCompare

[ Source](https://github.com/CRGao/ip2region)[ Packagist](https://packagist.org/packages/crgao/ip2region)[ RSS](/packages/crgao-ip2region/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

ip2region - 最自由的ip地址查詢庫，ip到地區的映射庫，提供Binary,B樹和純內存三種查詢算法，媽媽再也不用擔心我的ip地址定位。

\##將該庫打包成 PHP composer 版本

### 1. 99.9%準確率，定時更新：

[](#1-999準確率定時更新)

數據聚合了一些知名ip到地名查詢提供商的數據，這些是他們官方的的準確率，經測試著實比純真啥的準確多了。
每次聚合一下數據需要1-2天，會不定時更新。

### 2. 標準化的數據格式：

[](#2-標準化的數據格式)

每條ip數據段都固定了格式：*城市Id|國家|區域|省份|城市|ISP*

只有中國的數據精確到了城市，其他國家只能定位到國家，後前的選項全部是0，已經包含了全部你能查到的大大小小的國家。 （請忽略前面的城市Id，個人項目需求）

### 3. 體積小：

[](#3-體積小)

生成的數據庫文件ip2region.db只有1.5M（1.2版本前是3.5M）

### 4. composer 安裝：

[](#4-composer-安裝)

```
composer require crgao/ip2region
```

```
$ip2region = new Ip2Region();

$ip = '101.96.11.3';

#可拿來驗證IP格式
$ip = Ip2Region::safeIp2long($ip);

#btreeSearch
$info = $ip2region->btreeSearch($ip);
print_r($info);

#binarySearch
$info = $ip2region->binarySearch($ip);
print_r($info);

#memorySearch
$info = $ip2region->memorySearch($ip);
print_r($info);
```

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2736d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4899233ce7730e8d6d8d7f04e654e7e2a6ce133cfd544f0bd462136743b3f693?d=identicon)[CRGao](/maintainers/CRGao)

---

Top Contributors

[![CRGao](https://avatars.githubusercontent.com/u/8327466?v=4)](https://github.com/CRGao "CRGao (1 commits)")

---

Tags

Ip2Region

### Embed Badge

![Health badge](/badges/crgao-ip2region/health.svg)

```
[![Health](https://phpackages.com/badges/crgao-ip2region/health.svg)](https://phpackages.com/packages/crgao-ip2region)
```

###  Alternatives

[zoujingli/ip2region

ip2region v3.0 for PHP - 企业级 IP 地理位置查询库，支持 IPv4 和 IPv6，多种缓存策略，零依赖，开箱即用

1.4k437.1k56](/packages/zoujingli-ip2region)[firstphp/ip2region

ip2region for hyperf

138.7k](/packages/firstphp-ip2region)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)