在 API 开发过程中，性能往往是至关重要的考量因素。我们需要知道每个 API 请求的耗时，以便快速定位性能瓶颈并进行优化。对于使用 Guzzle 作为 HTTP 客户端的 PHP 项目来说，手动添加计时器来监控请求耗时，不仅代码冗余，而且容易出错。
csa/guzzle-stopwatch-middleware 正是为了解决这个问题而诞生的。它是一个 Guzzle 中间件，可以无侵入地为你的 Guzzle 客户端添加请求耗时监控功能。它利用 Symfony 的 Stopwatch 组件，能够精确地测量每个请求的耗时，并将结果记录下来，方便你进行分析和优化。
安装
使用 Composer 安装 csa/guzzle-stopwatch-middleware 非常简单：
composer require csa/guzzle-stopwatch-middleware
使用
安装完成后，你需要将这个中间件添加到你的 Guzzle 客户端中。以下是一个简单的示例：
use GuzzleHttp\Client;
use CSA\GuzzleStopwatchMiddleware\StopwatchMiddleware;
use Symfony\Component\Stopwatch\Stopwatch;
// 创建 Stopwatch 实例
$stopwatch = new Stopwatch();
// 创建 StopwatchMiddleware 实例
$stopwatchMiddleware = new StopwatchMiddleware($stopwatch);
// 创建 Guzzle 客户端
$client = new Client([
'handler' => $stopwatchMiddleware->getMiddleware(),
]);
// 发起请求
$response = $client->get('https://example.com');
// 获取请求耗时
$event = $stopwatch->getEvent('guzzle.request');
$duration = $event->getDuration(); // 毫秒
echo "请求耗时：{$duration} ms";优势和应用效果
- 无侵入性：无需修改现有 Guzzle 请求代码，即可添加耗时监控。
- 精确计时：利用 Symfony Stopwatch 组件，提供精确的请求耗时数据。
- 易于集成：通过中间件的方式集成到 Guzzle 客户端，使用简单方便。
- 快速定位性能瓶颈：通过监控每个请求的耗时，快速发现性能瓶颈，并进行针对性优化。
在实际应用中，你可以将请求耗时数据记录到日志中，或者将其发送到监控系统，以便进行更深入的分析和告警。csa/guzzle-stopwatch-middleware 可以帮助你更好地了解你的 API 性能，并及时发现和解决问题，提升用户体验。
