PHPackages                             geocoder-php/free-geoip-provider - 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. [API Development](/categories/api)
4. /
5. geocoder-php/free-geoip-provider

ActiveLibrary[API Development](/categories/api)

geocoder-php/free-geoip-provider
================================

Geocoder FreeGeoIp adapter

4.6.0(1y ago)14751.8k—2.3%37MITPHPPHP ^8.0CI failing

Since Jun 30Pushed 5mo ago2 watchersCompare

[ Source](https://github.com/geocoder-php/free-geoip-provider)[ Packagist](https://packagist.org/packages/geocoder-php/free-geoip-provider)[ Docs](http://geocoder-php.org/Geocoder/)[ RSS](/packages/geocoder-php-free-geoip-provider/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (8)Dependencies (5)Versions (9)Used By (7)

Free GeoIp provider
===================

[](#free-geoip-provider)

[![Build Status](https://camo.githubusercontent.com/8ecd7a5037341e438abc679063242eaaabfb12d4abf9ee72aadae97f5e59aeda/68747470733a2f2f7472617669732d63692e6f72672f67656f636f6465722d7068702f667265652d67656f69702d70726f76696465722e7376673f6272616e63683d6d6173746572)](http://travis-ci.org/geocoder-php/free-geoip-provider)[![Latest Stable Version](https://camo.githubusercontent.com/4ce329293916d2e50db241d987fbe2a2f5382c4470828a99f10ff0dfd403640e/68747470733a2f2f706f7365722e707567782e6f72672f67656f636f6465722d7068702f667265652d67656f69702d70726f76696465722f762f737461626c65)](https://packagist.org/packages/geocoder-php/free-geoip-provider)[![Total Downloads](https://camo.githubusercontent.com/4958c4a0bcb79504115878a98c61afc1f3aaa5435a1d21eab78f0876275bf222/68747470733a2f2f706f7365722e707567782e6f72672f67656f636f6465722d7068702f667265652d67656f69702d70726f76696465722f646f776e6c6f616473)](https://packagist.org/packages/geocoder-php/free-geoip-provider)[![Monthly Downloads](https://camo.githubusercontent.com/8afdc5283f7adcaf5b86bc4b7b4b989ea39d404bf8cf420f00e5112d615cc981/68747470733a2f2f706f7365722e707567782e6f72672f67656f636f6465722d7068702f667265652d67656f69702d70726f76696465722f642f6d6f6e74686c792e706e67)](https://packagist.org/packages/geocoder-php/free-geoip-provider)[![Code Coverage](https://camo.githubusercontent.com/dd07c73e02e472c5699a7b2725940e2363e64e334795947a7150eb61c831e979/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f67656f636f6465722d7068702f667265652d67656f69702d70726f76696465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/geocoder-php/free-geoip-provider)[![Quality Score](https://camo.githubusercontent.com/e31ca532ae693e1b5501647e4eb52e95a43c626b5e56769b7b6b6e46a6370693/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f67656f636f6465722d7068702f667265652d67656f69702d70726f76696465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/geocoder-php/free-geoip-provider)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)

This is the Free GeoIp provider from the PHP Geocoder. This is a **READ ONLY** repository. See the [main repo](https://github.com/geocoder-php/Geocoder) for information and documentation.

Provider Website:

Usage
-----

[](#usage)

```
$httpClient = new \Http\Discovery\Psr18Client();

// Use the default provider (https://freegeoip.app)
$provider = new Geocoder\Provider\FreeGeoIp\FreeGeoIp($httpClient);
// Or provide the endpoint of your instance
$provider = new Geocoder\Provider\FreeGeoIp\FreeGeoIp($httpClient, 'http://my.internal.geocoder/json/%s');
```

Freegeoip.net shutdown
----------------------

[](#freegeoipnet-shutdown)

As per the [freegeoip.net](http://freegeoip.net/shutdown) website, the provider has been purchased by [IpStack](https://ipstack.com/). As a result, this provider no longer uses this service with the default configuration.

By default, it will now use `freegeoip.app` (which provides a hosted version of the same API as `freegeoip.net`).

You can also use the [self hosted variant](https://github.com/apilayer/freegeoip/) and supply a host when constructing the provider.

### Alternatives

[](#alternatives)

We offer an [IpStack provider](https://github.com/geocoder-php/ipstack-provider) which you can use if you wish to continue with the new service owner.

#### Full IP Provider List

[](#full-ip-provider-list)

Install
-------

[](#install)

```
composer require geocoder-php/free-geoip-provider
```

Contribute
----------

[](#contribute)

Contributions are very welcome! Send a pull request to the [main repository](https://github.com/geocoder-php/Geocoder) or report any issues you find on the [issue tracker](https://github.com/geocoder-php/Geocoder/issues).

###  Health Score

54

—

FairBetter than 97% of packages

Maintenance59

Moderate activity, may be stable

Popularity46

Moderate usage in the ecosystem

Community27

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~406 days

Recently: every ~510 days

Total

8

Last Release

399d ago

PHP version history (5 changes)4.0.0PHP ^7.0

4.3.0PHP ^7.2

4.4.0PHP ^7.3 || ^8.0

4.5.0PHP ^7.4 || ^8.0

4.6.0PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/401ccc5eea13c60cf807ae982af00e368e2166e2f26d8eb541dcd881a57385bc?d=identicon)[Nyholm](/maintainers/Nyholm)

![](https://www.gravatar.com/avatar/b434ff5f6f9dcc7095f45c43254299b3cc8f6c83e9a757a80a6b7d229a4c9701?d=identicon)[jbelien](/maintainers/jbelien)

---

Top Contributors

[![Nyholm](https://avatars.githubusercontent.com/u/1275206?v=4)](https://github.com/Nyholm "Nyholm (32 commits)")[![jbelien](https://avatars.githubusercontent.com/u/1150563?v=4)](https://github.com/jbelien "jbelien (18 commits)")[![Chris53897](https://avatars.githubusercontent.com/u/7104259?v=4)](https://github.com/Chris53897 "Chris53897 (6 commits)")[![Stadly](https://avatars.githubusercontent.com/u/7263579?v=4)](https://github.com/Stadly "Stadly (4 commits)")[![atymic](https://avatars.githubusercontent.com/u/50683531?v=4)](https://github.com/atymic "atymic (2 commits)")[![leevigraham](https://avatars.githubusercontent.com/u/25124?v=4)](https://github.com/leevigraham "leevigraham (1 commits)")[![nicolas-grekas](https://avatars.githubusercontent.com/u/243674?v=4)](https://github.com/nicolas-grekas "nicolas-grekas (1 commits)")[![norkunas](https://avatars.githubusercontent.com/u/2722872?v=4)](https://github.com/norkunas "norkunas (1 commits)")[![JaZo](https://avatars.githubusercontent.com/u/3475007?v=4)](https://github.com/JaZo "JaZo (1 commits)")[![fbuchlak](https://avatars.githubusercontent.com/u/30214087?v=4)](https://github.com/fbuchlak "fbuchlak (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/geocoder-php-free-geoip-provider/health.svg)

```
[![Health](https://phpackages.com/badges/geocoder-php-free-geoip-provider/health.svg)](https://phpackages.com/packages/geocoder-php-free-geoip-provider)
```

###  Alternatives

[willdurand/geocoder-bundle

Integration of Geocoder into Symfony

3226.4M12](/packages/willdurand-geocoder-bundle)[geocoder-php/geo-plugin-provider

Geocoder GeoPlugin adapter

975.0M8](/packages/geocoder-php-geo-plugin-provider)[geocoder-php/chain-provider

Geocoder chain adapter

1046.8M13](/packages/geocoder-php-chain-provider)[geocoder-php/nominatim-provider

Geocoder Nominatim adapter

354.4M27](/packages/geocoder-php-nominatim-provider)[geocoder-php/ipstack-provider

Geocoder Ipstack adapter

60334.1k2](/packages/geocoder-php-ipstack-provider)[swisnl/geocoder-php-nationaal-georegister-provider

PDOK (formerly Nationaal Georegister) provider for Geocoder PHP

28330.8k2](/packages/swisnl-geocoder-php-nationaal-georegister-provider)

PHPackages © 2026

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