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
07-Apr-2008 05: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 07: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
10-Jun-2007 08: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
26-Feb-2007 08: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.

26-Jan-2007 05: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
16-Nov-2006 07: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 05: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
08-Sep-2006 01: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