PHPackages                             thasmo/honeypot-blacklist - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. thasmo/honeypot-blacklist

AbandonedArchivedLibrary[HTTP & Networking](/categories/http)

thasmo/honeypot-blacklist
=========================

A simple PHP library for querying the Project Honeypot Http:BL API.

v0.1.2(10y ago)112101[1 issues](https://github.com/thasmo/php.honeypot-blacklist/issues)MITPHPPHP >=5.5.0

Since Jun 25Pushed 10y agoCompare

[ Source](https://github.com/thasmo/php.honeypot-blacklist)[ Packagist](https://packagist.org/packages/thasmo/honeypot-blacklist)[ RSS](/packages/thasmo-honeypot-blacklist/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (3)Dependencies (2)Versions (5)Used By (0)

Project Honeypot Http:BL Library
================================

[](#project-honeypot-httpbl-library)

A simple PHP library for querying the [Project Honeypot Http:BL API](http://www.projecthoneypot.org/httpbl_api.php).

[![Build Status](https://camo.githubusercontent.com/eb5aca9bea1aec75f5e7343e8e4eaee1944c16cf777dc1b9cae5f49371e8e3d2/68747470733a2f2f7472617669732d63692e6f72672f746861736d6f2f7068702e686f6e6579706f742d626c61636b6c6973742e7376673f6272616e63683d646576656c6f70)](https://travis-ci.org/thasmo/php.honeypot-blacklist)[![Coverage Status](https://camo.githubusercontent.com/f91364c6aa54f8036e86bdccf96224ef747e242e20456eff215fd012e64d47f3/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f746861736d6f2f7068702e686f6e6579706f742d626c61636b6c6973742f62616467652e7376673f6272616e63683d646576656c6f70)](https://coveralls.io/r/thasmo/php.honeypot-blacklist?branch=develop)[![Latest Stable Version](https://camo.githubusercontent.com/fcca2df9323dfe6b889bdff149b35119b9e4ef1188795bec41dd9a8deebdb6c0/68747470733a2f2f706f7365722e707567782e6f72672f746861736d6f2f686f6e6579706f742d626c61636b6c6973742f762f737461626c65)](https://packagist.org/packages/thasmo/honeypot-blacklist)

Usage
-----

[](#usage)

### Create a new instance

[](#create-a-new-instance)

```
use Thasmo\ProjectHoneypot\Blacklist;
$client = new Blacklist('127.0.0.1', 'api-key');
```

### Create multiple instances

[](#create-multiple-instances)

```
use Thasmo\ProjectHoneypot\Blacklist;

# Set default API key.
Blacklist::setDefaultKey('api-key');

# Use the default API key.
$clientOne = new Blacklist('127.0.0.1');

# Use a specific API key.
$clientTwo = new Blacklist('127.0.0.2', 'other-api-key');

# Use the default API key, again.
$clientThree = new Blacklist('127.0.0.3');
```

### Check for various types of clients

[](#check-for-various-types-of-clients)

```
# Client is a search engine.
$client->isSearchEngine();

# Client is suspicious.
$client->isSuspicious();

# Client is a harvester.
$client->isHarvester()

# Client is a spammer.
$client->isSpammer();

# Client is blacklisted.
# Which means it is suspicious, a harvester or a spammer but not a search engine.
$client->isListed();
```

### Get last activity

[](#get-last-activity)

```
# Get the last activity for the client in days.
$lastActivity = $client->getActivity();
```

### Get threat score

[](#get-threat-score)

```
# Get the threat score of the client.
$threatScore = $client->getThreat();
```

### Check last activity

[](#check-last-activity)

```
# Check if the client was active in the last 10 days.
$isActive = $client->isActive(10);
```

### Check threat score

[](#check-threat-score)

```
# Check if the threat score is within the limit of 100.
$isThreat = $client->isThreat(100);
```

### Get the name for a search engine

[](#get-the-name-for-a-search-engine)

```
# Get the name of the search engine.
if($client->isSearchEngine()) {
  $name = $client->getName();
}
```

### Get the API result

[](#get-the-api-result)

```
# Return an array holding the result from the API call
$result = $client->getResult();
```

### Change the address

[](#change-the-address)

```
use Thasmo\ProjectHoneypot\Blacklist;

# Create an instance
$client = new Blacklist('127.0.0.1', 'api-key');

# Get the result
$result1 = $client->getResult();

# Set a new address which resets the object
$client->setAddress('127.0.0.2');

# Get the new result
$result2 = $client->getResult();
```

### Query the API

[](#query-the-api)

```
use Thasmo\ProjectHoneypot\Blacklist;

# Create an instance
$client = new Blacklist('127.0.0.1', 'api-key');

# Query the API immediately
$client->query();

# Use other methods
if($client->isSearchEngine()) {
  $name = $client->getName();
}
```

Implementation Details
----------------------

[](#implementation-details)

- Requests to the API are delayed until you first call a method like `isSearchEngine` etc. or `query` explicitly.
- API responses for the same IP address on the same instance will be cached, the API will be queried only once.
- When changing the IP address via `setAddress` the cache is cleared and the API will be queried again.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~135 days

Total

3

Last Release

3710d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/38b23f01c936315db03de52b789382c879f7471302f2692f5cfd55454147e553?d=identicon)[thasmo](/maintainers/thasmo)

---

Tags

apihoneypot-httpphp-libraryspamthreat-scorehttpapispamHoneypotblacklist

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/thasmo-honeypot-blacklist/health.svg)

```
[![Health](https://phpackages.com/badges/thasmo-honeypot-blacklist/health.svg)](https://phpackages.com/packages/thasmo-honeypot-blacklist)
```

###  Alternatives

[nategood/httpful

A Readable, Chainable, REST friendly, PHP HTTP Client

1.8k17.2M267](/packages/nategood-httpful)[bigcommerce/api

Enables PHP applications to communicate with the Bigcommerce API.

1501.1M8](/packages/bigcommerce-api)[quickbooks/payments-sdk

The Official PHP SDK for QuickBooks Online Payments API

2758.2k2](/packages/quickbooks-payments-sdk)[jsor/hal-client

A lightweight client for consuming and manipulating Hypertext Application Language (HAL) resources.

2425.9k1](/packages/jsor-hal-client)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)