README

RDAP is a protocol to query domain registration data. It is seen as the successor to WHOIS. The main advantage over WHOIS is that the returned data is standardized and structured as JSON. A downside of RDAP is that, at the moment of writing, not all TLDs are supported.

This package contains a few classes to query basic data from RDAP. It also provides caching of the responses out of the box.

Support us

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.

Installation

You can install the package via composer:

composer require spatie/laravel-rdap

You can publish the config file with:

php artisan vendor:publish --tag="rdap-config"

All options are documented in the config file.

Usage

Perform a domain query

To get information about a domain, call domain().

use Spatie\Rdap\Facades\Rdap;

$domain = Rdap::domain('google.com'); // returns an instance of `Spatie\Rdap\Responses\DomainResponse`

If you pass a non-existing domain, then the domain() function will return null.

Retrying requests

RDAP seem to be a bit unreliable when responding to domain requests. We solve this by attempting a request to RDAP a couple of times until we get a response. In the rdap config file, you can set the defaults for the retry mechanism.

You can override those defaults, by passing extra parameters to domain.

$domain = Rdap::domain(
   'google.com'
   timeoutInSecons: 10,
   retryTimes: 4,
   sleepInMillisecondsBetweenRetries: 2000,       
);

Using custom RDAP servers

You can specify a custom RDAP server instead of the default one by passing the dnsServer parameter. This is useful if you want to query a specific registry’s RDAP endpoint or test against a private server.

$domain = Rdap::domain(
   'google.com'
   dnsServer: 'https://rdap.verisign.com/com/v1/',     
);

Supporting TLDs that are missing from IANA's list

The package finds the RDAP server for a TLD in IANA's bootstrap file. Some registries run an RDAP server but are not listed in that file, for example the ones for .io, .co, .me, .us and .ch. The additional_tld_servers key in the rdap config file maps those TLDs to their server, and the package ships with the ones we could verify.

You can add a TLD, or override a server that IANA lists, by adding an entry. An entry takes precedence over IANA's list and can be used even when IANA is unreachable. Use Punycode for internationalized TLDs.

// config/rdap.php

'additional_tld_servers' => [
    'io' => 'https://rdap.identitydigital.services/rdap/',
    // ...
],

These servers are not listed by IANA, so a registry can move or remove them without notice. Set the key to an empty array to only use IANA's list. If your published config does not contain this key, the package supplies its defaults. If you define it, your array replaces the default list rather than merging individual TLDs.

Get various dates

On an instance of DomainResponse you can call various methods to fetch various dates. All of these methods return an instance of Carbon\Carbon.

$domain->registrationDate();
$domain->expirationDate();
$domain->lastChangedDate();
$domain->lastUpdateOfRdapDb();

Getting all domain properties

You can get all properties of a DomainResponse using all().

$properties = $domain->all(); // returns an array

To know which properties get returned, take a look at this json containing the response for google.com.

Getting a specific domain property

Use get() to get a specific domain property.

$domain->get('objectClassName'); // returns 'domain'

You can use dot notation to reach deeper in the properties.

$domain->get('links.0.value'); // returns 'https://rdap.verisign.com/com/v1/domain/GOOGLE.COM'

Check if a domain as a specific status

You can check if a domain has a specific status, such as "client transfer prohibited", using the hasStatus method.

use Spatie\Rdap\Enums\DomainStatus;

$domain->hasStatus(DomainStatus::ClientTransferProhibited); // returns a boolean

Check if domain is supported by Rdap

You can check if Rdap has info about your domain using domainIsSupported

use Spatie\Rdap\Facades\Rdap;

Rdap::domainIsSupported('freek.dev'); // returns true;
Rdap::domainIsSupported('spatie.be'); // returns false because 'be' isn't currently a supported tld;

use Spatie\Rdap\Facades\Rdap;

$domain = Rdap::domain('google.com'); // returns an instance of `Spatie\Rdap\Responses\DomainResponse`

If you pass a non-existing domain, then the domain() function will return null.

Handling errors

Sometimes RDAP is slow in responding. If a response isn't returned in a timely manner, a Spatie\Rdap\Exceptions\RdapRequestTimedOut exception will be thrown.

Sometimes RDAP servers return with an invalid response. If that happens, a Spatie\Rdap\Exceptions\InvalidRdapResponse exception will be thrown.

Both exceptions implement Spatie\Rdap\Exceptions\RdapException. You can catch that exception to handle both cases.

Perform an IP query

To get information about an IP, call ip().

use Spatie\Rdap\Facades\Rdap;
$ip = Rdap::ip("127.0.0.1"); // returns an instance of `Spatie\Rdap\Responses\IpResponse

Get various dates from the IpRespones

On an instance of IpResponse you can call various methods to fetch various dates. All of these methods return an instance of Carbon\Carbon.

$ip->registrationDate();
$ip->expirationDate();
$ip->lastChangedDate();
$ip->lastUpdateOfRdapDb();

Getting a specific IP property

Similar to domain, you may call ->get() to get a specific property.

$ip->get("objectClassName"); // returns ip network

Working with RDAP DNS

For each TLD a specific server is used to respond to domain queries. Such a server is called a "DNS server". The official list of all RDAP DNS server is available as JSON here.

The Spatie\Rdap\RdapDns class can fetch information from that JSON file. Because all above domain methods need to search the approriate DNS server, we cache the list with available DNS servers. By default, the response will be cached for a week. You can configure this caching period in the rdap config file.

You can get info on Rdap DNS via this dns function.

$rdapDns = Spatie\Rdap\Facades\Rdap::dns();

Get the DNS server URL

To get the DNS server URL for a specific domain call getServerForDomain:

$rdapDns->getServerForDomain('google.com'); // returns "https://rdap.verisign.com/com/v1/"

Alternatively, you can use getServerForTld and pass a TLD.

$rdapDns->getServerForTld('com'); // returns "https://rdap.verisign.com/com/v1/"

If you pass a domain or tld that is not supported, the above methods will return null.

Get all supported TLDs

To get a list of all supported TLDs, call supportedTlds.

$rdapDns->supportedTlds(); // returns an array with all supported TLDs

Working with IPv4/IPv6 registries

Similar to RdapDns you may call getAllIPServers() to see all registries.

use Spatie\Rdap\RdapIpV4;
$ipv4 = new RdapIpV4();
$ipv4->getAllIpServers(); // returns array<int, array<int, string>>

To find the server for an IP you may call getServerForIP().

use Spatie\Rdap\RdapIpV4;
$ipv4 = new RdapIpV4();
$ipv4->getServerForIp("216.58.207.206"); // returns "https://rdap.arin.net/registry/"

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.

spatie / laravel-rdap

Package info

Security

Statistics