Download the PHP package eventsauce/backoff without Composer
On this page you can find all versions of the php package eventsauce/backoff. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download eventsauce/backoff
More information about eventsauce/backoff
Files in eventsauce/backoff
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package backoff
EventSauce BackOff
This library provides an interface for encapsulated back-off strategies.
Leveraging the back-off strategies
A back-off strategy is applied in side a piece of code that retries a certain task.
Exponential back-off
A well-known back-off strategy is exponential back-off, which is the default provided strategy.
Fibonacci back-off
The Fibonacci back-off strategy increases the back-off based on the fibonacci sequence.
Linear back-off
The linear back-off strategy increases the back-off time linearly.
Jitter
When many clients are forced to retry, having deterministic interval can cause many of these clients to retry at the same time. Adding randomness to the mix ensures retrying clients are scattered across time. The randomness ensures that it is less likely for the clients to all retry at the same time.
Using Jitter
Every strategy that sleeps accepted a EventSauce\BackOff\Jitter\Jitter
implementation.
Full Jitter
The full jitter uses a randomized value from 0 to the initial calculated sleep time.
Half Jitter
The full jitter uses a randomized value from half the initial sleep to the full initial sleep time.
Scattered Jitter
The scattered jitter uses a range in across which it's scatter the resulting values. To illustrate, here are a few examples:
| Range | Min | Max |
|---|---|---|
| 0.25 | 75% | 125% |
| 0.5 | 50% | 150% |
| 0.1 | 90% | 110% |
Design rationale
Unlike other exponential back-off libraries, this library doesn't run the operation you want to retry. This makes the design of the package very simple. It also doesn't impose any limitations on the surround code.
You can retry based on a return value:
You can retry on a specific exception type:
The choice is yours. Enjoy!
PS: yes, those were a lot of goto statements, deal with it 😎
But Frank, I'm super lazy!
Ok ok ok, well in that case, use the BackOffRunner class to run any
callable with a retry strategy.
Want to only retry on certain exceptions? Pass the exception class as the second constructor argument.
