robowhois/robowhois

PHP SDK for RoboWhois APIs.

PHP client for RoboWhois APIs

Installation

The easiest way to install the client is to use Packagist and Composer, the brand new package manager for PHP >= 5.3., _(*1)

Clone this repository wherever you want, _(*2)

git clone git@github.com:robowhois/robowhois-php-client.git

download composer in the cloned directory, _(*3)

wget http://getcomposer.org/composer.phar

and install the needed packages, _(*4)

php composer.phar install

then you can use RoboWhois in your code: bare in mind that the autoloading follows the PSR-0 standard: there is an auto-generated autoloader that you can use:, _(*5)

require 'vendor/autoload.php';

A brief note on the docs

We try to provide an efficient way to document the features of this client, but bare in mind that, given RoboWhois API can change, this doc may be updated (last revision: 08/16/2012): we strongly recommend to take a look at the tests provided by this library as they are the simplest way to get in touch with the working code., _(*6)

Objects as array

RoboWhois objects extend the class RoboWhois\ArrayObject, used to provide a set of convenient methods for accessing data returned by the API., _(*7)

Thanks to this class you are able to access objects' properties as arrays' ones:, _(*8)

$account = $robowhois->account();

// $account is an instance of RoboWhois\Account
echo $account['credits_remaining'];

and you can also rely on magic methods to convert those indexes in getters:, _(*9)

echo $account->getCreditsRemaining();

Consuming the account API

The account API is supposed to return informations about the account which is making requests to the RoboWhois webservice:, _(*10)

``` php <?php, <sub>(*11)</sub>

use RoboWhois\RoboWhois; use RoboWhois\Exception;, <sub>(*12)</sub>

require 'vendor/autoload.php';, <sub>(*13)</sub>

$robowhois = new RoboWhois('INSERT-YOUR-API-KEY-HERE');, <sub>(*14)</sub>

try { $account = $robowhois->account();, <sub>(*15)</sub>

echo $account->getCreditsRemaining();

} catch (Exception $e) { echo "The following error occurred: " . $e->getMessage(); }, <sub>(*16)</sub>

Take a look at the `RoboWhois\Account` class to understand which attributes
are available from the API.

You can take a look at the `sample/account.php` script provided inside this
repository, or run it

    php sample/account.php

## Consuming the index API

The *index* API is supposed to return raw text/plain WHOIS records:

``` php
<?php

use RoboWhois\RoboWhois;
use RoboWhois\Exception;

require 'vendor/autoload.php';

$robowhois = new RoboWhois('INSERT-YOUR-API-KEY-HERE');

try {
    echo $robowhois->whois('robowhois.com');
} catch (Exception $e) {
    echo "The following error occurred: " . $e->getMessage();
}

You can take a look at the sample/index.php script provided inside this repository, or run it, <sub>(*17)</sub>

php sample/index.php

Consuming the record API

The record API is supposed to return a JSON representation of the index one:, <sub>(*18)</sub>

``` php <?php, <sub>(*19)</sub>

use RoboWhois\RoboWhois; use RoboWhois\Exception;, <sub>(*20)</sub>

require 'vendor/autoload.php';, <sub>(*21)</sub>

$robowhois = new RoboWhois('INSERT-YOUR-API-KEY-HERE');, <sub>(*22)</sub>

try { $whois = $robowhois->whoisRecord('robowhois.com');, <sub>(*23)</sub>

echo $whois['daystamp'] . "\n";
echo $whois->getRecord();

} catch (Exception $e) { echo "The following error occurred: " . $e->getMessage(); }, <sub>(*24)</sub>

You can take a look at the `sample/record.php` script provided inside this
repository, or run it

    php sample/record.php

## Consuming the properties API

The *properties* API is supposed to return the parsed WHOIS record for a
domain:

``` php
<?php

use RoboWhois\RoboWhois;
use RoboWhois\Exception;

require 'vendor/autoload.php';

$robowhois = new RoboWhois('INSERT-YOUR-API-KEY-HERE');

try {
    $domain = $robowhois->whoisProperties('robowhois.com');

    echo $domain['properties']['created_on'] . "\n";
} catch (Exception $e) {
    echo "The following error occurred: " . $e->getMessage();
}

You can take a look at the sample/properties.php script provided inside this repository, or run it, <sub>(*25)</sub>

php sample/properties.php

Consuming the parts API

The parts API is supposed to return the WHOIS record for a domain without merging the one or more responses returned by the contacted WHOIS server(s):, <sub>(*26)</sub>

``` php <?php, <sub>(*27)</sub>

use RoboWhois\RoboWhois; use RoboWhois\Exception;, <sub>(*28)</sub>

require 'vendor/autoload.php';, <sub>(*29)</sub>

$robowhois = new RoboWhois('INSERT-YOUR-API-KEY-HERE');, <sub>(*30)</sub>

try { $domain = $robowhois->whoisParts('robowhois.com');, <sub>(*31)</sub>

echo $domain['parts'][0]['body'] . "\n";

} catch (Exception $e) { echo "The following error occurred: " . $e->getMessage(); }, <sub>(*32)</sub>

You can take a look at the `sample/parts.php` script provided inside this
repository, or run it

    php sample/parts.php

## Consuming the availability API

The *availability* API is supposed to give a feedback about the registration of
a particular domain:

``` php
<?php

use RoboWhois\RoboWhois;
use RoboWhois\Exception;

require 'vendor/autoload.php';

$robowhois = new RoboWhois('INSERT-YOUR-API-KEY-HERE');

try {
    $domains = array(
      'google.com', 'mycustomabsurddomainnamenooneeverregistered.ch'
    );

    foreach ($domains as $domain) {
        $availability = $robowhois->whoisAvailability($domain);

        if ($availability['available']) {
            echo sprintf("%s is available!", $domain) . "\n";
        } else {
            echo sprintf("%s is registered!", $domain) . "\n";
        }
    }
} catch (Exception $e) {
    echo "The following error occurred: " . $e->getMessage();
}

There are a couple convenient methods to quickly check a domain's availability: you can use $robowhois->whoisAvailability($domain) and $robowhois->isRegistered($domain)., <sub>(*33)</sub>

You can take a look at the sample/availability.php script provided inside this repository, or run it, <sub>(*34)</sub>

php sample/availability.php

PHPDoc

You can generate PHP documentation with doxygen:, <sub>(*35)</sub>

doxygen docs/.dox

Test

The client is tested with phpunit; you can run the tests, from the repository's root, by doing:, <sub>(*36)</sub>

phpunit

Some tests require internet connection (to test against a real API response), so they are disabled by default; to run them add a .token file under the test directory containing your RoboWhois API key and run, <sub>(*37)</sub>

phpunit test/

Thanks to

• Simone Carletti
• Alessandro Nadalin
• David Funaro