geoip_record_by_name

(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
)

Коментарии

This function returns a PHP Notice when a address can not be found.
2012-01-11 03:04:37
http://php5.kiev.ua/manual/ru/function.geoip-record-by-name.html
Автор:
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.
<?php
# 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'];
echo 
$country;

# To combine information from the array into a string
$info implode("/"$info);
echo 
$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.
2013-05-07 06:42:52
http://php5.kiev.ua/manual/ru/function.geoip-record-by-name.html
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)){
            return;
        }

The rest of normal error handler code remains.
2014-01-21 07:02:36
http://php5.kiev.ua/manual/ru/function.geoip-record-by-name.html
Автор:
The array for region produces a number now instead of the 2 letter code.
2023-04-25 21:49:15
http://php5.kiev.ua/manual/ru/function.geoip-record-by-name.html

    Поддержать сайт на родительском проекте КГБ