All guides

Guides

Reqtide PHP

Get started

InstallAdd Reqtide to a Composer project with Composer from Packagist, or run the examples in Docker without installing PHP.
Getting startedBuild a pipeline that retries a flaky call, rate limits it, guards it with a circuit breaker and bounds it with a deadline. About ten minutes.

ConceptsLearn what Reqtide keeps apart: the pipeline, the operation, the attempt and the partition. See where each rule lives and in what order the checks run.

Choosing policiesSee which protection answers which problem, how your classifier decides what counts as a failure, and which options you must size yourself.
Retry and budgetConfigure retries and size a retry budget. Learn the three things a retry needs, and what Reqtide does when a server says "retry after 60 seconds".
Rate limitingPick a rate-limit algorithm, see why retries are charged like first attempts, and tell a refusal that will pass from one that never will.
Circuit breakerConfigure a circuit breaker, read its seven arguments in order, decide which outcomes count against it, and recognize the refusal you get while it is open.
Bulkhead and cooldownCap concurrent operations with a bulkhead, learn what its lease promises, and pause new operations after a server asks you to wait.
Fencing writes downstreamA bulkhead lease can run out while the first callback is still working. Let the store you write to refuse the late write with a fence number.
FallbackGive one operation a replacement value for when the call fails. Choose whether the fallback may also replace refusals, and see what it never replaces.

Error handlingTell your own exceptions from Reqtide decisions. Read the reason code and the problem report, and see how detailed mode returns the same facts as data.
Testing with the virtual clockTest retries, backoff and circuit recovery without sleeping. Wire one virtual clock through the pipeline, script each attempt and assert on what was dispatched.

Shared state with RedisMove the rate limit, circuit breaker, bulkhead, retry budget and cooldown into one Redis server, so every process shares one quota and one open circuit.
Guzzle requests with ReqtideSend Guzzle requests through a Reqtide pipeline. State what may be sent twice, choose retryable outcomes, honor Retry-After and see what the client does not do.

LimitsWhat Reqtide does and does not do today. State, deadlines, retries, shared state, tested platforms, what the library commits to, and how versions work.
Comparison with other librariesA recorded comparison of Reqtide with six other PHP libraries on 21 behavior scenarios: the method, the results, the limits of the test and how to repeat it.
FAQShort answers about installing Reqtide, what it does and does not do, how errors and tests work, and where to report a bug or ask for a feature.

API referenceEvery public class, interface and enum of Reqtide, with its signatures and a short note on what each method does. Read it next to the guides.