geoip_record_by_name

Returns the detailed City information found in the GeoIP Database

&reftitle.description; `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:

- "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 `float`.

- "longitude" -- The Longitude as signed `float`.

- "dma_code" -- Designated Market Area code (USA and Canada only)

- "area_code" -- The PSTN area code (ex: 212)

&reftitle.parameters;

`hostname`

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

&reftitle.returnvalues;

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

&reftitle.changelog;

&Version; | &Description;
PECL geoip 1.0.4 | Adding the continent_code with GeoIP Library 1.4.3 or newer only
PECL geoip 1.0.3 | Adding country_code3 and country_name

&reftitle.examples;

### 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);
    }
    ?>

&example.outputs;

    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
    )