divineomega / attempt
Attempt to run a function, retrying if needed
Fund package maintenance!
DivineOmega
Installs: 5
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 0
Forks: 0
Open Issues: 0
pkg:composer/divineomega/attempt
Requires
- php: >=7.1
Replaces
- divineomega/attempt: v3.0.0
This package is auto-updated.
Last update: 2026-02-15 03:09:45 UTC
README
This PHP package allows you to attempt to run a function, automatically retrying if an exception occurs.
It can useful for:
- Unreliable connectivity or APIs
- Interaction with rate-limited systems
- Handling unreliable input data
Installation
To install Attempt, just run the following command.
composer require jord-jd/attempt
Usage
See the following usage examples.
// Attempts to run the function immediately. If an exception occurs, retry forever. attempt(function() { // ... })->now(); // Attempts to run the function immediately. If an exception occurs, retry up to 5 times. attempt(function() { // ... })->maxAttempts(5) ->now(); // Attempts to run the function immediately. If an exception occurs, retry until the specified date time. attempt(function() { // ... })->until($datetime) ->now(); // Attempts to run the function immediately. If an exception occurs, retry forever, with a 20 second gap between attempts. attempt(function() { // ... })->withGap(20) ->now(); // Attempts to run the function at a specified date time. If an exception occurs, retry forever. The thread will block until the specified date time is reached. attempt(function() { // ... })->at($datetime);
Most of these methods can be chained and used together as you might expect to give the desired functionality.