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

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