README

Monolog的Zend Expressive实现（https://github.com/Seldaek/monolog/）

安装

composer require davidburger/expressive-logger

设置

cd <project_root>
cp vendor/davidburger/expressive-logger/config/errorlog.global.php.dist config/autoload/errorlog.global.php

• 编辑config/autoload/errorlog.global.php文件并设置所需内容

配置指令

registerErrorHandler（默认值：false）

• 如果启用，则logger初始化后调用\Monolog\ErrorHandler::register()方法设置PHP错误处理器，更多详情请参阅https://php.ac.cn/manual/en/ref.errorfunc.php

ignoredExceptionClasses（默认值：[]）

• 不会由定义的错误处理器记录的异常类名称

useIgnoreLogic（默认值：false）

• false = 记录所有错误
• true = ignoredExceptionClasses数组中定义的类和ExpressiveLogger\Exception\NotLoggableInterface的实例将被logger忽略

useFacade（默认值：true）

• logger将用于静态调用 - 详见下文。

exceptionFormatterCallback（默认值：null）

• 在调用Monolog\Logger::error($message, $context)之前，用于格式化异常消息和确定上下文的回调函数
• 如果两者都定义了，则优先级高于messageFormatter
• 配置示例

'exceptionFormatterCallback' => function($exception, &$context) {

    if (true === empty($context)) {
        $context = ['exception' => $exception];
    }

    return sprintf('Exception %s: "%s" at %s line %s',
        get_class($exception),
        $exception->getMessage(),
        $exception->getFile(),
        $exception->getLine()
    );
},

messageFormatter（默认值：null）

• 在调用Monolog\Logger::error($message)之前用于格式化错误消息的类（对于异常非常有用）
• 如果两者都定义了，则优先级低于exceptionFormatterCallback
• 可以编写和自定义实现\ExpressiveLogger\MessageFormatter\MessageFormatterInterface的格式化器
• 配置示例

'messageFormatter' => \ExpressiveLogger\MessageFormatter\DefaultFormatter::class

使用方法

Bootstrap初始化

<?php

require __DIR__ . '/vendor/autoload.php';

/** @var \Interop\Container\ContainerInterface $container */
$container = require __DIR__ . '/config/container.php';

$factory = new \ExpressiveLogger\LoggerFactory();
$logger = $factory($container);

静态调用

use ExpressiveLogger\LoggerFacade;
//..

try {

} catch(RuntimeException $e) {
   LoggerFacade::error($e);
}

Monolog处理器配置

RedisHandler

'dependencies' => [
    'factories' => [
        \Monolog\Handler\RedisHandler::class => \ExpressiveLogger\Factory\RedisHandlerFactory::class,
    ],
],
'expressiveLogger' => [
    'handlers' => [
        'redis' => [
            'client' => 'redisClient',  //name of redis instance available via container
            'key' => 'logstash',
            'level' => Logger::DEBUG,
        ],
    ]
]