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

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 7 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

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

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

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

＋Добавить