https://github.com/jeroenvisser101/leakybucket

PHP implementation of the Leaky Bucket algorithm.
https://github.com/jeroenvisser101/leakybucket

Last synced: 19 days ago
JSON representation

PHP implementation of the Leaky Bucket algorithm.

• Host: GitHub
• URL: https://github.com/jeroenvisser101/leakybucket
• Owner: jeroenvisser101
• License: mit
• Created: 2014-07-04T06:02:50.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2018-07-26T10:51:09.000Z (over 6 years ago)
• Last Synced: 2025-01-01T22:49:44.213Z (23 days ago)
• Language: PHP
• Homepage:
• Size: 20.5 KB
• Stars: 43
• Watchers: 6
• Forks: 10
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# LeakyBucket [![Build Status](https://travis-ci.org/jeroenvisser101/LeakyBucket.svg?branch=master)](https://travis-ci.org/jeroenvisser101/LeakyBucket)

Leaky Bucket is an algorithm which works as follows:

1. There is a bucket.

1. The bucket has a defined leak and defined capacity.

1. The bucket leaks at a constant rate.

1. Overflows when full, will not add other drops to the bucket.

## Usage

### Basic usage

``` php

 10,

    'leak'     => 1

];

// Create the bucket

$bucket = new LeakyBucket('example-bucket', $storage, $settings);

// Fill the bucket

$bucket->fill();

// Check if it's full

if ($bucket->isFull()) {

    header('HTTP/1.1 429 Too Many Requests');

    exit '
429 Too Many Requests
You seem to be doing a lot of requests. You\'re now cooling down.
';

}


// ...

```

### Other functionality

You can also do great stuff with it through the methods that LeakyBucket provides.

``` php

// Get capacity information

$capacityTotal = $bucket->getCapacity();

$capacityLeft  = $bucket->getCapacityLeft();

$capacityUsed  = $bucket->getCapacityUsed();

// Get the drops/second that the bucket leaks

$leakPerSecond = $bucket->getLeak();

// Get the last timestamp from when the bucket was updated

$timestamp = $bucket->getLastTimestamp();

// Set additional data

$bucket->setData(

    [

        'timeout' => 3600

    ]

);

// Get additional data

$data = $bucket->getData();

// Update the bucket with the leaked drops

$bucket->leak();

// Remove excess drops

$bucket->overflow();

// Update the bucket's timestamp manually

$bucket->touch();

// Fill the bucket with one drop

$bucket->fill();

// Fill the bucket with 5 drops

$bucket->fill(5);

// Spill one drop from the bucket

$bucket->spill();

// Spill 5 drops from the bucket

$bucket->spill(5);

// Remove the bucket's content

$bucket->reset();

// Force save

$bucket->save();

```

## Contributing

You can contribute by forking the repo and creating pull requests. You can also create issues or feature requests.

#### Checklist

1. Your code complies with the [PSR-2](http://www.php-fig.org/psr/psr-2/) standards. (check using the [php-cs-checker](http://cs.sensiolabs.org/))

1. Your code is fully tested and PHPUnit tests are also supplied.

1. Your code passes in TravisCI build.

1. By contributing your code, you agree to license your contribution under the MIT license.

## Boring legal stuff

This project is licensed under the MIT license. `LICENSE` file can be found in this repository.