rbltracker/sdk

A PHP wrapper for the RBLTracker API

1.1.0 2023-08-29 21:07 UTC

Requires

• php: >=7.4.0
• ext-curl: *
• ext-json: *

MIT

• Mike Pultz

• api
• dns
• rbltracker

README

Sign up for a RBLTracker account and visit our developer site for even more details.

PHP Client Library

The official PHP binding for your RBLTracker service.

Prerequisites

Before using this library, you must have:

• A RBLTracker Account, sign up for a new account or login to RBLTracker
• a valid RBLTracker account SID and auth token, available from the RBLTracker Portal
• PHP >= 7.4
• The PHP JSON extension

Installation

composer require rbltracker/sdk

Quickstart

Get a list of hosts on your account

<?php

$client = new RBLTracker\Client('your_account_sid', 'your_auth_token');

try
{
    $hosts = $client->hosts->get([ 'page_size' => 5, 'page' => 2 ]);

    print_r($hosts);

} catch(RBLTracker\Exceptions\RBLTrackerException $e)
{
    echo $e->getMessage();
}

That will output a PHP array that looks like this:

Array
(
    [status_code] => 200
    [status_message] => Ok
    [total_hosts] => 1
    [total_listed] => 1
    [page] => 1
    [total_pages] => 1
    [page_size] => 20
    [data] => Array
        (
            [0] => Array
                (
                    [id] => HTee06c4fa7c23aa8a3a4e8d66922b0834
                    [host] => bad-url.com
                    [name] => bad-url.com
                    [type] => uribl
                    [parent] => 
                    [status] => active
                    [rbl_profile] => RP15d4e891d784977cacbfcbb00c48f133
                    [contact_group] => CGd3dca251d33135e0a518d7c49b89dc61
                    [last_checked] => 2016-11-07 21:01:33 EST
                    [first_listed] => 2016-11-06 10:14:58 EST
                    [listed_period] => 1 day 11:37:51
                    [listed] => 1
                    [listed_count] => 1
                    [listed_details] => Array
                        (
                            [0] => Array
                                (
                                    [host] => Google Safe Browsing
                                    [website] => 
                                    [details] => Malware (Virus) on Windows
                                )
                        )
                )
        )
    [version] => 3.4
)

Documentation

Full API documentation is available from the RBLTracker developer site.

Release History

v1.1.0

• updated to the use the new API endpoint URL
• added strict type requirements; bumped minimum version to PHP 7.4
• added support for Monitoring Profiles, moving away from RBL Profiles
• added support for the ACLs endpoint to pull the list of DNS servers used for checks

v1.0.3

• fixed a typo in RBLTrackerException.php where it was using short open tags.
• changed array() instances to [].
• updated classes to use the final keyword.

v1.0.2

• updated to support the RBLTracker API v3.6
• added manual RBL check support
• refactored the code layout to make it easier to override the URL for testing

v1.0.1

• updated to support the RBLTracker API v3.4

v1.0.0

• Initial release