MongoDB\add_logger()

定义

MongoDB\add_logger()

注册PSR日志记录器以接收扩展的日志消息。

function add_logger(Psr\Log\LoggerInterface $logger): void

参数

$logger : Psr\Log\LoggerInterface

要注册的日志记录器。

如果日志记录器已注册，则此方法将不会有任何效果。

行为

此函数允许应用程序注册一个或多个Psr\Log\LoggerInterface对象，以接收来自libmongoc和扩展的日志消息。每个注册的日志记录器将接收所有客户端的日志消息。

来自扩展的日志消息将将其日志级别转换为等效的PSR日志级别。出于性能考虑，来自扩展的跟踪级别消息不会转发到PSR日志记录器。扩展的mongodb.debug INI配置必须用于收集跟踪级别日志。

日志消息还包括一个域字符串，用于标识发出日志消息的驱动程序组件。此值通过上下文数组的{{domain}}键提供给PSR日志记录器。

错误/异常

MongoDB\Exception\InvalidArgumentException 用于与参数或选项解析相关的错误。

另请参阅

• MongoDB\remove_logger()

• PSR-3: 日志接口

• libmongoc: 日志记录