README

这是一个为 guzzle 开发的中间件，可以帮助您使用 PSR-3 日志记录器自动记录每个请求和响应。

此中间件与 Guzzle 的第 6 版兼容。

安装

通过 Composer

$ composer require gmponos/guzzle_logger

用法

简单用法

use GuzzleLogMiddleware\LogMiddleware;
use GuzzleHttp\HandlerStack;

$logger = new Logger();  //A new PSR-3 Logger like Monolog
$stack = HandlerStack::create(); // will create a stack stack with middlewares of guzzle already pushed inside of it.
$stack->push(new LogMiddleware($logger));
$client = new GuzzleHttp\Client([
    'handler' => $stack,
]);

从现在起，您使用 $client 对象执行的每个请求和响应都将被记录。默认情况下，中间件使用 DEBUG 级别记录每个活动。

高级初始化

LogMiddleware 类的签名如下

\GuzzleLogMiddleware\LogMiddleware(
    \Psr\Log\LoggerInterface $logger, 
    \GuzzleLogMiddleware\Handler\HandlerInterface $handler = null, 
    bool $onFailureOnly = false, 
    bool $logStatistics = false
);

• logger - 用于记录的 PSR-3 日志记录器。
• handler - 负责记录您的请求/响应的 HandlerInterface 类。请查看处理器部分。
• onFailureOnly - 默认情况下，中间件设置为记录每个请求和响应。如果您希望在 Guzzle 返回拒绝时仅记录 HTTP 消息，请将此设置为 true，或者当发生异常时。Guzzle 在 http_errors 选项设置为 true 时返回拒绝。
• logStatistics - 如果您将此选项设置为 true，则中间件还将记录关于 HTTP 事务的统计信息。

处理器

为了使中间件更加灵活，我们允许开发者在初始化时使用处理器。处理器是负责记录 HTTP 消息的类，它必须实现 HandlerInterface。

例如，假设我们创建了以下处理器

<?php
namespace GuzzleLogMiddleware\Handler;

use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\RequestInterface;
use GuzzleHttp\TransferStats;
use Psr\Log\LoggerInterface;

/** A simple handler that logs only requests */
final class SimpleHandler implements HandlerInterface
{
    public function log(
        LoggerInterface $logger,
        RequestInterface $request,
        ?ResponseInterface $response = null,
        ?\Throwable $exception = null,
        ?TransferStats $stats = null,
        array $options = []
    ): void {
        $logger->debug('Guzzle HTTP request: ' . \GuzzleHttp\Psr7\str($request));
        return;
    }
}

我们可以在构造中间件时传递上述处理器。

<?php
use GuzzleLogMiddleware\LogMiddleware;
use GuzzleHttp\HandlerStack;

$logger = new Logger();  //A new PSR-3 Logger like Monolog
$stack = HandlerStack::create(); // will create a stack stack with middlewares of guzzle already pushed inside of it.
$stack->push(new LogMiddleware($logger, new SimpleHandler()));
$client = new GuzzleHttp\Client([
    'handler' => $stack,
]);

从现在起，所有请求都将被记录。请注意，在上面的示例中，仅记录请求。

重要

如果没有传递处理器，中间件将初始化它自己的处理器。目前默认的是 MultiRecordArrayHandler。

MultiRecordArrayHandler

这是中间件使用的默认处理器。此处理器内部使用 FixedStrategy 并以调试级别记录所有请求和响应。此处理器为每个 Request、Response、Exception 或 TransferStats 添加一个单独的日志条目。每个对象的信息作为 context 数组添加到日志条目中。

StringHandler

此处理器内部使用 FixedStrategy 并以调试级别记录所有请求和响应。您可以使用自定义策略初始化此处理器。此处理器为每个请求、响应、异常或 TransferStats 添加一个单独的日志条目。处理器将对象转换为字符串，并将每个对象的信息添加到日志条目的 message 中。

日志级别策略

策略用于定义处理器用于记录每个对象的日志级别。

FixedStrategy

您可以使用此策略使用特定级别记录每个 HTTP 消息。

StatusCodeStrategy

您可以使用此策略根据响应的状态码使用特定级别记录每个 HTTP 响应。

$strategy = new StatusCodeStrategy(
    LogLevel::INFO, // Default level used for requests or for responses that status code are not set with a different level.
    LogLevel::CRITICAL // Default level used for exceptions.
);
$strategy->setLevel(404, LogLevel::WARNING);
$multiRecordArrayHandler = new MultiRecordArrayHandler($strategy);

$logger = new Logger();  //A new PSR-3 Logger like Monolog
$stack = HandlerStack::create(); // will create a stack stack with middlewares of guzzle already pushed inside of it.
$stack->push(new LogMiddleware($logger, $multiRecordArrayHandler));
$client = new GuzzleHttp\Client([
    'handler' => $stack,
]);

在每个请求上使用选项

您可以在每个请求上设置有关您的日志的选项。

$client->get('/', [
    'log' => [
        'on_exception_only' => true,
        'statistics' => true,
    ]
]);

• on_exception_only 除非响应状态码超过阈值，否则不记录任何内容。
• statistics 如果 on_exception_only 选项/变量为 true，并且这也为 true，则中间件将记录 HTTP 调用的统计信息。

变更日志

请参阅 变更日志 获取更多关于最近更改的信息。

测试

$ composer test

鸣谢

• George Mponos
• 贡献者

许可证

MIT 许可证 (MIT)。请参阅 许可证文件 获取更多信息。