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或当发生异常时。当http_errors选项设置为true时，Guzzle返回拒绝。
• 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并使用调试级别记录所有请求和响应。您可以使用自定义策略初始化此处理程序。此处理程序为每个请求、响应、异常或传输状态添加单独的日志条目。处理程序将对象转换为字符串，并将有关每个对象的信息添加到日志条目的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 仅在响应状态码高于阈值时记录任何内容。
• 如果 on_exception_only 选项/变量为真，并且这也为真，则中间件将记录关于 HTTP 请求的统计信息。

变更日志

有关最近更改的更多信息，请参阅 变更日志。

测试

$ composer test

致谢

• George Mponos
• 贡献者

许可证

MIT 许可证 (MIT)。有关更多信息，请参阅 许可证文件。