PHP 7.4.24 Released!


(PECL geoip >= 0.2.0)

geoip_record_by_nameDevuelve información detallada de la Ciudad encontrada en la base de datos de GeoIP


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)



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.


Ejemplo #1 Ejemplo de geoip_record_by_name()

Muestra el array que contiene el registro del host

if (
$record) {

El resultado del ejemplo sería:

    [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

add a note add a note

User Contributed Notes 3 notes

8 years ago
I know this may be obvious to some but I thought I would post it anyway to help others. The GEOIP section of the PHP site is a bit limited in useful tips/documentation other than the initial functions and examples.

If you are trying to get information about the specific user visiting your site, you should use their IP address via the remote address in the GEOIP function. In addition here are some useful bits of code to pull certain information from the function.
# Collect a specific users GEOIP info
$info = geoip_record_by_name($_SERVER['REMOTE_ADDR']);
print_r ($info);

# To get the info from one specific field
$country = $info['country_name'];

# To combine information from the array into a string
$info = implode("/", $info);

Note on field in this array is NOT included, the connection speed of the user. To find the connection speed/connection type the visitor has, you can use the geoip_id_by_name() function. Lastly it is a good idea on whatever platform you are using GEOIP on to make sure it's data is up-to-date. On most Linux/UNIX systems with terminal you can use "pear update-channels" and "pecl update-channels" commands to keep your libraries updated. This is a good idea because GEOIP databases and country/location codes often change over time.
wouter dot berben at ignitione dot com
9 years ago
This function returns a PHP Notice when a address can not be found.
bogdan at grabinski dot com
7 years ago
I use this additional code in my error handler class to suppress "PHP Notice" send by the function geoip_record_by_name() in case of IP not found. No e-mails or echo on display is welcome for this notice in development environment.

public static function Handler($errNo, $errStr, $errFile, $errLine){
   $backtrace = ErrorHandler::GetBacktrace(2);
   // detection of unwelcome  PHP Notice and its ignoring.
   if($errNo == E_NOTICE && preg_match('/^geoip_record_by_name.*Host.*not found$/', $errStr)){

The rest of normal error handler code remains.
To Top