Last updated: Sun, 25 Nov 2007

GeoIP Functions

簡介

The GeoIP extension allows you to find the location of an IP address. City, State, Country, Longitude, Latitude, and other information as all, such as ISP and connection type can be obtained with the help of GeoIP.

需求

This extension requires the GeoIP C library version 1.4.0 or higher to be installed. You can grab the latest version from » http://www.maxmind.com/app/c and compile it yourself.

By default, you will only have access to the Free GeoIP Country or GeoLite City databases. While this module can work with other types of database, you must buy a commercial license from » Maxmind.

安裝

本 » PECL 擴充功能未包含於 PHP 中。

安裝此 PECL 擴充功能的訊息可在手冊中標題為 PECL 擴充功能安裝的一章中找到。更多訊息如新版本，下載，原始文件，維護者訊息以及更新日誌等可以在這裡找到： » http://pecl.php.net/package/geoip.

資源類型

本擴充功能未定義任何資源類型。

預設常數

以下常數由擴充功能定義，因此只有在擴充功能被編譯到 PHP 中，或者在執行時被動態載入後才有效。

GEOIP_COUNTRY_EDITION (integer)
GEOIP_REGION_EDITION_REV0 (integer)
GEOIP_CITY_EDITION_REV0 (integer)
GEOIP_ORG_EDITION (integer)
GEOIP_ISP_EDITION (integer)
GEOIP_CITY_EDITION_REV1 (integer)
GEOIP_REGION_EDITION_REV1 (integer)
GEOIP_PROXY_EDITION (integer)
GEOIP_ASNUM_EDITION (integer)
GEOIP_NETSPEED_EDITION (integer)
GEOIP_DOMAIN_EDITION (integer)

The following constants are for net speed:

GEOIP_UNKNOWN_SPEED (integer)
GEOIP_DIALUP_SPEED (integer)
GEOIP_CABLEDSL_SPEED (integer)
GEOIP_CORPORATE_SPEED (integer)

geoip_country_code_by_name — Get the two letter country code
geoip_country_code3_by_name — Get the three letter country code
geoip_country_name_by_name — Get the full country name
geoip_database_info — Get GeoIP Database information
geoip_db_avail — Determine if GeoIP Database is available
geoip_db_filename — Returns the filename of the corresponding GeoIP Database
geoip_db_get_all_info — Returns detailed informations about all GeoIP database types
geoip_id_by_name — Get the Internet connection speed
geoip_isp_by_name — Get the Internet Service Provider (ISP) name
geoip_org_by_name — Get the organization name
geoip_record_by_name — Returns the detailed City information found in the GeoIP Database
geoip_region_by_name — Get the country code and region

geoip_country_code_by_name

unregister_tick_function

Last updated: Sun, 25 Nov 2007

add a note User Contributed Notes
GeoIP

thomas {AT} thomasfischer {D0T} BIZ
08-Apr-2008 08:04


you can use this function to determine the continent of a country:



function getContinentFromCountry($country)

{

 $data = array ("AF"=> "AS","AX"=>"EU","AL"=>"EU", "DZ"=>"AF","AS"=>"OC", "AD"=>"EU","AO"=> "AF" ........);

 return $data[$country];

}



unfortunately this comment's size is restricted, so you will have the rest by yourself



for example:

getContinentFromCountry("DE") will result in "EU"



this data is based on 

wikipedia's

List_of_countries_by_continent_(data_file)

kapouer at melix dot org
01-Mar-2008 11:26


For Debian etch users : libgeoip is in version 1.4 so get the source from lenny (apt-get build-dep libgeoip;apt-get source libgeoip), compile it on etch (dpkg-buildpackage -rfakeroot in source folder) and install resulting libgeoip1 and libgeo-dev packages (dpkg -i)... Together with php5-dev this package is easy to install (phpize5;./configure --enable-geoip;make;make install)... Then check your install in php with :

<?php

    echo geoip_database_info(GEOIP_COUNTRY_EDITION);

    echo $_SERVER['REMOTE_ADDR'];

    echo geoip_country_code3_by_name($_SERVER['REMOTE_ADDR']);

?>



please note free .dat is in /usr/share/GeoIP/GeoIP.dat

Use geoip-bin package to schedule automatic updates (configure /etc/geoip.default.conf and copy to /etc/geoip.conf, then add a crontab to make the updates...)

hope this helps

php dot comment dot addition at gmail dot com
11-Jun-2007 11:57


Just to clarify the other comments, the maxmind post seems to be out of date / incorrect.  



This module fails to work (ie: resolve cities) with the GeoLite City database from here:

http://www.maxmind.com/app/geolitecity



The error occurs when calling the function geoip_record_by_name(), which states incorrectly that the required database is not available.  I have tested it with the very latest database, for which geoip_database_info() returns  the version:

GEO-533LITE 20070601 Build 1 Copyright (c) 2007 MaxMind LLC All Rights Reserved



It does, however, resolve countries OK via the GeoLite Country database, which you can grab here: http://www.maxmind.com/app/geoip_country

I tested with the version:



GEO-106FREE 20070601 Build 1 Copyright (c) 2007 MaxMind LLC All Rights Reserved

tjmather at maxmind dot com
27-Feb-2007 12:09


The geoip_country_*_by_name functions only work with GeoIP Country.  The geoip_record_by_name function works with GeoIP City.  geoip_region_by_name works with GeoIP Region.  So the API should work with all of the GeoIP databases, as long as you call the correct function.

27-Jan-2007 09:23


I couldn't get it to work with the DMA code database (product ID 137).  It seems to only work with the country database.  The documentation should contain a warning that this code (as of 0.2.0) is incomplete and that Net_GeoIP should be used for non-country databases.

judas dot iscariote at gmail dot com
17-Nov-2006 11:59


If you want to use this extension in SUSE/openSUSE, it is available here:



http://repos.opensuse.org/server:/php:/extensions/

Christian
13-Sep-2006 08:45


Both, Ubuntu and Debian itself make usage of version 1.3.x of the c libraries, so installation can't be done with the debian packages, because configure stops with:

 

== configure: error: You need version 1.4.0 or higher of the C API ==



so you must download it from maxmind.

Matt
09-Sep-2006 04:34


If you are a Debian or Ubuntu user, instead of building it from source, you can: 

aptitude install libgeoip-dev libgeoip1

add a note

geoip_country_code_by_name

unregister_tick_function

Last updated: Sun, 25 Nov 2007

GeoIP Functions

簡介

需求

安裝

資源類型

預設常數

Table of Contents