PHP Classes

File: vendor/frdl/oid-connect-rdap/README.md

Recommend this page to a friend!
  Classes of Till Wehowski   PHP RDAP Server   vendor/frdl/oid-connect-rdap/README.md   Download  
File: vendor/frdl/oid-connect-rdap/README.md
Role: Documentation
Content type: text/markdown
Description: Documentation
Class: PHP RDAP Server
Process RDAP queries about an IP address or domain
Author: By
Last change:
Date: 12 days ago
Size: 5,543 bytes
 

Contents

Class file image Download

OID-Connect RDAP

RDAP look ups extended by OID-Connect protocols.

OID-Connect RDAP Client (Whois via RDAP)

Forked from ArrayAccess/RDAPClient

RDAP CLIENT

RDAP Client For PHP (Formerly Whois via http protocol)

Requirements

  • php `8.1` or later
  • `ext-json`
  • `ext-intl`

IETF RDAP Reference

  • Registration Data Access Protocol (RDAP) Object Tagging #RFC8521
  • Security Services for the Registration Data Access Protocol (RDAP) #RFC7481
  • Registration Data Access Protocol (RDAP) Query Format #RFC9082
  • JSON Responses for the Registration Data Access Protocol (RDAP) #RFC9083
  • Finding the Authoritative Registration Data (RDAP) Service #RFC9224

Schema Inventory & Analysis of WHOIS object

  • Inventory and Analysis of WHOIS Registration Objects #RFC7485

IANA RDAP Data

Iana provide data about rdap

For list of predefined recovered IPv4 addresses: RecoveredIPv4.php

Example Usage

See Client.php for more methods

use ArrayAccess\RdapClient\Client;
use ArrayAccess\RdapClient\Interfaces\RdapRequestInterface;
use ArrayAccess\RdapClient\Protocols\AsnProtocol;
use ArrayAccess\RdapClient\Protocols\DomainProtocol;
use ArrayAccess\RdapClient\Protocols\IPv4Protocol;
use ArrayAccess\RdapClient\Protocols\IPv6Protocol;
use ArrayAccess\RdapClient\Protocols\NsProtocol;

$client = new Client();
/
 * @var RdapRequestInterface<string, DomainProtocol> $request
 */
$domainName = 'example.com';
$request = $client->request($domainName);

/
 * @var RdapRequestInterface<string, IPv4Protocol> $request
 */
$ipv4 = '192.0.47.59'; // iana.org ipv4
$request = $client->request($ipv4);

/
 * @var RdapRequestInterface<string, IPv6Protocol> $request
 */
$ipv6 = '2404:6800:4003:c01::66'; // google.com
$request = $client->request($ipv6);

/
 * @var RdapRequestInterface<string, NsProtocol> $request
 Name server guessing by prefix (ns[0-9]).domain-name.ext or [^\.]+.(ns[0-9]*.[^\.]+\.)(?:.+).domain-name.ext
 */
$nameserver = 'ns1.google.com'; // google name server
$request = $client->request($nameserver);

/
 * @var RdapRequestInterface<string, AsnProtocol> $request
 * Autonomous System Number parsed by "^(?ASN?)?(?<as_number>[0-9]+)$"
 */
$asNumber = 'AS15169'; // Google LLC ASN
// or just put the numeric string / integer
$request = $client->request($asNumber);

// getting object response
$response = $request->getResponse();
// getting json data
$jsonResponse = $response->getResponseJson();
// getting definition object
$definition = $response->getDefinition();
// if domain > getting related / another whois server request if possible
$alternateRequest = $definition->getRelatedRequest();
// json serialize
$fallbackToJson = json_encode($definition, JSON_PRETTY_PRINT|JSON_UNESCAPED_SLASHES);

// direct call with custom request target
// makes sure the type of RDAP uri target is equal '/domain/GOOGLE.com' as domain-protocol
$newRequest = $request->withRdapSearchURL('https://rdap.markmonitor.com/rdap/domain/GOOGLE.COM');
$response = $newRequest->getResponse();

See Response/Definitions for more details about code

Note

The code of data definition contains strict types. Some of the invalid data will throw an error.

WHOIS Data Collection

Refer to: _(gist)_ WHOIS List to get the list of whois servers / ip range / sTLD etc.

Caution! the gist contains huge data.

LICENSE

GPL-3.0-or-later