cocur / domain
Check domain name availability and WHOIS
Installs: 1 304
Dependents: 0
Suggesters: 0
Security: 0
Stars: 68
Watchers: 6
Forks: 20
Open Issues: 0
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
This package is auto-updated.
Last update: 2024-10-20 09:42:21 UTC
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
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.