Download the PHP package diephp/perhaps without Composer

Perhaps Retry Library

A Laravel package that provides a simple way to retry any logic with customizable attempts and delays. This can be particularly useful in scenarios where certain operations might fail due to transient issues, such as network errors or temporary service outages.

Installation

1. Install the package via Composer:

2. Register the service provider in your config/app.php file:

   or for laravel 11+ add Provider to list in bootstrap/providers.php

3. Optionally, publish the package configuration:

Usage

Basic Usage

The main function provided by this package is Perhaps::retry. You can use it to retry any logic with a specified number of attempts.

Handling Delays

You can also specify a delay sequence using a Traversable iterator. This allows you to define custom delay logic between retries. you can see details on https://github.com/diephp/sequences

LogarithmicSequence

Simple Explanation:

Each value in the sequence is derived from multiplying the previous value by a logarithmic growth factor, which depends on the configured percentage. Squaring the factor introduces a faster scaling effect, and rounding ensures integer progression. The result on the 10th iteration will exceed 3 hours, which means that by this point, the total time represented by the sequence will have grown significantly. This feature of the LogarithmicSequence can be quite useful when working with remote services that may become temporarily unavailable. In such cases:

• You may not want to abandon already processed data, especially if its collection or processing took a considerable effort.
• Instead, the logarithmic growth helps you wait longer between retries, which increases the likelihood of success without wasting too much CPU time or bandwidth in continual attempts.

This makes it possible to gracefully handle delays and resilience in long-running processes when interacting with unreliable external services.

Retry result table by LogarithmicSequence(1000000, 100)

ProgressiveSequence

How ProgressiveSequence works (in words):

The ProgressiveSequence is a number sequence generator where each value grows progressively based on a fixed starting value and a percentage increment.

1. Starting Value: The sequence starts with a given base value (start).

2. Growth By Percentage: For each iteration:

   • The increment is calculated as a percentage of the starting value (start).
   • This percentage-based increment grows proportionally with the iteration number, meaning each next value adds more than the previous iteration.
3. Round Calculation: The calculated result is rounded to the nearest integer to avoid fractional values.
4. Behavior Over Iterations: Since the increment grows with each step, the sequence becomes larger and larger — forming a progressive growth trend.

Key Difference from LogarithmicSequence:

While LogarithmicSequence grows based on a logarithmic scaling factor, which slows down over time, the ProgressiveSequence grows linearly and increases consistently by a calculated percentage.

Microseconds Conversion Table

Here’s the conversion of the provided microseconds values into seconds, minutes, and hours as requested:

RandSequence

ExponentialSequence

• Exponential Growth: Unlike linear or logarithmic sequences, this formula ensures that the numbers grow at an increasingly rapid pace. Each iteration introduces a massively larger value than the previous one.
• Practical Usage: Such sequences are most often used in scenarios where values need to expand exponentially, such as in backoff strategies or modeling growth over time.

Example with Exception Handling

In this example, the retry logic will handle exceptions and log the retry attempts.

Configuration

You can configure the package by modifying the published configuration file config/perhaps.php. This allows you to customize the logging and exception handling behavior.

License

This package is open-source software licensed under the MIT license.

Key Points

• The retry method allows you to retry any callable logic a specified number of times.
• You can specify a delay sequence for custom delay logic between retries.
• Register the service provider and optionally publish the configuration for customization.
• Use the provided facade for easy access to the retry method in your Laravel application.