2017 © Pedro Peláez
 

library geoip

MaxMind GeoIP PHP API

image

geoip/geoip

MaxMind GeoIP PHP API

  • Saturday, February 10, 2018
  • by oschwald
  • Repository
  • 75 Watchers
  • 428 Stars
  • 1,015,185 Installations
  • PHP
  • 17 Dependents
  • 14 Suggesters
  • 300 Forks
  • 1 Open issues
  • 6 Versions
  • 6 % Grown

The README.md

MaxMind GeoIP Legacy PHP API

End of Life

MaxMind will be retiring the GeoIP Legacy databases at the end of May 2022. Until then, this library will only receive critical security and bug fixes. Support for this library will end completely with the last release of the legacy GeoIP databases., (*1)

We recommend that you upgrade to our GeoIP2 databases. You can read these from PHP with our GeoIP2 PHP API., (*2)

See our blog post for more information., (*3)

Requirements

This module has no external dependencies. You only need a MaxMind GeoIP database., (*4)

Install via Composer

We recommend installing this package with Composer., (*5)

Download Composer

To download Composer, run in the root directory of your project:, (*6)

curl -sS https://getcomposer.org/installer | php

You should now have the file composer.phar in your project directory., (*7)

Install Dependencies

Run in your project root:, (*8)

php composer.phar require geoip/geoip:~1.16

You should now have the files composer.json and composer.lock as well as the directory vendor in your project directory. If you use a version control system, composer.json should be added to it., (*9)

Require Autoloader

After installing the dependencies, you need to require the Composer autoloader from your code:, (*10)

require 'vendor/autoload.php';

Install without Composer

Place the 'geoip.inc' file in the include_path as specified in your php.ini file or place it in the same directory as your PHP scripts., (*11)

IP Geolocation Usage

IP geolocation is inherently imprecise. Locations are often near the center of the population. Any location provided by a GeoIP database should not be used to identify a particular address or household., (*12)

Usage

Gets country name by hostname :, (*13)

<?php

require 'vendor/autoload.php';

$gi = geoip_open("/usr/local/share/GeoIP/GeoIP.dat",GEOIP_STANDARD);

echo geoip_country_code_by_addr($gi, "24.24.24.24") . "\t" .
     geoip_country_name_by_addr($gi, "24.24.24.24") . "\n";
echo geoip_country_code_by_addr($gi, "80.24.24.24") . "\t" .
     geoip_country_name_by_addr($gi, "80.24.24.24") . "\n";

geoip_close($gi);

Memory Caching

To enable memory caching, pass GEOIP_SHARED_MEMORY or GEOIP_MEMORY_CACHE as the second argument of geoip_open., (*14)

GEOIP_SHARED_MEMORY requires php >= 4.0.4 compiled with --enable-shmop configure time. See (http://us2.php.net/manual/en/ref.shmop.php). In addition, you should call geoip_load_shared_mem before calling geoip_open. See sample_city.php for an example of shared memory caching., (*15)

Requirements

This code is tested on PHP 5.4 and greater. Older versions of PHP may work., (*16)

Support

For help with this API or our databases, please see our support page., (*17)

This software is Copyright (c) 2016 by MaxMind, Inc., (*18)

This is free software, licensed under the GNU Lesser General Public License version 2.1 or later., (*19)

Thanks

Thanks to Jim Winstead., (*20)

The Versions

10/02 2018

dev-master

9999999-dev http://dev.maxmind.com/geoip/legacy/downloadable

MaxMind GeoIP PHP API

  Sources   Download

LGPL 2.1+ LGPL-2.1-or-later

The Development Requires

geoip geolocation maxmind

16/05 2016

v1.17

1.17.0.0 http://dev.maxmind.com/geoip/legacy/downloadable

MaxMind GeoIP PHP API

  Sources   Download

LGPL 2.1+

The Development Requires

geoip geolocation maxmind

29/01 2016

v1.16

1.16.0.0 http://dev.maxmind.com/geoip/legacy/downloadable

MaxMind GeoIP PHP API

  Sources   Download

LGPL 2.1+

The Development Requires

geoip geolocation maxmind

01/05 2015

v1.15

1.15.0.0 http://dev.maxmind.com/geoip/legacy/downloadable

MaxMind GeoIP PHP API

  Sources   Download

LGPL 2.1+

The Development Requires

geoip geolocation maxmind

05/11 2013

v1.14

1.14.0.0 http://dev.maxmind.com/geoip/legacy/downloadable

MaxMind GeoIP PHP API

  Sources   Download

LGPL 2.1+

geoip geolocation maxmind

27/05 2013

v1.13

1.13.0.0 http://dev.maxmind.com/geoip/legacy/downloadable

MaxMind GeoIP PHP API

  Sources   Download

LGPL 2.1+

geoip geolocation maxmind