StnRateLimitingBundle

This bundle(require Predis) adds support for request rate limiting management in Symfony., _(*1)

, _(*2)

Installation

Download StnRateLimitingBundle bundle using Composer

$ composer require stn/rate-limiting-bundle

Register StnRateLimitingBundle

<?php
// app/AppKernel.php

// ...
    public function registerBundles()
    {
        $bundles = array(
            // Other bundles ...

            new Stn\RateLimitingBundle\StnRateLimitingBundle(),
        );
    }
// ...

Configuration

# app/config/config.yml
stn_rate_limiting:
    enable: true    # Whether rate limiting is available or not
    limit:  60      # Limit of request
    ttl:    60      # Cache expiry time, second as unit (Time to live)
    key_prefix: ~   # The cache key prefix, defaults to 'RL'
    key_length: ~   # The cache key length, defaults to 8
    client:         # Configuration for Predis
        dsn:  ~     # DSN for connection, defaults to 'tcp://127.0.0.1:6379'
        pass: ~     # Redis requirepass configuration, will invoke `auth` to setup connection if provided, defaults to null

Usage

Use annotation @RateLimiting to rate limit request, and you can setup rate limit by manual the following two parameters or use default configuration:, _(*3)

limit
ttl

// any controller
use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Stn\RateLimitingBundle\Annotation\RateLimiting;

/**
 * Mark with annotation `RateLimiting` to enable rate limiting.
 *
 * @RateLimiting(limit=10, ttl=60)
 */
class DefaultController extends Controller
{
    /**
     * Annotation in controller's action has a higher priority than controller itself.
     *
     * @RateLimiting(limit=2, ttl=10)
     */
    public function indexAction()
    {
        // Do something...
    }
}

TODO

[ ] Add forbidden response template
[ ] Make redis configuration more flexible
[ ] More tests

License

MIT, _(*4)

06/07 2016

dev-master

9999999-dev https://github.com/Santino-Wu/StnRateLimitingBundle

The bundle for managing request rate limiting

Sources Download

MIT

The Requires

php >=5.3.9
predis/predis ~1.1
sensio/framework-extra-bundle ^3.0.13
symfony/framework-bundle ^2.7|^3.0

The Development Requires

phpunit/phpunit ~4.8

by Santino Wu

api bundle symfony rate-limiting

symfony-bundle rate-limiting-bundle