PHPackages                             smartframe-technologies/ip2location - 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. smartframe-technologies/ip2location

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

smartframe-technologies/ip2location
===================================

Based on IP2Location PHP API with extra downloader tool

1.3.0(4y ago)157Apache-2.0PHPPHP ^7.4 || ^8.0

Since Oct 2Pushed 4y agoCompare

[ Source](https://github.com/SmartFrame-Technologies/ip2location)[ Packagist](https://packagist.org/packages/smartframe-technologies/ip2location)[ RSS](/packages/smartframe-technologies-ip2location/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (5)Dependencies (5)Versions (11)Used By (0)

\#ip2location

Based on IP2Location PHP API with extra downloader tool

Build Status
------------

[](#build-status)

[![Build Status](https://camo.githubusercontent.com/c860b130f04cd7f267cf05e0fa1605f628380dba4d438d327930be4ba3d7e3f9/68747470733a2f2f7472617669732d63692e636f6d2f536d6172744672616d652d546563686e6f6c6f676965732f6970326c6f636174696f6e2e7376673f746f6b656e3d3668367267767866694d7169396f36567a6e5a73266272616e63683d6d6173746572)](https://travis-ci.com/SmartFrame-Technologies/ip2location)

Basic usage
-----------

[](#basic-usage)

Use static factory to get Exchanger. It requires you to give url with token and packages you desire to download.

```
$dbExchanger = DatabaseExchangeFactory::create($downloadUrl, $package)

```

Then specify file path:

```
$dbExchanger->exchange('folder/ipDatabase.bin');

```

### Usage with cache

[](#usage-with-cache)

This tool can also use S3 as cache to store DB for many server instances.

```
$dbExchanger = DatabaseExchangeFactory::createWithS3Cache(
                           $downloadUrl,
                           $packages,
                           $s3PhpClient, //AWS S3 Client
                           $s3Bucket,
                           $s3Prefix //folder name
                       );

```

Then specify file path:

```
$dbExchanger->exchange('folder/ipDatabase.bin');

```

License
-------

[](#license)

Copyright 2020 SmartFrame Technologies

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at:

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 62.9% 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 ~59 days

Total

6

Last Release

1804d ago

PHP version history (2 changes)1.0.0PHP ^7.4

1.2.0PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/66439633?v=4)[rollo-smartframe](/maintainers/rollo-smartframe)[@rollo-smartframe](https://github.com/rollo-smartframe)

---

Top Contributors

[![WitoldAtSmartframe](https://avatars.githubusercontent.com/u/75019610?v=4)](https://github.com/WitoldAtSmartframe "WitoldAtSmartframe (22 commits)")[![rollo-smartframe](https://avatars.githubusercontent.com/u/66439633?v=4)](https://github.com/rollo-smartframe "rollo-smartframe (10 commits)")[![grzegorzplech](https://avatars.githubusercontent.com/u/13719581?v=4)](https://github.com/grzegorzplech "grzegorzplech (3 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/smartframe-technologies-ip2location/health.svg)

```
[![Health](https://phpackages.com/badges/smartframe-technologies-ip2location/health.svg)](https://phpackages.com/packages/smartframe-technologies-ip2location)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k543.5M2.6k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751291.4k43](/packages/civicrm-civicrm-core)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[oat-sa/tao-core

TAO core extension

66143.7k124](/packages/oat-sa-tao-core)

PHPackages © 2026

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