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 版本和商业 GeoIP City 版本中可用。版本不对的话，将会抛出一个警告。

返回的关联数组不同的键名对应如下：

"continent_code" -- 由两个字符组成的洲简称。(要求 GeoIP 的库版本是1.0.4以上)
"country_code" -- 由2个字母组成的国家简称。(参见 geoip_country_code_by_name())
"country_code3" -- 由三个字母组成的国家简称。(参见 geoip_country_code3_by_name())
"country_name" -- 国家名称 (参见 geoip_country_name_by_name())
"region" -- 地区代码 (比如: CA 对应 California)
"city" -- 城市名称。
"postal_code" -- 邮编，FSA 或者 Zip 编码。
"latitude" -- 有符号的双精度纬度。
"longitude" -- 有符号的双精度经度。
"dma_code" -- 指定市场区号 (只支持美国和加拿大)
"area_code" -- PSTN （公共交换电话网络）地区代码。 (比如: 212)

参数

hostname: 所要查找的主机或者 IP 地址。

返回值

成功，返回关联数组，未找到相关信息则返回 false 。

更新日志

版本	说明
1.0.4	给 GeoIP 1.4.4及以上版本的库添加 continent_code 字段。
1.0.3	添加 country_code3 和 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
)

add a note

User Contributed Notes 3 notes

down

etbwebdesign.com ¶

9 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.
<?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.

down

wouter dot berben at ignitione dot com ¶

10 years ago


This function returns a PHP Notice when a address can not be found.

down

-13

bogdan at grabinski dot com ¶

8 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)){
            return;
        }

The rest of normal error handler code remains.

add a note

官方地址：https://www.php.net/manual/en/function.geoip-record-by-name.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络数据库 JAVA 面试 NoSQL C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 PHP 8.1 ADORecordSet对象 adodb手册 opcache预加载 Composer的Packagist资源 array_multisort() 多字段排序 mysql面试题 PHPMailer设置utf8 PHPMailer字符集CharSet PHP json解析（json_decode）页面工具纯php实现DES以及TripleDES加密算法 [原创]诡异的php-fpm超时问题 php中几种注释规范 PHP获取指定函数定义在哪个文件中及行号 php上周一、本周一、下周一日期 [鸟哥]PHP FFI详解 - 一种全新的PHP扩展方式

略微加速

PHP官方手册 - 互联网笔记

geoip_record_by_name

说明

参数

返回值

更新日志

范例

User Contributed Notes 3 notes