cocur/domain

Check domain name availability and WHOIS

v0.2 2016-06-15 12:58 UTC

Requires

• php: >=5.5
• braincrafted/json: ~0.2

Requires (Dev)

• kherge/box: ~2.4
• mockery/mockery: ~0.9
• phpunit/phpunit: ~4.0
• sami/sami: ~3.0
• satooshi/php-coveralls: dev-master
• seld/jsonlint: ~1.1

MIT

• Florian Eckerstorfer

• domain
• whois

README

Check availability of domain names and get WHOIS information.

Features

• Check availability of domains
• Retrieve WHOIS information of domains
• Support for over 350 TLDs, including new generic TLDs like .coffee or .sexy
• Command line tool and library
• Compatible with PHP >= 5.4 and HHVM

Installation

Dependending on how you want to use Domain there exist different installation methods.

Composer

If you want to use the library as a dependency in your project you should use Composer to do so:

$ composer require cocur/domain:@dev

Currently there exists no stable release of domain.

Download PHAR

If you only want to use the command line tool to retrieve WHOIS information you can download the PHAR.

$ wget https://github.com/cocur/domain/releases/download/v0.1/whois.phar
$ chmod +x whois.phar
$ mv whois.phar /usr/local/bin/cwhois

You can now retrieve WHOIS information using Cocur Domain by executing

$ cwhois

Usage

Command line WHOIS

You can use the included command line tool to retrieve WHOIS information about a domain:

$ php whois.phar cocur.co

Library

The library contains two main classes: Whois\Client and Availability\Client They require information about WHOIS servers and patterns to match available domains stored in data/tld.json.

Whois

use Cocur\Domain\Connection\ConnectionFactory;
use Cocur\Domain\Data\DataLoader;
use Cocur\Domain\Whois\Client;

$factory = new ConnectionFactory();
$dataLoader = new DataLoader();
$data = $dataLoader->load(__DIR__.'/data/tld.json');

$client = new Client($factory, $data);

echo $client->query($domainName);

Availability

To check the availability of a domain name the Availability\Client requires an instance of Whois\Client.

use Cocur\Domain\Connection\ConnectionFactory;
use Cocur\Domain\Data\DataLoader;
use Cocur\Domain\Whois\Client as WhoisClient;
use Cocur\Domain\Availability\Client as AvailabilityClient;

$factory = new ConnectionFactory();
$dataLoader = new DataLoader();
$data = $dataLoader->load(__DIR__.'/data/tld.json');

$whoisClient = new WhoisClient($factory, $data);
$client = new AvailabilityClient($whoisClient, $data);

echo $client->isAvailable($domainName);

Changelog

Verison 0.2 (15 June 2016)

• #1 Add .frl TLD (by rskuipers)
• #3 Add .amsterdam TLD (by rskuipers)
• #4 Fix pattern for .ee (by huglester)

Version 0.1 (19 May 2014)

• Initial release

Author

Florian Eckerstorfer

• Twitter
• App.net

License

The MIT license applies to cocur/domain. For the full copyright and license information, please view the LICENSE file distributed with this source code.