rbltracker / sdk
A PHP wrapper for the RBLTracker API
Installs: 5 627
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 2
Forks: 1
Open Issues: 0
Requires
- php: >=7.4.0
- ext-curl: *
- ext-json: *
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