PHPackages                             qxd/abuseipdb-php - 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. [Utility & Helpers](/categories/utility)
4. /
5. qxd/abuseipdb-php

ActiveLibrary[Utility & Helpers](/categories/utility)

qxd/abuseipdb-php
=================

A wrapper service around the popular AbuseIPDb service.

00

Since May 17Pushed 1y ago1 watchersCompare

[ Source](https://github.com/vsecades/AbuseIpDb-php)[ Packagist](https://packagist.org/packages/qxd/abuseipdb-php)[ RSS](/packages/qxd-abuseipdb-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

AbuseIpDb - Wrapper around the Abuse IP DB service API
======================================================

[](#abuseipdb---wrapper-around-the-abuse-ip-db-service-api)

The package supports APIv2. No other API is currently available. Uploading a CSV report of abusive IP addresses is not yet implemented, but is in the plans to do so.

Installing
----------

[](#installing)

Installation is planned to be done around Composer. Please be sure to NOT try to clone this repository and try your luck with getting it working.

```
composer install AbuseIpDb
```

Usage as a Composer package
---------------------------

[](#usage-as-a-composer-package)

We only support APIv2 to select the API version (this can be passed in as a parameter or is used as the default). Newer values will be provided when the API is updated and our group has time to implement. This is currently the only API supported by AbuseIPDB.

```
TBD, still in implementation phase
```

If you have a subscription plan with Abuse IP DB, you can indicate this with an additional parameter.

```
TBD, still in implementation phase
```

### Checking a single IP address

[](#checking-a-single-ip-address)

```
TBD, still in implementation phase
```

### Checking for a CIDR network block

[](#checking-for-a-cidr-network-block)

```
TBD, still in implementation phase
```

### Report an abusive IP address

[](#report-an-abusive-ip-address)

All the following calls result in the same call to AbuseIpDb. If you pass in an unkonwn category, it will raise a `ValueError`.

```
TBD, still in implementation phase
```

This adds a comment to the report.

```
TBD, still in implementation phase
```

### Report a list of abusive IP addresses

[](#report-a-list-of-abusive-ip-addresses)

Please refer to [IP Bulk Reporter](https://www.abuseipdb.com/bulk-report)for the exact specification of the CSV file.

```
TBD, still in implementation phase
```

**NOTE:** This is currently not implemented.

### Retrieve a list of abusive IP addresses

[](#retrieve-a-list-of-abusive-ip-addresses)

```
TBD, still in implementation phase
```

Usage on the command line
-------------------------

[](#usage-on-the-command-line)

You can invoke the module on the command line. It supports all the commands listed above. For the explicit syntax and the required configuration call it with the `--help` parameter.

```
abuseipdb --help
```

### fail2ban

[](#fail2ban)

The CLI was developed for usage with *fail2ban*. Use the following action instead of *wget* or *curl*:

```
TBD, still in implementation phase

```

The lines do the same. Of course you can leave out the masking of sensitive data, but it is a bad idea. It will replace your own hostname with `*host*`, any existing user with `*user*` and any email address with `*email*`. This will prevent any information leakage about your system and reduce the attack surface a little bit.

Project links
-------------

[](#project-links)

- [AbuseIpDB Repository](https://github.com/vsecades/AbuseIpDb "AbuseIpDB Repository")
- [Abuse IP DB APIv2 Documentation](https://docs.abuseipdb.com/)
- [IPv4 Address Blocks Reserved for Documentation](https://tools.ietf.org/html/rfc5737)

---

###  Health Score

14

—

LowBetter than 2% of packages

Maintenance26

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity20

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/f5f19746abef58017c057feecf58086e9a9f6cc218faeeffebf58491ca419c14?d=identicon)[vsecades](/maintainers/vsecades)

---

Top Contributors

[![vsecades](https://avatars.githubusercontent.com/u/864648?v=4)](https://github.com/vsecades "vsecades (4 commits)")

### Embed Badge

![Health badge](/badges/qxd-abuseipdb-php/health.svg)

```
[![Health](https://phpackages.com/badges/qxd-abuseipdb-php/health.svg)](https://phpackages.com/packages/qxd-abuseipdb-php)
```

###  Alternatives

[link1st/laravel-easemob

环信即时通讯laravel包开发，用于环信用户、群、聊天室等功能

456.6k](/packages/link1st-laravel-easemob)

PHPackages © 2026

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