geoip_record_by_name
(PECL geoip:0.2.0-1.0.1)
geoip_record_by_name — Returns the detailed City information found in the GeoIP Database
Description
array geoip_record_by_name
( string $hostname
)
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 #1 A geoip_record_by_name() example
This will print the array containing the record of host example.com.
<?php
$record = geoip_record_by_name('www.example.com');
if ($record) {
print_r($record);
}
?>
The above example will output:
Array
(
[country_code] => US
[region] => CA
[city] => Marina Del Rey
[postal_code] =>
[latitude] => 33.9776992798
[longitude] => -118.435096741
[dma_code] => 803
[area_code] => 310
)