ariarijp/cassowary

Simple rate-limit firewall.

dev-master 2016-05-11 14:10 UTC

Requires

• php: >=5.5

MIT

• ariarijp

• firewall

README

Simple rate-limit firewall.

Requirements

PHP 5.5+ and APCu extension or phpredis extension 2.2+ are required.

Installation

Add these lines to your composer.json.

"require": {
    "ariarijp/cassowary": "dev-master"
}

Usage

Using RedisAdapter

<?php

require_once __DIR__.'/vendor/autoload.php';

define('CASSOWARY_THRESHOLD', 20);

Cassowary\Adapter\RedisAdapter::init([
    'host' => 'localhost',
    'port' => 6379,
    'prefix' => 'cassowary_',
    'index' => 9,
    'ttl' => 10,
]);

Cassowary\Cassowary::kick(CASSOWARY_THRESHOLD, $_SERVER['REMOTE_ADDR'], Cassowary\Adapter\RedisAdapter::class, function($host) {
    error_log($host. ' added to blacklist.');
}, function($host, $count) {
    header('HTTP/1.1 403 Forbidden');
    exit;
});

Using ApcuAdapter

<?php

require_once __DIR__.'/vendor/autoload.php';

define('CASSOWARY_THRESHOLD', 20);

Cassowary\Adapter\ApcuAdapter::init([
    'prefix' => 'cassowary_',
    'ttl' => 10,
]);

Cassowary\Cassowary::kick(CASSOWARY_THRESHOLD, $_SERVER['REMOTE_ADDR'], Cassowary\Adapter\ApcuAdapter::class, function($host) {
    error_log($host. ' added to blacklist.');
}, function($host, $count) {
    header('HTTP/1.1 403 Forbidden');
    exit;
});

License

MIT

Author

ariarijp