PHPackages                             mileschou/twnicip - 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. [Utility & Helpers](/categories/utility)
4. /
5. mileschou/twnicip

ActiveLibrary[Utility & Helpers](/categories/utility)

mileschou/twnicip
=================

Twnic IP

v1.0.6(1y ago)131.9kMITPHPPHP ^8.0

Since Aug 13Pushed 1y ago1 watchersCompare

[ Source](https://github.com/MilesChou/twnicip)[ Packagist](https://packagist.org/packages/mileschou/twnicip)[ Fund](https://www.paypal.me/mileschou)[ RSS](/packages/mileschou-twnicip/feed)WikiDiscussions 1.x Synced yesterday

READMEChangelog (10)Dependencies (8)Versions (21)Used By (0)

Twnic IP
========

[](#twnic-ip)

[![tests](https://github.com/MilesChou/twnicip/workflows/tests/badge.svg)](https://github.com/MilesChou/twnicip/workflows/tests/badge.svg)[![codecov](https://camo.githubusercontent.com/cc2872ba27ccc828a543f3688def4a0498bbae205f2b23fd58dee4d549d9a5c2/68747470733a2f2f636f6465636f762e696f2f67682f4d696c657343686f752f74776e696369702f6272616e63682f6d61737465722f67726170682f62616467652e7376673f746f6b656e3d4f507a59516a34326251)](https://codecov.io/gh/MilesChou/twnicip)[![Codacy Badge](https://camo.githubusercontent.com/8c83d9e15fff4e816084ec48107585a4e1d52598b88413b552281bba837e9d71/68747470733a2f2f6170702e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f3466383265636237646431323437386362613962353163386262323664373465)](https://www.codacy.com/gh/MilesChou/twnicip/dashboard)[![Latest Stable Version](https://camo.githubusercontent.com/f8ed7590c45b12682fcf3906abf5093278303d7dda98deb5470e9013aaa596af/68747470733a2f2f706f7365722e707567782e6f72672f4d696c657343686f752f74776e696369702f762f737461626c65)](https://packagist.org/packages/MilesChou/twnicip)[![Total Downloads](https://camo.githubusercontent.com/b52a8bdec119c002079b014f77241903b46555164297415ff192d8722ea66ddd/68747470733a2f2f706f7365722e707567782e6f72672f4d696c657343686f752f74776e696369702f642f746f74616c2e737667)](https://packagist.org/packages/MilesChou/twnicip)[![License](https://camo.githubusercontent.com/348d2515a537d5ce703c5b6156b02bcc4cb571c848812dd7164bf481a101ff33/68747470733a2f2f706f7365722e707567782e6f72672f4d696c657343686f752f74776e696369702f6c6963656e7365)](https://packagist.org/packages/MilesChou/twnicip)

檢查是否為台灣 IP 的小工具。

台灣 IP 沒想像中多，這個工具是直接把找到的資料轉成 PHP 原生變數型態的「[資料庫](/src/Database.php)」，再使用另一個 [Facade](/src/TwnicIp.php) 做搜尋。

原始 Database 是不能修改的，只能靠原 repo 更新，而 Facade 層則是可以動態標記 IP 是否為台灣 IP。

Version
-------

[](#version)

- 0.x 版支援 PHP 7.1 ~ 8.0
- 1.x 版支援 PHP 8.0+

Installation
------------

[](#installation)

透過 Composer 即可安裝：

```
composer require mileschou/twnicip
```

Usage
-----

[](#usage)

這是主要驗證 IP 來源的 class，使用下面三個方法來確認是否是台灣 IP：

```
$twnicIp = new TwnicIp();

$twnicIp->isTaiwan('202.39.128.1'); // isTaiwanByIp() 的別名
$twnicIp->isTaiwanByIp('202.39.128.1');
$twnicIp->isTaiwanByLong(3391586305); // 轉成 IP 即 202.39.128.1
```

如果有新加入的 IP，但原始 repo 沒有更新時，可以自行新增：

```
$twnicIp->includeRange('127.0.0.1', '127.0.0.1');

$twnicIp->isTaiwan('127.0.0.1'); // return true
```

同理，如果某個區段的 IP 需要被排除時，也可以自行處理：

```
$twnicIp->excludeRange('127.0.0.1', '127.0.0.1');

$twnicIp->isTaiwan('127.0.0.1'); // return false
```

私有網域狹義來說，並不屬於台灣的 IP。而實務上，機器在台灣，某種程度也是算台灣的 IP 啦！

如果想把私有網域當作台灣 IP 的話，可以額外呼叫下面這個方法：

```
$twnicIp->includePrivateIp();
```

裡面其實只是呼叫 `includeRange()` 把私有 IP 的 range 加入。

References
----------

[](#references)

- [Twnic IP 列表](https://www.twnic.tw/download/IP/main_f3.htm) - 但此文件看起來已過時，因此改採用其他資料庫
- [IP2LOCATION Lite](https://lite.ip2location.com/) - 免費且完整的資料庫，目前是使用這個

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance40

Moderate activity, may be stable

Popularity23

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity65

Established project with proven stability

 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

Every ~61 days

Recently: every ~85 days

Total

21

Last Release

508d ago

Major Versions

v0.3.7 → v1.0.02023-09-27

PHP version history (3 changes)v0.0.1PHP ^7.1 | ^8

v0.2.0PHP ^7.1 | ^8.0

v1.0.0PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/20872dcc4b888075f03819d5470db8198ffcc5f9edb791aba5f007e34355a6c9?d=identicon)[MilesChou](/maintainers/MilesChou)

---

Top Contributors

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

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/mileschou-twnicip/health.svg)

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

###  Alternatives

[rubix/ml

A high-level machine learning and deep learning library for the PHP language.

2.2k1.4M28](/packages/rubix-ml)[arcanedev/qr-code

QR Code generator

1231.9k1](/packages/arcanedev-qr-code)[bestmomo/laravel5-3-installer

Helper for Laravel 5.3 application installation

174.7k](/packages/bestmomo-laravel5-3-installer)

PHPackages © 2026

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