kodefarmers/laravel-cadence

Progressive, strategy-based backoff for Laravel.

v1.1.0 2026-07-19 10:25 UTC

Requires

• php: ^8.4

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.14
• orchestra/testbench: ^11.0.0||^10.0.0||^9.0.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0

MIT

• Shivaji Chalise

• cache
• throttle
• retry
• laravel
• backoff
• strategy
• laravel-package
• exponential-backoff
• retry-strategy
• cadence
• laravel-cadence
• fibonacci-backoff
• linear-backoff
• quadratic-backoff

Published on Packagist.org on 2026-07-19 10:29 UTC

README

Cadence is a Laravel package for applying progressive backoff based on consecutive failures.

Unlike traditional rate limiting, Cadence only introduces delays after repeated failed attempts. A successful operation immediately resets the backoff state, allowing normal traffic to continue uninterrupted while slowing down repeated failures.

• Track repeated failures on a per-key basis
• Apply progressive backoff after configurable free attempts
• Multiple built-in backoff strategies (Exponential, Fibonacci, Linear, Quadratic)
• Optional jitter algorithms to distribute retries and reduce synchronized retry bursts
• Reset backoff immediately after successful operations
• Store state using Laravel's cache abstraction

Documentation

For the full installation guide, configuration reference, usage examples, API documentation, and step-by-step walkthroughs, visit:

https://cadence.kodefarmers.tech

The documentation source files are maintained in the companion repository:

kodefarmers/laravel-cadence-guide

Contributors can use the repository to review, edit, and improve the documentation.

Contributing

Contributions are welcome. Please open an issue to discuss significant changes before submitting a pull request.

License

Cadence is open-source software licensed under the MIT License.