« geoip\_org\_by\_namegeoip\_region\_by\_name »PHP ManualФункції GeoIP

geoip_record_by_name

(PECL geoip >= 0.2.0)

geoip_record_by_name — Повертає детальну інформацію про адресу, знайдену в базі GeoIP

Опис

geoip_record_by_name(string $hostname): array

Функция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" -- Поштовий індекс, FSA або Zip-код
  • " Latitude " -- Широта, число з плаваючою точкою (float) без знака.
  • "longitude" - Довгота, число з плаваючою точкою (float) без знака.
  • "dma_code" -- Код ринкової зони (Designated Market Area, DMA), тільки для США та Канади
  • "area_code" -- Код телефонної мережі загального користування (PSTN), наприклад, 212

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

hostname

Ім'я хоста або IP-адреса, дані за якою мають бути отримані.

Значення, що повертаються

Повертає асоціативний масив у разі успішного виконання або **false**Якщо адреса не може бути знайдена в базі.

список змін

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

Приклади

Приклад #1 Приклад використання geoip_record_by_name()****

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

Loading...

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

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
)