网上的文章普遍是 Laravel 5.5 版本,而日志系统在 5.6 版本升级时进行了部分改动,原有方法基本都失效了。本文根据 Laravel 5.6 文档的指引,实现使用 MongoDB 存储框架日志。

0x00 准备

MongoDB Engine

首先,安装 MongoDB,参见 官方文档

MongoDB Driver(PHP Extension)

其次,安装 PHP mongodb 扩展,参见 官方文档

GitHub:https://github.com/mongodb/mongo-php-driver

MongoDB Library(Wrapper Package)

最后,通常情况下,你还需要一个高度封装的包装库;使用 MongoDB 官方提供即可,参见 官方文档

GitHub:https://github.com/mongodb/mongo-php-library

0x01 配置

打开 config/logging.php,修改其 channels

return [
// ...

'channels' => [
// ...

'mongodb' => [ // 此处可以根据需求调整
'driver' => 'custom', // 此处必须为 `custom`
'via' => CreateCustomLogger::class, // 当 `driver` 设置为 custom 时,使用 `via` 配置项所指向的工厂类创建 logger

// 以下 env 配置名可以根据需求调整
'server' => env('LOG_MONGO_SERVER', 'mongodb://localhost:27017'),
'database' => env('LOG_MONGO_DB', 'logs'),
'collection' => env('LOG_MONGO_COLLECTION', 'logs'),
'level' => env('LOG_MONGO_LEVEL', 'debug'), // 日志级别
],
],
];

接着你需要将 default 修改为 mongodb,也可以修改 .env

return [
'default' => env('LOG_CHANNEL', 'mongodb'), // 我直接将默认值修改为 mongodb,也就是 channels 内新增的配置项。

// ...
]

0x02 实现

找个合适的位置(我使用 app/Logging)创建 CreateCustomLogger.php

use Monolog\Logger;
use Monolog\Handler\MongoDBHandler;
use Monolog\Processor\WebProcessor;

class CreateCustomLogger
{
/**
* Create a custom Monolog instance.
*
* @param array $config
* @return \Monolog\Logger
*/
public function __invoke(array $config)
{
$logger = new Logger(''); // 创建 Logger

$handler = new MongoDBHandler( // 创建 Handler
new \MongoDB\Client($config['server']), // 创建 MongoDB 客户端(依赖 mongodb/mongodb)
$config['database'],
$config['collection']
);

$handler->setLevel($config['level']);

$logger->pushHandler($handler); // 挂载 Handler
$logger->pushProcessor(new WebProcessor($_SERVER)); // 记录额外的请求信息

return $logger;
}
}

0x03 完成

好了,接下来可以执行 php artisan tinker,输入 Log::warning(...) 测试你的成果了。

别忘记把 MongoDB 服务启动。