Возвращает подробную информацию об адресе, найденом в базе GeoIP


(PECL geoip >= 0.2.0)

geoip_record_by_nameВозвращает подробную информацию об адресе, найденом в базе GeoIP

Описание

array geoip_record_by_name ( string $hostname )

Функция geoip_record_by_name() возвращает информацию о соответствующем имени хоста или IP адреса.

Функция доступна для бесплатной версии GeoLite City Edition и коммерческой GeoIP City Edition. Если необходимые базы отсутствует, выводится предупреждение.

Имена ключей возвращаемого ассоциативного массива:

  • "continent_code" -- Две буквы кода континента (начиная с версии 1.0.4 с libgeoip 1.4.3 или более поздней)
  • "country_code" -- Две буквы кода страны (см. geoip_country_code_by_name())
  • "country_code3" -- Три буквы кода страны (см. geoip_country_code3_by_name())
  • "country_name" -- Название страны (см. geoip_country_name_by_name())
  • "region" -- Код Региона (например: CA для Калифорнии)
  • "city" -- Город.
  • "postal_code" -- Почтовый индекс.
  • "latitude" -- Широта, знаковое вещественное число (signed double).
  • "longitude" -- Долгота, знаковое вещественное число (signed double).
  • "dma_code" -- Код рыночной зоны (DMA, только для США и Канады)
  • "area_code" -- Код телефонной сети общего пользования (PSTN, например: 212)

Список параметров

hostname

Имя хоста или IP адрес, данные о котором должны быть получены.

Возвращаемые значения

Возвращает ассоциативный массив в случае успеха или FALSE, если адрес не может быть найден в базе.

Список изменений

Версия Описание
1.0.4 Добавленен код континента (continent_code) с GeoIP Library 1.4.3 или более поздними.
1.0.3 Добавлен трехбуквенный код страны (country_code3) и название страны (and country_name).

Примеры

Пример #1 Пример использования geoip_record_by_name()

Выведет массив, содержащий запись о хосте example.com.

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

Результат выполнения данного примера:

 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 )