README

A Laravel-friendly DNS lookup wrapper built on NetDNS2 v2 for custom resolvers, system fallback, typed exceptions, caching, and Laravel integration.

Quick Start

composer require alyakin/dns-checker

Laravel

php artisan vendor:publish --tag=dns-checker-config

use Alyakin\DnsChecker\Facades\DnsChecker;

$records = DnsChecker::getRecords('example.com', 'A');

Plain PHP

use Alyakin\DnsChecker\DnsLookupService;

$dns = new DnsLookupService([
    'servers' => ['8.8.8.8', '1.1.1.1'],
    'timeout' => 2,
    'fallback_to_system' => true,
]);

$records = $dns->getRecords('example.com', 'MX');

Compatibility

Features

• custom DNS servers with optional fallback to the system resolver
• optional typed exceptions for DNS failures
• optional NXDOMAIN logging control
• optional Laravel Cache-backed caching
• facade, fluent API, DI contract and artisan command support

Documentation

• Usage
• Configuration
• Error Handling
• Caching
• Laravel Integration
• Architecture
• Development

Development

See docs/development.md.

Changelog

See CHANGELOG.md for release history and migration notes.

License

MIT