geoip_functions.php

function geoip_open_db( $use_cache  =  FALSE )

Opens GeoIP-database for use.

Prototype

handle geoip_open_db( bool $use_cache )

Parameters

Returns

A GeoIP Database-Handle.

In case of error, the function returns FALSE.

Note

You should use geoip_open_db(TRUE) if you call geoip functions more than once.

function geoip_close_db( $gi )

Closes GeoIP-database after use.

Prototype

void geoip_close_db( handle $gi )

Parameters

Returns

nothing.

function geoip_flag_html( $gi, $src )

Returns a piece of HTML-code to display a flag.

Prototype

string geoip_flag_html( handle $gi, string source )

Parameters

Returns

A string, containing a piece of code to display an image from the supplied flags-collection.

For an unkown IP or Country-Name or -Code, the special (empty) __.png-flag will be returned.

Example

echo geoip_flag_html($gi, '87.90.102.80');

may output

<img class="geoip_worldflag"
     src="http://www.example.org/wb/modules/geoip/worldflags/de.png"
     alt="Germany" title="Germany" />

function geoip_flag_link( $gi, $src )

Returns an absolute URL to a flag-image.

Prototype

string geoip_flag_link( handle $gi, string source )

Parameters

Returns

A string, containing an absolute URL to an image from the supplied flags-collection.

For an unkown IP or Country-Name or -Code, a URL to the special (empty) __.png-flag will returned.

Example

echo geoip_flag_link($gi, '87.90.102.80');

may output

http://www.example.org/wb/modules/geoip/worldflags/de.png

function geoip_best_ip()

Fetches best matching IP for actual connection.

The "best matching" IP is either the User-IP, or, if the user is hidden behind a proxy, that Proxy-IP.

Prototype

string geoip_best_ip( void )

Parameters

Uses

$_SERVER['REMOTE_ADDR'] and miscellaneous other $_SERVER[] variables

Returns

A string with the fetched IP.

There is no guarantee that the fetched ip is really "real"; users may forge it.  But this is better than nothing

Note

There is no need to check the returned IP against geoip_in_bogons_list(), since this is done inside this function already.

function geoip_list_ip()

Fetches user-ip and proxy-ip, if available.

Prototype

array geoip_list_ip( void )

Parameters

Uses

$_SERVER['REMOTE_ADDR'] and miscellaneous other $_SERVER[] variables

Returns

An array with User-IP and Proxy-IP (array(0=>'100.10.20.3', 1=>'200.20.10.20') ).  User-IP or Proxy-IP may be FALSE

There is no guarantee that the fetched ip is really "real"; users may forge it.  But this is better than nothing

Example

list($real_ip, $proxy_ip) = geoip_list_ip($_SERVER['REMOTE_ADDR']);

$real_ip │ $proxy_ip │ meaning
─────────┼───────────┼──────────────────────────────
100.1.2.3│   FALSE   │ real ip, no proxy ip
 FALSE   │ 200.1.2.3 │ real ip unknown, proxy ip
100.1.2.3│ 200.3.2.1 │ real ip, proxy ip

Note

There is no need to check the returned User-IP (if any) against geoip_in_bogons_list(), since this is done inside this function already.

function geoip_fetch_hostname( $ip )

Fetches hostname for given IP.

Prototype

string geoip_fetch_hostname( string $ip )

Parameters

Returns

The resolved Hostname, or the given IP if it isn't resolvable or if the hostname is faked.

Examples

echo geoip_fetch_hostname('87.20.30.40');

host40-30-dynamic.20-87-r.retail.telecomitalia.it

echo geoip_fetch_hostname('100.20.30.40');

100.20.30.40

function geoip_list_hostname( $ip )

Fetches and checks hostname for a given IP.

Prototype

array geoip_list_hostname( string $ip )

Parameters

Returns

An array which will contain the hostname and the result of the hostname-check as int-value.  array(0=>'faked.example.com', 1=>0)

Example

list($hostname, $result) = geoip_list_hostname($_SERVER['REMOTE_ADDR']);

    $hostname     │result│ meaning
──────────────────┼──────┼───────────────────────────────────────────
 faked.google.com │   0  │ hostname faked
dd-112.example.org│   1  │ ok
     200.2.3.1    │   2  │ no hostname
xx3323.example.com│   3  │ hostname has no ip (don't care about this)

Just consider $result >0 as 'real' hostnames.

if($result==0) { // faked }
else { // OK }

function geoip_is_proxy()

Checks if the actual user ( $_SERVER['REMOTE_ADDR'] ) is behind a proxy.

Prototype

bool geoip_is_proxy( void )

Parameters

Uses

Miscellaneous $_SERVER[]; variables

Returns

TRUE if the user is behind a proxy.  FALSE if there is no evidence for a proxy.

function geoip_in_bogons_list( $ip )

Checks if the given IP is in an unallocated or private address range.

Prototype

bool geoip_in_bogons_list( string $ip )

Parameters

Returns

TRUE if the IP is in the bogons-list, FALSE if it is not.

Examples

$ip = '127.0.0.1';
if(geoip_in_bogons_list($ip)) {
  echo 'private address -- useless';
} else {
  echo 'OK';
}

Will output private address -- useless for ip 127.0.0.1

function geoip_in_drop_list( $ip )

Checks if the given IP is in spamhaus' drop-list.

DROP (Don't Route Or Peer) is an advisory "drop all traffic" list, consisting of stolen 'zombie' netblocks and netblocks controlled entirely by professional spammers.

Prototype

bool geoip_in_drop_list( string $ip )

Parameters

Returns

TRUE if the IP is in drop-list, FALSE if it is not.

Fetches country-code by ip.

See geoip_country_code_by_addr

Fetches country-name by ip.

See geoip_country_name_by_addr

Create a clickable link for a WhoIs-Query.

See Usage of phpwhois and geoip_whois_link