Download the PHP package tagadvance/elephant-retrying without Composer
On this page you can find all versions of the php package tagadvance/elephant-retrying. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tagadvance/elephant-retrying
More information about tagadvance/elephant-retrying
Files in tagadvance/elephant-retrying
Package elephant-retrying
Short Description This is a port of the guava-retrying module to allow for the creation of configurable retrying strategies for an arbitrary function call, such as something that talks to a remote service with flaky uptime.
License Apache-2.0
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 elephant-retrying
What is this?
The elephant-retrying module provides a general purpose method for retrying arbitrary PHP code with specific stop, retry, and exception handling capabilities.
This is a fork of the excellent guava-retrying code posted here by Ray Holder (rholder).
Port Accommodations
- Generics have been removed because PHP does not support generics.
- All time units have been converted to seconds of type
float. - Time limiter has been removed as such functionality would be difficult to implement in PHP.
Composer
Quickstart
A minimal sample of some of the functionality would look like:
This will retry whenever the result of the Callable is null, if an IOException is thrown, or if any other
RuntimeException is thrown from the call() method. It will stop after attempting to retry 3 times and throw a
RetryException that contains information about the last failed attempt. If any other Exception pops out of the
call() method it's wrapped and rethrown in an ExecutionException.
Exponential Backoff
Create a Retryer that retries forever, waiting after every failed retry in increasing exponential backoff intervals
until at most 5 minutes. After 5 minutes, retry from then on in 5 minute intervals.
You can read more about exponential backoff and the historic role it played in the development of TCP/IP in Congestion Avoidance and Control.
Fibonacci Backoff
Create a Retryer that retries forever, waiting after every failed retry in increasing Fibonacci backoff intervals
until at most 2 minutes. After 2 minutes, retry from then on in 2 minute intervals.
Similar to the ExponentialWaitStrategy, the FibonacciWaitStrategy follows a pattern of waiting an increasing amount
of time after each failed attempt.
Instead of an exponential function it's (obviously) using a Fibonacci sequence to calculate the wait time.
Depending on the problem at hand, the FibonacciWaitStrategy might perform better and lead to better throughput than
the ExponentialWaitStrategy - at least according to
A Performance Comparison of Different Backoff Algorithms under Different Rebroadcast Probabilities for MANETs.
The implementation of FibonacciWaitStrategy is using an iterative version of the Fibonacci because a (naive) recursive
version will lead to a StackOverflowError
at a certain point (although very unlikely with useful parameters for retrying).
Inspiration for this implementation came from Efficient retry/backoff mechanisms.
Source
git clone [email protected]:tagadvance/elephant-retrying.git
Clean, Install, and Test
./make
License
The guava-retrying module is released under version 2.0 of the Apache License.
