https://github.com/crowdsecurity/cs-standalone-php-bouncer

CrowdSec bouncer for PHP Website
https://github.com/crowdsecurity/cs-standalone-php-bouncer

php

Last synced: 4 months ago
JSON representation

CrowdSec bouncer for PHP Website

• Host: GitHub
• URL: https://github.com/crowdsecurity/cs-standalone-php-bouncer
• Owner: crowdsecurity
• License: mit
• Created: 2021-09-17T14:13:52.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2025-12-19T07:29:34.000Z (6 months ago)
• Last Synced: 2025-12-22T02:32:44.268Z (6 months ago)
• Topics: php
• Language: PHP
• Homepage:
• Size: 1.54 MB
• Stars: 16
• Watchers: 10
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-crowdsec - cs-standalone-php-bouncer - Drop-in PHP bouncer for any PHP application without framework dependencies. (Bouncers / CMS & Applications)

README

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

# CrowdSec standalone PHP bouncer

> The official standalone PHP bouncer for the CrowdSec LAPI

![Version](https://img.shields.io/github/v/release/crowdsecurity/cs-standalone-php-bouncer?include_prereleases)

[![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://img.shields.io/github/license/crowdsecurity/cs-standalone-php-bouncer)

:books: Documentation

:diamond_shape_with_a_dot_inside: Hub

:speech_balloon: Discourse Forum

## 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

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

## Installation

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

## Developer guide

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

## License

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