Installation

composer require cboxdk/dns

Extensions

• ext-sockets is required and enforced by Composer — it is the transport for the raw resolver.
• ext-openssl and ext-sodium are needed only for DNSSEC signature verification. Both ship with a stock PHP build. Confirm them with:

php -m | grep -E 'sockets|openssl|sodium'

See Requirements for the full matrix.

First call

use Cbox\Dns\Dns;
use Cbox\Dns\Enums\RecordType;

$dns = new Dns;

$response = $dns->lookup('example.com', RecordType::A);

var_dump($response->values());

new Dns with no arguments uses SocketResolver, which queries 1.1.1.1 by default over UDP (retrying over TCP if the answer is truncated). To point it elsewhere, construct the resolver yourself and inject it:

use Cbox\Dns\Resolvers\SocketResolver;

$dns = new Dns(new SocketResolver(defaultNameserver: '8.8.8.8', timeout: 2.0));

Or resolve over DNS-over-HTTPS instead — see Resolvers.

Next

• Testing — drive everything offline.
• Quickstart — every capability in one read.