php-projecthoneypot

, _(*1)

PHP Wrapper for Project Honey Pot. Compatible with PHP 5.3+ and HHVM., _(*2)

Installation

The preferred installation method is via composer. From the root of your project simply run:, _(*3)

composer require "joshtronic/php-projecthoneypot:dev-master"

Usage

Getting Started

$php = new joshtronic\ProjectHoneyPot('_YOUR_API_KEY_');

Performing a Lookup

$results = $php->query('1.2.3.4');
print_r($results);

Results

Queries will return an array of information about the IP address. The array will contain last_activity, threat_score and an array of categories., _(*4)

Simulating Results

The folks at Project Honey Pot were kind enough to include a way to simulate results from their http:BL API. You can do so by performing queries against the following IP addresses., _(*5)

Visitor Types

127.1.1.0 - Search Engine
127.1.1.1 - Suspicious
127.1.1.2 - Harvester
127.1.1.3 - Suspicious & Harvester
127.1.1.4 - Comment Spammer
127.1.1.5 - Suspicious & Comment Spammer
127.1.1.6 - Harvester & Comment Spammer
127.1.1.7 - Suspicious & Harvester & Comment Spammer

Threat Levels

127.1.10.1 - Threat level 10
127.1.20.1 - Threat level 20
127.1.40.1 - Threat level 40
127.1.80.1 - Threat level 80

Number of Days

127.10.1.1 - 10 days since last seen
127.20.1.1 - 20 days since last seen
127.40.1.1 - 40 days since last seen
127.80.1.1 - 80 days since last seen

Contributing

Suggestions and bug reports are always welcome, but karma points are earned for pull requests., _(*6)

Unit tests are required for all contributions. You can run the test suite from the tests directory simply by running phpunit ., _(*7)

I also urge you to install a honey pot and donate some MX records to Project Honey Pot. They are doing great work, they provide http:BL as a free service and your donations help make their service ever better!, _(*8)

If you’re not already a member, please sign up today with [my referral code][referral]., _(*9)