geoip_record_by_name
(PECL geoip >= 0.2.0)
geoip_record_by_name — Returns the detailed City information found in the GeoIP Database
Description
$hostname
) : arrayThe 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:
- "continent_code" -- Two letter continent code (as of version 1.0.4 with libgeoip 1.4.3 or newer)
- "country_code" -- Two letter country code (see geoip_country_code_by_name())
- "country_code3" -- Three letter country code (see geoip_country_code3_by_name())
- "country_name" -- The country name (see geoip_country_name_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" -- Designated Market Area code (USA and Canada only)
- "area_code" -- The PSTN area code (ex: 212)
Return Values
Returns the associative array on success, or FALSE
if the address
cannot be found in the database.
Changelog
Version | Description |
---|---|
1.0.4 | Adding the continent_code with GeoIP Library 1.4.3 or newer only |
1.0.3 | Adding country_code3 and country_name |
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 ( [continent_code] => NA [country_code] => US [country_code3] => USA [country_name] => United States [region] => CA [city] => Marina Del Rey [postal_code] => [latitude] => 33.9776992798 [longitude] => -118.435096741 [dma_code] => 803 [area_code] => 310 )
English translation
You have asked to visit this site in English. For now, only the interface is translated, but not all the content yet.If you want to help me in translations, your contribution is welcome. All you need to do is register on the site, and send me a message asking me to add you to the group of translators, which will give you the opportunity to translate the pages you want. A link at the bottom of each translated page indicates that you are the translator, and has a link to your profile.
Thank you in advance.
Document created the 30/01/2003, last modified the 26/10/2018
Source of the printed document:https://www.gaudry.be/en/php-rf-geoip-record-by-name.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.