PHPackages                             crowdsec/standalone-bouncer - 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. crowdsec/standalone-bouncer

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

crowdsec/standalone-bouncer
===========================

The official CrowdSec standalone bouncer for PHP websites

v1.6.0(2mo ago)16669↓33.3%2[1 issues](https://github.com/crowdsecurity/cs-standalone-php-bouncer/issues)MITPHPPHP >=7.2.5CI passing

Since Apr 27Pushed 2mo ago10 watchersCompare

[ Source](https://github.com/crowdsecurity/cs-standalone-php-bouncer)[ Packagist](https://packagist.org/packages/crowdsec/standalone-bouncer)[ Docs](https://github.com/crowdsecurity/cs-standalone-php-bouncer)[ RSS](/packages/crowdsec-standalone-bouncer/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (9)Dependencies (7)Versions (12)Used By (0)

[![CrowdSec Logo](https://raw.githubusercontent.com/crowdsecurity/cs-standalone-php-bouncer/main/docs/images/logo_crowdsec.png)](https://raw.githubusercontent.com/crowdsecurity/cs-standalone-php-bouncer/main/docs/images/logo_crowdsec.png)

CrowdSec standalone PHP bouncer
===============================

[](#crowdsec-standalone-php-bouncer)

> The official standalone PHP bouncer for the CrowdSec LAPI

[![Version](https://camo.githubusercontent.com/666df0f2349be08d520fcc13a9c240a27b3a97129534632db5f0e162a3fed71f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f63726f776473656375726974792f63732d7374616e64616c6f6e652d7068702d626f756e6365723f696e636c7564655f70726572656c6561736573)](https://camo.githubusercontent.com/666df0f2349be08d520fcc13a9c240a27b3a97129534632db5f0e162a3fed71f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f63726f776473656375726974792f63732d7374616e64616c6f6e652d7068702d626f756e6365723f696e636c7564655f70726572656c6561736573)[![Test suite](https://github.com/crowdsecurity/cs-standalone-php-bouncer/actions/workflows/test-suite.yml/badge.svg)](https://github.com/crowdsecurity/cs-standalone-php-bouncer/actions/workflows/test-suite.yml)[![Coding standards](https://github.com/crowdsecurity/cs-standalone-php-bouncer/actions/workflows/coding-standards.yml/badge.svg)](https://github.com/crowdsecurity/cs-standalone-php-bouncer/actions/workflows/coding-standards.yml)[![Licence](https://camo.githubusercontent.com/05c23b3c562e6a77529d554acb014cd44310b255f1538f0196b21a4c0e770c7e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f63726f776473656375726974792f63732d7374616e64616c6f6e652d7068702d626f756e636572)](https://camo.githubusercontent.com/05c23b3c562e6a77529d554acb014cd44310b255f1538f0196b21a4c0e770c7e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f63726f776473656375726974792f63732d7374616e64616c6f6e652d7068702d626f756e636572)

📚 [Documentation](https://doc.crowdsec.net)💠 [Hub](https://app.crowdsec.net/hub)💬 [Discourse Forum](https://discourse.crowdsec.net)

Overview
--------

[](#overview)

This bouncer allows you to protect your PHP application from IPs that have been detected by CrowdSec. Depending on the decision taken by CrowdSec, user will either get denied (403) or have to fill a captcha (401).

It uses the [PHP `auto_prepend_file` mechanism](https://www.php.net/manual/en/ini.core.php#ini.auto-prepend-file) and the [Crowdsec php bouncer library](https://github.com/crowdsecurity/php-cs-bouncer) to provide bouncer/IPS capability directly in your PHP application.

It supports "ban" and "captcha" remediations, and all decisions of type Ip, Range or Country (geolocation).

Usage
-----

[](#usage)

See [User Guide](https://github.com/crowdsecurity/cs-standalone-php-bouncer/blob/main/docs/USER_GUIDE.md)

Installation
------------

[](#installation)

See [Installation Guide](https://github.com/crowdsecurity/cs-standalone-php-bouncer/blob/main/docs/INSTALLATION_GUIDE.md)

Developer guide
---------------

[](#developer-guide)

See [Developer Guide](https://github.com/crowdsecurity/cs-standalone-php-bouncer/blob/main/docs/DEVELOPER.md)

License
-------

[](#license)

[MIT](https://github.com/crowdsecurity/cs-standalone-php-bouncer/blob/main/LICENSE)

###  Health Score

45

—

FairBetter than 92% of packages

Maintenance88

Actively maintained with recent releases

Popularity24

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 83.7% 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.

###  Release Activity

Cadence

Every ~128 days

Recently: every ~116 days

Total

9

Last Release

82d ago

Major Versions

v0.0.1 → v1.0.02023-04-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/7536d4f2bfc03e29477a22b9a4d6b551b302abecb7a25e3a068c5e67d11f29d6?d=identicon)[crowdsec](/maintainers/crowdsec)

---

Top Contributors

[![julienloizelet](https://avatars.githubusercontent.com/u/20956510?v=4)](https://github.com/julienloizelet "julienloizelet (77 commits)")[![AlteredCoder](https://avatars.githubusercontent.com/u/64792091?v=4)](https://github.com/AlteredCoder "AlteredCoder (15 commits)")

---

Tags

phphttpmiddlewaregeoipsecuritycaptchaIPwafcrowdsecbouncerblockerip range

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/crowdsec-standalone-bouncer/health.svg)

```
[![Health](https://phpackages.com/badges/crowdsec-standalone-bouncer/health.svg)](https://phpackages.com/packages/crowdsec-standalone-bouncer)
```

###  Alternatives

[crowdsec/bouncer

The official PHP bouncer library for the CrowdSec Local API

188.7k2](/packages/crowdsec-bouncer)[middlewares/firewall

Middleware to provide IP filtering

12318.3k2](/packages/middlewares-firewall)[mezzio/mezzio

PSR-15 Middleware Microframework

3883.6M97](/packages/mezzio-mezzio)[middlewares/client-ip

Middleware to detect the client ip and save it as a request attribute

16629.7k9](/packages/middlewares-client-ip)[hannesvdvreken/guzzle-debugbar

A Guzzle middleware that logs requests to debugbar's timeline

76410.4k1](/packages/hannesvdvreken-guzzle-debugbar)[mezzio/mezzio-fastroute

FastRoute integration for Mezzio

162.7M52](/packages/mezzio-mezzio-fastroute)

PHPackages © 2026

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