PHP - Manual: checkdnsrr

2024-11-14

closelog »

« 网络函数

checkdnsrr

(PHP 4, PHP 5, PHP 7, PHP 8)

checkdnsrr — 给指定的主机（域名）或者IP地址做DNS通信检查

说明

checkdnsrr(string $host, string $type = "MX"): bool

根据不同记录（type）类型查询主机（host）相应的DNS记录。

参数

host: 主机（host）可以是一个IP地址也可以是域名。
type: 解析记录类型（type）可能是下面这些类型中的任何一个：A，MX，NS，SOA，PTR，CNAME，AAAA，A6， SRV，NAPTR，TXT 或者 ANY。

返回值

如果记录能找到，就返回true；如果查找不到该DNS记录或者发生了错误，就返回false。

更新日志

版本	说明
5.3.0	这个函数在Windows平台上也可以使用了。
5.2.4	增加了TXT的记录`类型`。
5.0.0	增加了AAAA的记录`类型`。

注释

注意:
出于对低版本在windows平台上的兼容性，可以试试» PEAR扩展包里面提供的 » Net_DNS类。

参见

dns_get_record() - 获取指定主机的DNS记录
getmxrr() - 获取互联网主机名对应的 MX 记录
gethostbyaddr() - 获取指定的IP地址对应的主机名
gethostbyname() - 返回主机名对应的 IPv4地址。
gethostbynamel() - 获取互联网主机名对应的 IPv4 地址列表
the named(8) manual page

add a note

User Contributed Notes 6 notes

down

Krisztin Ferenczi ¶

8 years ago


criffoh at gmail dot com is right. Before you check domain, you must convert to ascii with idn_to_ascii function:
http://us2.php.net/manual/en/function.idn-to-ascii.php .

var_dump(checkdnsrr('ñandu.cl', 'A')); // returns false
var_dump(checkdnsrr(idn_to_ascii('ñandu.cl'), 'A')); // return true

down

Martin ¶

5 years ago


Important Warning:

You need to add a dot to the end of the host name to make a fully qualified domain name.

To see why, try executing the following pieces of code:

$d1="gmail.con";
$d2="gmail.con.";
$r1=checkdnsrr($d1, "MX"); 
$r2=checkdnsrr($d2, "MX"); 
var_dump($r1);
var_dump($r2);

You will see that without the dot it claims that the domain "gmail.con" is valid.

Note that if you time the "checkdnsrr()" calls you will also see it takes longer without the dot because it treats it as a relative domain and does several tries based on the host name it is running on.

NB: in case you're interested, being treated as a relative domain explains what is happening. If your host is "example.com" the relative domain will eventually resolve to "gmail.con.com." which can be looked up, hence it wrongly claims "gmail.con" exists

down

Patrick ¶

17 years ago


This is a little code example that will validate an email address in two ways:
- first the general syntax of the string is checked with a regular expression
- then the domain substring (after the '@') is checked using the 'checkdnsrr' function

<?php

function validate_email($email){

   $exp = "^[a-z\'0-9]+([._-][a-z\'0-9]+)*@([a-z0-9]+([._-][a-z0-9]+))+$";

   if(eregi($exp,$email)){

      if(checkdnsrr(array_pop(explode("@",$email)),"MX")){
        return true;
      }else{
        return false;
      }

   }else{

      return false;

   }    
}

?>

down

n at zay dot uk ¶

11 months ago


I always think you should state the blindingly obvious.
A function that contains checkdnsrr will return false without an internet connection.
So in a production environment you need an active internet connection to return a true result with a valid email address.

down

-5

criffoh at gmail dot com ¶

8 years ago


Is not possible validate domains with 'ñ' for my country.

In my country is possible to register domain using 'ñ' character. For example:

ñandu.cl
http://nic.cl/cgi-bin/dom-CL?q=%F1andu

If I use this function to check DNS record, it return false, but the domain already exists:

var_dump(checkdnsrr('ñandu.cl', 'A')); // returns false

down

-9

dobs ¶

3 years ago


$this->_buf - for bulk check cache

function ValidateEmail($email)
    {
        list($user, $domain) = explode('@', $email);

        if (!filter_var($email, FILTER_VALIDATE_EMAIL) !== FALSE)
            return 0;

        if (isset($this->_buf[$domain]))
            return $this->_buf[$domain];

        if (checkdnsrr($domain) === FALSE) {
            $this->_buf[$domain] = 0;
            return 0;
        }
        $this->_buf[$domain] = 1;

        return 1;
    }

add a note

官方地址：https://www.php.net/manual/en/function.checkdnsrr.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地址转换函数 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet ADORecordSet对象 adodb手册 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 opcache预加载 Composer的Packagist资源 mysql面试题 [鸟哥]PHP FFI详解 - 一种全新的PHP扩展方式 PHP7添加redis扩展 PHP mkdir()写出来的权限与mode值不符合 Packagist / Composer 中国全量镜像 PHP获取指定函数定义在哪个文件中及行号支持php7的性能采集扩展 adodb连接mysql多个数据库的问题

略微加速

PHP官方手册 - 互联网笔记

checkdnsrr

说明

参数

返回值

更新日志

注释

参见

User Contributed Notes 6 notes