This package enables you to query multi.surbl.org with a URL and determine if the domain is listed., (*1)
Installation
Composer, (*2)
$ composer require ampersa/surbl
Usage
Basic usage, (*3)
use Ampersa\SURBL\SURBL;
...
$surbl = new SURBL;
$result = $surbl->listed('http://ampersa.co.uk');
// Returns: (bool) false
$result = $surbl->listed('http://surbl-org-permanent-test-point.com/');
// Returns: (bool) true
Specify lists to query
By default, all lists (phishing (PH), malware (MW), AbuseButler (ABUSE) and cracked (CR)) are queried., (*4)
To specify lists to use, pass a bitmask of options to the constructor, (*5)
$surbl = new SURBL(SURBL::LIST_PH | SURBL::LIST_MW);
$result = $surbl->listed('http://surbl-org-permanent-test-point.com/');
// Returns: (bool) false
Call statically
A static accessor has been included to provide shorthand access to the listed() function. The second argument may be used to pass the bitmask of options., (*6)
$result = SURBL::isListed('http://surbl-org-permanent-test-point.com/');
// Returns: (bool) true
$result = SURBL::isListed('http://surbl-org-permanent-test-point.com/', SURBL::LIST_PH | SURBL::LIST_MW);
// Returns: (bool) false
Contributing
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request