PHPackages                             uuidcoders/ip-location-zh-backups - 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. uuidcoders/ip-location-zh-backups

ActiveLibrary

uuidcoders/ip-location-zh-backups
=================================

get the ip's location info with Chinese

v1.0.4(2y ago)044[1 issues](https://github.com/uuidcoder/ip-location-zh-backups/issues)MITPHP

Since Aug 28Pushed 2y ago1 watchersCompare

[ Source](https://github.com/uuidcoder/ip-location-zh-backups)[ Packagist](https://packagist.org/packages/uuidcoders/ip-location-zh-backups)[ RSS](/packages/uuidcoders-ip-location-zh-backups/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

Ip Location Zh
==============

[](#ip-location-zh)

[![Scrutinizer Code Quality](https://camo.githubusercontent.com/bb62337c5afc39a81be04ea7c7cb190b67f7313de909d2a66d144e6f39efaf40/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f7a68757a68696368616f2f69702d6c6f636174696f6e2d7a682f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/zhuzhichao/ip-location-zh/?branch=master)[![Build Status](https://camo.githubusercontent.com/5fd7cfaa17234b3f44129784649d421599986ffd0c95b9918e9dfc9313311e6e/68747470733a2f2f7472617669732d63692e6f72672f7a68757a68696368616f2f69702d6c6f636174696f6e2d7a682e737667)](https://travis-ci.org/zhuzhichao/ip-location-zh)[![Total Downloads](https://camo.githubusercontent.com/b6d32e7e94b73be2ff282b6fa6655458844707093b6f86c790e025ba92de34ab/68747470733a2f2f706f7365722e707567782e6f72672f7a68757a68696368616f2f69702d6c6f636174696f6e2d7a682f642f746f74616c2e737667)](https://packagist.org/packages/zhuzhichao/ip-location-zh)[![Latest Stable Version](https://camo.githubusercontent.com/d1816a8a8fef859a24dff70d8a8639b866100d305db61e453b145d84aef3adbe/68747470733a2f2f706f7365722e707567782e6f72672f7a68757a68696368616f2f69702d6c6f636174696f6e2d7a682f762f737461626c652e737667)](https://packagist.org/packages/zhuzhichao/ip-location-zh)[![License](https://camo.githubusercontent.com/cda3ced932960a77d7aed5dfef80976978f3330276d10f2c08f70c52c7ea32fa/68747470733a2f2f706f7365722e707567782e6f72672f7a68757a68696368616f2f69702d6c6f636174696f6e2d7a682f6c6963656e73652e737667)](https://packagist.org/packages/zhuzhichao/ip-location-zh)

数据最后更新时间为 2019-7-3, 更新时间:不定期。 数据源于:

IPIP典型客户 [![ipip客户](https://camo.githubusercontent.com/052b8a1eb65b77a3cbc81c323d6ab9466be0c1fee49a3fcf70170842cf9242f3/687474703a2f2f696d672e7a68757a68696368616f2e636f6d2f69706970736572766572636f6d2e706e67)](https://camo.githubusercontent.com/052b8a1eb65b77a3cbc81c323d6ab9466be0c1fee49a3fcf70170842cf9242f3/687474703a2f2f696d672e7a68757a68696368616f2e636f6d2f69706970736572766572636f6d2e706e67)

这是一个能够通过 Ip，获取该 IP 所在的位置，例如通过 ip：`171.12.10.156` 可以获得是 `中国河南郑州`，以及中国行政区划代码(支持到市级), 同样能获得国外的地址，但是没有国内详细。

> 注意: 该免费数据库不提供经纬度、运营商、行政区等更详细的内容, 如果你有更多的需求可以考虑使用他们的收费服务。本包的目的是提供给需求简单, 手里没钱的程序员或者老板不舍得掏钱来获取定时更新的IP信息

> 国家码和邮编不是该包负责的内容, 需自行构建相关的程序

特点
--

[](#特点)

1. 不配置和使用数据库，妈妈再也不用担心配置问题了
2. 使用简单，功能专（dān）注（yī）
3. 使用 [composer](https://getcomposer.org/) 进行安装管理，国际标准，方便快捷，即安即用，随时更新数据库

Install
-------

[](#install)

这里不详细介绍安装 composer 了，大家根据 [链接](https://getcomposer.org/) 自行安装吧！

`composer require "zhuzhichao/ip-location-zh"`

Usage
-----

[](#usage)

#### Common

[](#common)

可以这样来用

```
require 'vendor/autoload.php';  
use Zhuzhichao\IpLocationZh\Ip;  
var_dump(Ip::find('171.12.10.156'));
```

```
// 返回结果
array (size=4)
  0 => string '中国' (length=6)
  1 => string '河南' (length=6)
  2 => string '郑州' (length=6)
  3 => string '' (length=0)
  4 => string '410100' (length=6)

```

#### Laravel

[](#laravel)

对于`laravel`可以这样优雅的用:

1.安装该插件

2.在 `config/app.php`(Laravel 5.0 - 5.4)添加下面的代码，如果是 Laravel 5.5+ ，已经支持扩展包发现，不需要添加下面的代码

```
// Laravel 5.5 不需要添加
'aliases' => [
    'Ip'  => 'Zhuzhichao\IpLocationZh\Ip', 
],
```

3.然后开始在你的项目里面使用了 `Ip::find('171.12.10.156')` 或 `Ip::find(Request::getClientIp())`

**对，很简单，只用一个方法，那就是 `find`**

Contributing
------------

[](#contributing)

有什么新的想法和建议，欢迎提交 [issue](https://github.com/zhuzhichao/ip-location-zh/issues) 或者 [Pull Requests](https://github.com/zhuzhichao/ip-location-zh/pulls) 。

License
-------

[](#license)

MIT

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity43

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

987d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/31652a31528f8633e9dba68bdc250a083a441ccf432e55edac513a0607a83f58?d=identicon)[hatcher](/maintainers/hatcher)

---

Top Contributors

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

---

Tags

IPlocationChinese

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/uuidcoders-ip-location-zh-backups/health.svg)

```
[![Health](https://phpackages.com/badges/uuidcoders-ip-location-zh-backups/health.svg)](https://phpackages.com/packages/uuidcoders-ip-location-zh-backups)
```

###  Alternatives

[itbdw/ip-database

IP数据库 IPV4 IPV6（解析为国家、省、市、县、运营商）

1.5k123.8k7](/packages/itbdw-ip-database)[stevebauman/location

Retrieve a user's location by their IP Address

1.3k7.6M65](/packages/stevebauman-location)[zhuzhichao/ip-location-zh

get the ip's location info with Chinese

617212.5k11](/packages/zhuzhichao-ip-location-zh)[zoujingli/ip2region

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

1.4k437.1k56](/packages/zoujingli-ip2region)[gai871013/ip-location

纯真IP地址,composer包(解析QQWay.dat)

729.7k4](/packages/gai871013-ip-location)[kartik-v/yii2-ipinfo

An IP address information display widget for Yii 2.0 with country flag and geo position info.

2832.6k1](/packages/kartik-v-yii2-ipinfo)

PHPackages © 2026

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