Download the PHP package otzy/intensity-throttle without Composer
On this page you can find all versions of the php package otzy/intensity-throttle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download otzy/intensity-throttle
More information about otzy/intensity-throttle
Files in otzy/intensity-throttle
Package intensity-throttle
Short Description limets the rate of event of any kind using leaky bucket algorithm
License MIT
Informations about the package intensity-throttle
IntensityThrottle
With IntensityThrottle package you can easily limit the rate of events of any kind. For example you can keep an eye on the rate of requests to your servers or the rate of errors in cron jobs.
IntensityThrottle implements Leaky Bucket algorithm, which means that you are able to set not only bandwidth, but burstiness as well. That is to say, short spikes in the event rate are possible.
Due to the nature of php, the leakage happens not on regular basis (not continuously), but at the moment when an event is being handled. This changes the behavior of buckets a bit, but in the end they do their job.
Usage
Package comes with InProcessStorage, which can be used when you need to limit events in the single process, for example in a long running cron job:
If you want to throttle web requests or any other events across different requests and/or servers, you should use memcached server. You can use Memcached class directly as a storage:
Bucket volume
$throttle->addLimit($max_drops, $time_span)
adds a bucket with volume=$max_drops.
At first glance, $throttle->addLimit(3, 1)
and $throttle->addLimit(6, 2)
are the same. The second bucket has twice bigger volume and twice higher leakage rate.
So if the average rate of incoming events will be 3 events/second, both buckets will not overflow.
The difference is that second bucket is capable to support a higher burstiness rate, i.e. temporary unevenness in the event flow.
The example above (with bucket volume = 3) will stop after 2.255 seconds. If you replace $throttle->addLimit(3, 1)
with $throttle->addLimit(6, 2)
, the script will stop after 5.26 seconds.