PHPackages                             crowdsec/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 &amp; Networking](/categories/http)
4. /
5. crowdsec/bouncer

ActiveLibrary[HTTP &amp; Networking](/categories/http)

crowdsec/bouncer
================

The official PHP bouncer library for the CrowdSec Local API

v4.3.1(3mo ago)188.7k↓50%62MITPHPPHP &gt;=7.2.5CI passing

Since Dec 3Pushed 3mo ago9 watchersCompare

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

READMEChangelog (10)Dependencies (12)Versions (74)Used By (2)

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

CrowdSec Bouncer PHP library
============================

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

> The official PHP bouncer library for the CrowdSec LAPI

[![Version](https://camo.githubusercontent.com/f10cca901a469119d7f7b95120fb176ccf2059855dbad2333e1ac9972ff94b6d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f63726f776473656375726974792f7068702d63732d626f756e6365723f696e636c7564655f70726572656c6561736573)](https://camo.githubusercontent.com/f10cca901a469119d7f7b95120fb176ccf2059855dbad2333e1ac9972ff94b6d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f63726f776473656375726974792f7068702d63732d626f756e6365723f696e636c7564655f70726572656c6561736573)[![Quality Gate Status](https://camo.githubusercontent.com/735dc05583f03f7d781f0058edb9be7896b391a1e2806fa6b5662f1de89a0aa4/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d63726f776473656375726974795f7068702d63732d626f756e636572266d65747269633d616c6572745f737461747573)](https://sonarcloud.io/dashboard?id=crowdsecurity_php-cs-bouncer)[![Test suite](https://github.com/crowdsecurity/php-cs-bouncer/actions/workflows/test-suite.yml/badge.svg)](https://github.com/crowdsecurity/php-cs-bouncer/actions/workflows/test-suite.yml)[![Coding standards](https://github.com/crowdsecurity/php-cs-bouncer/actions/workflows/coding-standards.yml/badge.svg)](https://github.com/crowdsecurity/php-cs-bouncer/actions/workflows/coding-standards.yml)[![Licence](https://camo.githubusercontent.com/2bf0a288efbec9597d7bfc7d160baabf63685fc39a7449742da13cc8ba823e80/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f63726f776473656375726974792f7068702d63732d626f756e636572)](https://camo.githubusercontent.com/2bf0a288efbec9597d7bfc7d160baabf63685fc39a7449742da13cc8ba823e80/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f63726f776473656375726974792f7068702d63732d626f756e636572)

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

Overview
--------

[](#overview)

This library allows you to create CrowdSec bouncers for PHP applications or frameworks like e-commerce, blog or other exposed applications.

Usage
-----

[](#usage)

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

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

[](#installation)

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

Technical notes
---------------

[](#technical-notes)

See [Technical notes](https://github.com/crowdsecurity/php-cs-bouncer/blob/main/docs/TECHNICAL_NOTES.md)

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

[](#developer-guide)

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

License
-------

[](#license)

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

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance82

Actively maintained with recent releases

Popularity33

Limited adoption so far

Community23

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 65.9% 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 ~26 days

Recently: every ~100 days

Total

73

Last Release

92d ago

Major Versions

v0.36.0 → v1.0.02023-02-03

v1.4.0 → v2.0.02023-04-13

v2.2.0 → v3.0.02024-10-04

v3.2.0 → v4.0.02025-01-09

PHP version history (2 changes)v0.2.0PHP ^7.2 || ^8.0

v0.31.0PHP &gt;=7.2.5

### 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 (363 commits)")[![mobula9](https://avatars.githubusercontent.com/u/577393?v=4)](https://github.com/mobula9 "mobula9 (176 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (8 commits)")[![blotus](https://avatars.githubusercontent.com/u/835060?v=4)](https://github.com/blotus "blotus (2 commits)")[![AlteredCoder](https://avatars.githubusercontent.com/u/64792091?v=4)](https://github.com/AlteredCoder "AlteredCoder (1 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (1 commits)")

---

Tags

anti-hackingban-hostsban-managementcaptchacaptcha-generationcaptcha-generatorcaptcha-imagecaptcha-servicecrowdsecfirewallhacker-protectionip-addressip-blockerip-blockingip-databaseip-range-checkphpsecurityhttpmiddlewaregeoipsecuritycaptchaIPwafcrowdsecbouncerappsecblockerip range

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[middlewares/firewall

Middleware to provide IP filtering

12318.3k2](/packages/middlewares-firewall)[rtheunissen/guzzle-log-middleware

Guzzle middleware to log requests and responses

842.3M17](/packages/rtheunissen-guzzle-log-middleware)[middlewares/client-ip

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

16629.7k9](/packages/middlewares-client-ip)[rtheunissen/guzzle-rate-limiter

Guzzle 6 middleware used to delay requests dynamically

52177.2k1](/packages/rtheunissen-guzzle-rate-limiter)[phpro/http-tools

HTTP tools for developing more consistent HTTP implementations.

28137.8k](/packages/phpro-http-tools)[middlewares/cors

Middleware to implement Cross-Origin Resource Sharing (CORS)

1372.2k3](/packages/middlewares-cors)

PHPackages © 2026

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