knowledge/docs/php/monolog-mongo.md

4.0 KiB
Raw Blame History

PHP实现把日志保存到mongodb中

monolog可以说是PHP中应用最为广泛的日志组件使用它可以方便的实现多种日志记录需求本文主要利用monologMongoDBHandler类,将日志保存至mongodb中。

环境

本文使用webman框架,用法基本与laravel大同小异。

准备工作

需要为php安装mongodb扩展

pecl install mongodb

也可以使用已经做好环境的docker镜像docker pull wandoubaba517/workerman:8.1

monolog版本要在3.0以上

先创建一个全新的webman项目:

composer create-project workerman/webman
cd webman

webman中默认已经内置了monolog,不过我们要确保monolog的版本要在3.0以上:

compose require monolog/monolog:^3.0

用docker快速启动一下mongodb服务

mkdir -p log/db
touch mongod.conf

mongod.conf文件中的内容类似下面的样子:

storage:
  dbPath: /data/db
net:
  port: 27017
  bindIp: 0.0.0.0

docker-compose.yml文件中添加log服务类似下面的样子把root和password换成你自己想要设置的

version: "3.1"

services:
  log:
    image: mongo:7.0
    container_name: mongodb-log
    restart: always
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: password
      MONGO_INITDB_DATABASE: log
    volumes:
      - ./log/db:/data/db
      - ./log/mongod.conf:/etc/mongod.conf
    network_mode: host
    command: ['mongod', '--config', '/etc/mongod.conf']

执行docker compose up -d就可以启动mongodb服务了。

引入mongodb/laravel-mongodb组件

composer require mongodb/laravel-mongodb

实现代码

config/database.php文件中配置mongodb连接

return [
    'default' => 'pgsql',
    'connections' => [
        'pgsql' => [
            /// ...
        ],
        'mongo' => [
            'driver'   => 'mongodb',
            'host'     => '127.0.0.1',
            'port'     => 27017,
            'database' => 'log',
            'username' => 'root',
            'password' => 'password',
            'options' => [
                'appname' => 'homestead'
            ],
        ],
        /// ...
    ]
];

config/log.php文件中配置日志通道

return [
    'mongo' => [
        'handlers' => [
            [
                'class' => Monolog\Handler\MongoDBHandler::class,
                'constructor' => [
                    new Mongodb\Client('mongodb://root:password@localhost:27017'),
                    'log',      // 数据库名
                    'default',  // 集合名(相当于表名)
                    Monolog\Level::Debug,   // 最低日志等级默认就是Debug
                ],
            ],
        ],
    ],
    /// ...
];

业务代码中应用

app/controller/IndexController.php中的log方法为例:

<?php

namespace app\controller;

use support\Request;
use support\Db;
use support\Log;

class IndexController
{
    public function log(Request $request)
    {
        // 随便记录点什么日志
        Log::channel('mongo')->info(__CLASS__ . DIRECTORY_SEPARATOR . __FUNCTION__, $request->all());
        $logs = Db::connection('mongo')->collection('default')->get();
        return json($logs);
    }
}

运行测试

启动服务,然后用浏览器或者接口调试工具访问http://IP:port/index/log,控制器方法会先记录一条日志,然后再把整所有已经保存的日志全部都输出回来。

与文本日志对比

主要优势方便查询文本日志文件的最小粒度是一天一个文件当日志量具大时在几百M或者几个G甚至更大的一个文本文件中定位某行记录简直就是灾难

主要劣势:需要自行处理过期记录(文本日志可以自动删除过期的文件)。

推荐

本文作者建好了一个开箱即用的webman+mongodb代码仓库https://git.wandoubaba.com/wandoubaba/docker-webman-mongolog