Articles that updated a long time ago may have already lost the technical merit. Please kindly pay attention while reading.

网上的文章普遍是 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 服务启动。