dns_get_record

(PHP 5, PHP 7, PHP 8)

dns_get_record — Получение ресурсных записей DNS хоста

Описание

dns_get_record(
    string $hostname,
    int $type = DNS_ANY,
    array &$authoritative_name_servers = null,
    array &$additional_records = null,
    bool $raw = false
): array|false

Производит выборку DNS-записей, соответствующих свойствам хоста hostname.

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

hostname: Параметр hostname должен быть корректным DNS-именем таким как "www.example.com". Обратное разрешение имён хостов может быть произведено с использованием нотации in-addr.arpa, однако, для этой цели лучше воспользоваться функцией gethostbyaddr().

Замечание:
В соответствии со стандартами DNS, адреса электронной почты задаются в формате user.host (например, hostmaster.example.com в отличие от hostmaster@example.com), поэтому будьте внимательны и дополнительно проверьте это значение, прежде чем использовать его в таких функциях, как mail().
type: По умолчанию dns_get_record() будет искать все возможные записи, соответствующие заданному имени хоста hostname. Чтобы сузить круг поиска, можно задать необязательный параметр type. Этот параметр может принимать следующие значения: DNS_A, DNS_CNAME, DNS_HINFO, DNS_CAA, DNS_MX, DNS_NS, DNS_PTR, DNS_SOA, DNS_TXT, DNS_AAAA, DNS_SRV, DNS_NAPTR, DNS_A6, DNS_ALL или DNS_ANY.

Замечание:
Из-за неоднозначного поведения libresolv на разных платформах, DNS_ANY может вернуть не все записи, более медленный DNS_ALL вернёт все записи надёжнее.

Замечание:
Windows: DNS_CAA не поддерживается. Поддержка DNS_A6 не реализована.
authoritative_name_servers: Передаётся по ссылке и, если передан, будет заполняться ресурсными записями для удостоверяющих серверов имён (Authoritative Name Servers).
additional_records: Передаётся по ссылке и, если передан, будет заполняться дополнительными записями (Additional Records).
raw: type будет интерпретирован, как необработанный идентификатор типа DNS (нельзя использовать константы DNS_*). Возвращаемое значение будет содержать ключ data, который необходимо проанализировать вручную.

Возвращаемые значения

Эта функция возвращает массив ассоциативных массивов или false в случае возникновения ошибки. Каждый ассоциативный массив содержит по меньшей мере следующие ключи:

**Основные атрибуты DNS**
Атрибут	Описание
host	Запись в пространстве имён DNS, на которую ссылается оставшаяся часть данных.
class	dns_get_record() возвращает только записи класса Internet, соответственно этот параметр всегда будет принимать значение `IN`.
type	Строка, содержащая тип записи. Дополнительные атрибуты также будут содержаться в результирующем массиве в зависимости от типа. По одному вложенному массиву на каждый тип. Смотрите таблицу ниже.
ttl	Время жизни (`"Time To Live"`) оставшееся для этой записи. Это не исходное ttl записи. Оно равно исходному за вычетом времени прошедшего с момента отправки запроса на сервер.

