Go to file
2023-08-20 19:38:08 +02:00
.github/workflows Update CI 2022-12-10 17:58:39 +01:00
docs Follow naming convention 2023-01-12 15:57:52 +01:00
examples Follow naming convention 2023-01-12 15:57:52 +01:00
lib Psalm fixes 2023-08-20 19:38:08 +02:00
test Psalm fixes 2023-08-20 19:38:08 +02:00
.gitattributes First commit 2019-06-10 19:32:28 +02:00
.gitignore Update 2022-10-29 20:45:00 +02:00
.gitmodules First commit 2019-06-10 19:32:28 +02:00
.php-cs-fixer.dist.php Cleanup 2022-10-29 20:44:35 +02:00
composer.json Fix for latest http-client 2023-02-15 18:28:06 +01:00
CONTRIBUTING.md First commit 2019-06-10 19:32:28 +02:00
LICENSE First commit 2019-06-10 19:32:28 +02:00
Makefile First commit 2019-06-10 19:32:28 +02:00
phpunit.xml.dist Cleanup 2022-10-29 20:44:35 +02:00
psalm.xml Adapt for new amphp/dns 2023-01-12 15:49:35 +01:00
README.md Follow naming convention 2023-01-12 15:57:52 +01:00

dns

License

danog/dns-over-https provides asynchronous and secure DNS-over-HTTPS name resolution for Amp.
Supports RFC 8484 POST and GET syntaxes as well as Google's proprietary JSON DNS format.
Supports passing custom headers for domain fronting with google DNS.

Installation

composer require danog/dns-over-https

Example

<?php

require __DIR__ . '/examples/_bootstrap.php';

use Amp\DoH;
use Amp\Dns;
use Amp\Dns\DnsRecord;

use function Amp\Future\awaitFirst;

// Set default resolver to DNS-over-HTTPS resolver
$DohConfig = new DoH\DoHConfig([new DoH\DoHNameserver('https://mozilla.cloudflare-dns.com/dns-query')]); // Defaults to DoH\DoHNameserverType::RFC8484_POST
Dns\dnsResolver(new DoH\Rfc8484StubDoHResolver($DohConfig));

$githubIpv4 = Dns\resolve("github.com", DnsRecord::A);
pretty_print_records("github.com", $githubIpv4);

$googleIpv4 = \Amp\async(fn () => Amp\Dns\resolve("google.com", DnsRecord::A));
$googleIpv6 = \Amp\async(fn () => Amp\Dns\resolve("google.com", DnsRecord::AAAA));

$firstGoogleResult = awaitFirst([$googleIpv4, $googleIpv6]);
pretty_print_records("google.com", $firstGoogleResult);

$combinedGoogleResult = Amp\Dns\resolve("google.com");
pretty_print_records("google.com", $combinedGoogleResult);

$googleMx = Amp\Dns\query("google.com", DnsRecord::MX);
pretty_print_records("google.com", $googleMx);
$firstGoogleResult = awaitFirst([$googleIpv4, $googleIpv6]);
pretty_print_records("google.com", $firstGoogleResult);

$combinedGoogleResult = Amp\Dns\resolve("google.com");
pretty_print_records("google.com", $combinedGoogleResult);

$googleMx = Amp\Dns\query("google.com", DnsRecord::MX);
pretty_print_records("google.com", $googleMx);