icecave/interlude

Emulated timeouts for synchronous operations.

0.1.0 2014-11-10 08:16 UTC

Requires

• php: >=5.3
• icecave/isolator: ~3

Requires (Dev)

• eloquent/phony: ~0.1.0@dev
• icecave/archer: ~1

MIT

• James Harris

• sync
• retry
• async
• repeat
• timeout
• ttl

README

Interlude is a small PHP library for repeating a non-blocking operation until it succeeds, a timeout period is reached, or a maximum number of attempts have been performed.

If you don't need the timeout feature, you might want to try igorw/retry.

• Install via Composer package icecave/interlude
• Read the API documentation

Example

use Icecave\Interlude\Exception\AttemptsExhaustedException;
use Icecave\Interlude\Exception\TimeoutException;
use Icecave\Interlude\Invoker;

$invoker = new Invoker;

$operation = function ($remainingTimeout, $remainingAttempts) {
    // do work ...
};

try {
    $invoker->invoke(
        $operation,
        10, // ten second timeout
        3   // maximum of three attempts
    );
} catch (TimeoutException $e) {
    echo 'The operation timed out!' . PHP_EOL;
} catch (AttemptsExhaustedException $e) {
    echo 'The operation was attempted the maximum number of times!' . PHP_EOL;
}

Contact us

• Follow @IcecaveStudios on Twitter
• Visit the Icecave Studios website
• Join #icecave on irc.freenode.net