**Другие ключи ассоциативного массива, соответствующие типу 'type'**
Тип записи	Дополнительные данные
`A`	`ip`: адреса IPv4 в десятичном формате с разделителями точками.
`MX`	`pri`: Приоритет почтового сервера. Чем ниже число, тем выше приоритет. `target`: FQDN почтового сервера. Смотрите также dns_get_mx().
`CNAME`	`target`: FQDN места расположения в пространстве имён DNS, на которое указывает запись.
`NS`	`target`: FQDN имя сервера, который является авторитетным для этого имени хоста.
`PTR`	`target`: Расположение без указания пространства имён DNS, на которое указывает запись.
`TXT`	`txt`: Строка данных, связанных с этой записью.
`HINFO`	`cpu`: число IANA, обозначающее модель процессора компьютера, на который указывает эта запись. `os`: число IANA, обозначающее операционную систему компьютера, на который указывает эта запись. Смотрите дополнительно IANA » `Operating System Names`.
`CAA`	`flags`: Однобайтовое битовое поле; в текущий момент определён только бит номер 0, называющийся 'critical'; другие биты зарезервированы и должны игнорироваться. `tag`: Имя тега CAA (буквенно-числовая строка ASCII). `value`: Значение тега CAA (бинарная строка, можно использовать подформаты). Более подробно читайте тут: » RFC 6844
`SOA`	`mname`: FQDN изначального компьютера, с которого получены ресурсные записи. `rname`: Адрес электронной почты администратора домена. `serial`: Порядковый номер этой ревизии запрашиваемого домена. `refresh`: Интервал времени (в секундах), который должны использовать вторичные сервера при обновлении удалённых копий этого домена. `retry`: Время ожидания (в секундах) после неудачного обновления до следующей попытки. `expire`: Максимальное время (в секундах), в течение которого вторичный DNS-сервер должен держать в памяти данные удалённых копий доменной зоны, прежде чем ответить отказом, когда не удаётся обновить данные. `minimum-ttl`: Минимальное время (в секундах), в течение которого клиент может работать с текущим DNS-разрешением, прежде чем ему придётся повторно запрашивать это разрешение. Значение может быть замещено отдельными ресурсными записями.
`AAAA`	`ipv6`: адрес IPv6
`A6`	`masklen`: Длина (в битах), которую нужно унаследовать от целевого адреса `chain`. `ipv6`: Адрес для этой конкретной записи, который нужно объединить с `chain`. `chain`: Запись, которую нужно дополнить данными `ipv6`.
`SRV`	`pri`: (Приоритет) меньшие значения должны использоваться первыми. `weight`: Ранжирование. Записям с большим весом отдаётся предпочтение. `targets` должен выбираться случайно. `target` и `port`: имя хоста и номер порта, на котором можно найти запрошенную службу. Дополнительную информацию можно получить по ссылке: » RFC 2782
`NAPTR`	`order` и `pref`: Эквивалентны `pri` и `weight` приведённым выше. `flags`, `services`, `regex` и `replacement`: Параметры, определённые в » RFC 2915.

Список изменений

Версия	Описание
7.0.16, 7.1.2	Добавлена поддержка записей типа CAA.

Примеры

Пример #1 Пример использования dns_get_record()

<?php
$result = dns_get_record("php.net");
print_r($result);
?>

Вывод приведённого примера будет похож на:

Array
(
    [0] => Array
        (
            [host] => php.net
            [type] => MX
            [pri] => 5
            [target] => pair2.php.net
            [class] => IN
            [ttl] => 6765
        )

    [1] => Array
        (
            [host] => php.net
            [type] => A
            [ip] => 64.246.30.37
            [class] => IN
            [ttl] => 8125
        )

)

Пример #2 Использование dns_get_record() с DNS_ANY

Так как довольно часто требуется определить IP-адрес почтового сервера, после того как запись MX была разрешена, dns_get_record() возвращает массив additional_records с соответствующими записями. Массив authoritative_name_servers будет содержать список удостоверяющих DNS-серверов.

<?php
/* Отправим "ANY" запрос к php.net,
   создадим массивы $authns и $addtl,
   в которые будут помещён список серверов
   имён и дополнительные записи,
   соответствующие этим серверам
*/
$result = dns_get_record("php.net", DNS_ANY, $authns, $addtl);
echo "Результат = ";
print_r($result);
echo "Удостоверяющие серверы = ";
print_r($authns);
echo "Дополнительные записи = ";
print_r($addtl);
?>

Вывод приведённого примера будет похож на:

Смотрите также

dns_get_mx() - Псевдоним getmxrr
dns_check_record() - Псевдоним checkdnsrr

add a note

User Contributed Notes 9 notes

down

tobias at herkula dot info ¶

9 years ago


This method has no error handling, it simply puts out "false" and it is impossible to check for NXDOMAIN, SERVFAIL, TIMEOUT or any other error...

down

NaturalBornCamper ¶

7 years ago


You might have the same problem as me, where testing a non-existent domain will search for a subdomain relative to the domain you are executing from, for example:

// Test with working domain
var_dump( dns_get_record('google.com', DNS_A) );
/* works, returns
Array
(
    [host] => google.com
    [class] => IN
    [ttl] => 299
    [type] => A
    [ip] => 172.217.12.142
)
*/

// Test with invalid domain on our website (example.com)
var_dump( dns_get_record('invalidtestingname.com', DNS_A) );
/* Doesn't work, pretend it's a subdomain
Array
(
    [host] => invalidtestingname.com.example.com
    [class] => IN
    [ttl] => 299
    [type] => A
    [ip] => xxx.xxx.xxx.xxx
)
*/

