geoip_record_by_name

(PECL geoip >= 0.2.0)

geoip_record_by_name — Devuelve información detallada de la Ciudad encontrada en la base de datos de GeoIP

Descripción

geoip_record_by_name ( string $hostname ) : array

La función geoip_record_by_name() devuelve información a partir de un nombre de host o de una dirección IP.

Esta función está disponible tanto para la edición GeoLite City como para la edición comercial GeoIP City. Si no se encontrara la base de datos apropiada, se emitirá una alerta.

Los nombres de las claves del array asociativo son:

  • "continent_code" -- Código de continente en dos letras (a partir de la versión 1.0.4 con libgeoip 1.4.3 o superior)
  • "country_code" -- Código de país de dos letras (consulte geoip_country_code_by_name())
  • "country_code3" -- Código de país de tres letras (consulte geoip_country_code3_by_name())
  • "country_name" -- Nombre del país (consulte geoip_country_name_by_name())
  • "region" -- Código de la región (p.ej: CA para California)
  • "city" -- Ciudad.
  • "postal_code" -- Código postal, FSA o Código Zip.
  • "latitude" -- Latitud en forma de tipo double con signo.
  • "longitude" -- Longitud en forma de tipo double con signo.
  • "dma_code" -- Código de Área de Mercado Designado (sólo en EEUU y en Canadá)
  • "area_code" -- Código de área PSTN (p. ej: 212)

Parámetros

hostname

Nombre de host o dirección IP que se va a consultar.

Valores devueltos

En caso de éxito devuelve un array asociativo, o FALSE si no se pudiera encontrar la dirección en la base de datos.

Historial de cambios

Versión Descripción
1.0.4 Añadido el código de continente, con la biblioteca GeoIP 1.4.3 o superior.
1.0.3 Añadido código de país de 3 letras, y nombre de país.

Ejemplos

Ejemplo #1 Ejemplo de geoip_record_by_name()

Muestra el array que contiene el registro del host example.com.

<?php
$record = geoip_record_by_name('www.example.com');
if ($record) {
    print_r($record);
}
?>

El resultado del ejemplo sería:

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
)