在laravel项目中第三方回调信息处理扩展包:flaky

2023-06-01 第三方 扩展 回调

Flaky是一个由Aaron Francis设计的Laravel软件包,帮助你处理由不可靠的第三方造成的间歇性故障。

> 有时候,我有一些依赖第三方的代码,我并不超级关心它是否时常失败,
 我只是想在一天左右没有成功的时候发出警报。
 所以我写了一个小包来处理这些不稳定的命令和不稳定的回调。
 
Flaky, for Laravel. pic.twitter.com/YCpJyOqSIx

- Aaron Francis (@aarondfrancis) March 2, 2023

在某些情况下,你并不关心第三方代码是否失败,

你可以像这样把它包装在一个Flaky调用中:

Flaky::make('my-flaky-code')
    ->allowFailuresForAnHour()
    ->run(function() {
        if (Lottery::odds(1 / 5)->choose()) {
            throw new Exception("Oops");
        }
    });


在readme的例子中,除非操作在一小时内没有成功,否则异常会被消音。

该代码使用传递给make()方法的my-flaky-code作为缓存密钥。

在写这篇文章的时候,Flaky使用你Laravel应用中的默认缓存驱动来缓存跟踪flaky代码。


在上面的例子中,如果调用成功,一个小时的期限就会被休息。

换一种说法,在上面的例子中,每一个后续的成功都会将失败的计数器往后推一整小时。


Flaky包有各种基于时间的方法,你可以根据你的具体需要来配置时间框架:

$flaky->allowFailuresForAMinute();
$flaky->allowFailuresForMinutes(20);
$flaky->allowFailuresForAnHour();
$flaky->allowFailuresForHours(5);
$flaky->allowFailuresForADay();
$flaky->allowFailuresForDays(3);
 
// Full custom
$flaky->allowFailuresFor(
    seconds: $seconds,
    minutes: $minutes,
    hours: $hours,
    days: $days
);


这个软件包还允许你做基于计数的连续故障或故障的总计数。

你还可以把基于时间的计数器和基于计数的计数器结合起来:

$flaky->allowConsecutiveFailures(10)->run(/* ... */);
$flaky->totalFailures(10)->run(/* ... */);
 
$flaky
    ->allowFailuresForMinutes(20)
    ->totalFailures(5)
    ->run(fn () => doStuff());


这个软件包的其他有趣的功能包括如下:

1.立即重试
2.报告失败,而不是抛出一个异常
3,。访问flaky代码执行的结果
4.在Artisan中使用flaky与FlakyCommand

你可以在GitHub上了解更多关于这个包的信息,获得完整的安装说明,并查看源代码。

https://github.com/hammerstonedev/flaky

相关文章