If anyone has that problem, add a "dot" at the end of the domain name, for example, instead of
dns_get_record('invalidtestingname.com', DNS_A);
Do this:
dns_get_record('invalidtestingname.com.', DNS_A);

down

dylan at pow7 dot com ¶

15 years ago


Get more than one type at once like this:
<?php
$dnsr = dns_get_record('php.net', DNS_A + DNS_NS);
print_r($dnsr);
?>

Using DNS_ALL fails on some domains where DNS_ANY works. I noticed the function getting stuck on the DNS_PTR record, which caused it to return FALSE with this error:
PHP Warning:  dns_get_record(): res_nsend() failed in ....

This gets all records except DNS_PTR:
<?php
$dnsr = dns_get_record('php.net', DNS_ALL - DNS_PTR);
print_r($dnsr);
?>

down

PHP Joe ¶

11 years ago


Although this works very well for general DNS queries if you want to do a direct DNS query to a specified DNS server (rather than using OS resolution) try PHPDNS: http://www.purplepixie.org/phpdns/

You can do direct (TCP or UDP) low-level queries to a nameserver and recurse at will. Very useful for testing specific servers and also for walking through a recursive resolution.

down

heinjan at eendrachtstraat dot nl ¶

8 years ago


Please note that Firewalls and anti malware software detects  (and depending on company policies even blocks) DNS_ANY requests. 
In that case the usage of this function fails.
This is because DNS_ANY requests can be  exploited for creating "amplification (D)DOS attackes": You send 1 DNS_ANY request and get a huge amount of information back, thus even small requests can result into hugh network load.

I advise to use a more explicit name-request instead of using DNS_ANY.

down

ohcc at 163 dot com ¶

7 years ago


When I use DNS_ALL as the second parameter to invoke dns_get_record() on the OS of Windows, PHP emits a warning with the message "Warning: dns_get_record(): Type '251721779' not supported in blah.php on line blah", and DNS_ANY is always OKAY.

down

bohwaz ¶

2 years ago


Sadly this method does not allow for using an arbitrary nameserver.

If you need to make a request  using a specific DNS server, you'll need to use either Pear/Net_DNS2, or libdns ( https://github.com/DaveRandom/LibDNS ).

If you want something shorter and lighter, you can also use this 150 lines function: https://gist.github.com/bohwaz/ddc61c4f7e031c3221a89981e70b830c

down

-9

karl at influ dot io ¶

11 years ago


There's a comment below from 7 years ago regarding BSD and MacOSX, I'd just like to follow up incase some people see that and don't think it'll work on MacOSX.

Software:

    System Software Overview:

      System Version: OS X 10.8.3 (12D78)
      Kernel Version: Darwin 12.3.0
      Boot Volume: Macintosh HD
      Boot Mode: Normal
      Computer Name: Karl’s iMac
      User Name: Karl Kloppenborg (karl)
      Secure Virtual Memory: Enabled
      Time since boot: 10 days 20:24
--------------

# php -a
php > print_r(dns_get_record('google.com', DNS_MX));

Array
(
    [0] => Array
        (
            [host] => google.com
            [type] => MX
            [pri] => 10
            [target] => aspmx.l.google.com
            [class] => IN
            [ttl] => 749
        )

    [1] => Array
        (
            [host] => google.com
            [type] => MX
            [pri] => 30
            [target] => alt2.aspmx.l.google.com
            [class] => IN
            [ttl] => 749
        )

    [2] => Array
        (
            [host] => google.com
            [type] => MX
            [pri] => 50
            [target] => alt4.aspmx.l.google.com
            [class] => IN
            [ttl] => 749
        )

    [3] => Array
        (
            [host] => google.com
            [type] => MX
            [pri] => 40
            [target] => alt3.aspmx.l.google.com
            [class] => IN
            [ttl] => 749
        )

    [4] => Array
        (
            [host] => google.com
            [type] => MX
            [pri] => 20
            [target] => alt1.aspmx.l.google.com
            [class] => IN
            [ttl] => 749
        )

)

down

-17

Emil ¶

6 years ago


Hi,
If I added domain to directadmin where is script with dns_get_record it gives me local values even if that domain is not really delegated yet to this server.. why?

add a note