geoip_record_by_name

Returns the detailed City information found in the GeoIP Database (PECL geoip:0.2.0-1.0.1)
array geoip_record_by_name ( string hostname )

The geoip_record_by_name() function will return the record information corresponding to a hostname or an IP address.

This function is available for both GeoLite City Edition and commercial GeoIP City Edition. A warning will be issued if the proper database cannot be located.

The names of the different keys of the returning associative array are as follows:

"country_code" -- Two letter country code (see geoip_country_code_by_name())
"region" -- The region code (ex: CA for California)
"city" -- The city.
"postal_code" -- The Postal Code, FSA or Zip Code.
"latitude" -- The Latitude as signed double.
"longitude" -- The Longitude as signed double.
"dma_code"
"area_code" -- The PSTN area code (ex: 212)

Parameters

hostname: The hostname or IP address whose record is to be looked-up.

Return Values

Returns the associative array on success, or FALSE if the address cannot be found in the database.

Examples

Example 774. A geoip_record_by_name() example

This will print the array containing the record of host example.com.

copy to clipboard

<?php

$record = geoip_record_by_name('www.example.com');

if ($record) {

    print_r($record);

}
?>

The above example will output: