geoip_record_by_name - Возвращает подробную информацию об адресе, найденном в базе GeoIP
Вернуться к: GeoIP Функции
geoip_record_by_name
(PECL geoip >= 0.2.0)
geoip_record_by_name — Возвращает подробную информацию об адресе, найденном в базе GeoIP
Описание
$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
)
Вернуться к: GeoIP Функции