dns_get_record - PHP code example

PHP Function DNS_Get_Record

php function dns_get_record is a useful tool for obtaining various types of DNS record information. It allows you to fetch information about DNS Resource Records associated with a hostname and it can be used in place of the popular dig command.

The dns_get_record() function returns an array of records matching the requested type of query. This array can contain several different key-value pairs that will vary depending on the record type specified. For example, if the record type is DNS_A, the keys will include a string of the hostname, the name server where the domain was found and the IP address. Similarly, if the record is DNS_CNAME, the keys will include the target of the aliased domain.

Other record keys that can be returned by this function are ttl – time to live remaining for the record, pri – priority of mail exchanger (lower numbers indicate greater priority), and an array of Authority Name Servers. The list of authority name servers will be sorted according to their weighted IP addresses. The array of records can also return other data such as ipv6 addresses, cpu and os data.

dns_get_record() is an inbuilt function in PHP which retrieves various types of DNS record for a hostname. It accepts a hostname and a type of record to search for, with the default being DNS_ANY. It also accepts a raw parameter that when set to true, instead of looping type-by-type it queries only the requested record before returning the info stuff.

dns_get_record example

return $resource;
            }
        );
    }

    private function resolveHost(RequestInterface $request, array $options): UriInterface
    {
        $uri = $request->getUri();

        if (isset($options['force_ip_resolve']) && !\filter_var($uri->getHost(), \FILTER_VALIDATE_IP)) {
            if ('v4' === $options['force_ip_resolve']) {
                $records = \dns_get_record($uri->getHost(), \DNS_A);
                if (false === $records || !isset($records[0]['ip'])) {
                    throw new ConnectException(\sprintf("Could not resolve IPv4 address for host '%s'", $uri->getHost()), $request);
                }

                return $uri->withHost($records[0]['ip']);
            }
            if ('v6' === $options['force_ip_resolve']) {
                $records = \dns_get_record($uri->getHost(), \DNS_AAAA);
                if (false === $records || !isset($records[0]['ipv6'])) {
                    throw new ConnectException(\sprintf("Could not resolve IPv6 address for host '%s'", $uri->getHost()), $request);
                }

'ip' => '1.2.3.4',
            ],
            $ptr = [
                'host' => 'example.com',
                'class' => 'IN',
                'ttl' => 1,
                'type' => 'PTR',
                'ip' => '2.3.4.5',
            ],
        ];

        $this->assertFalse(DnsMock::dns_get_record('foobar.com'));
        $this->assertSame($records, DnsMock::dns_get_record('example.com'));
        $this->assertSame($records, DnsMock::dns_get_record('example.com', \DNS_ALL));
        $this->assertSame($records, DnsMock::dns_get_record('example.com', \DNS_A | \DNS_PTR));
        $this->assertSame([$ptr], DnsMock::dns_get_record('example.com', \DNS_PTR));
    }
}

$ips[] = $record['ip'];
                }
            }
        }

        return $ips;
    }

    public static function dns_get_record($hostname, $type = \DNS_ANY, &$authns = null, &$addtl = null, $raw = false)
    {
        if (!self::$hosts) {
            return \dns_get_record($hostname, $type, $authns, $addtl, $raw);
        }

        $records = false;

        if (isset(self::$hosts[$hostname])) {
            if (\DNS_ANY === $type) {
                $type = \DNS_ALL;
            }
            $records = [];

            foreach (self::$hosts[$hostname] as $record) {

public function getRecords(string $host, int $type): DNSRecords
    {
        // A workaround to fix https://bugs.php.net/bug.php?id=73149         /** @psalm-suppress InvalidArgument */
        set_error_handler(
            static function Dint $errorLevel, string $errorMessage): never {
                throw new \RuntimeException("Unable to get DNS record for the host: $errorMessage");
            }
        );
        try {
            // Get all MX, A and AAAA DNS records for host             return new DNSRecords(dns_get_record($host, $type));
        } catch (\RuntimeException $exception) {
            return new DNSRecords([], true);
        } finally {
            restore_error_handler();
        }
    }
}