detain/monolog-mydb

用于将Monolog消息发送到MySQL的处理程序

v3.0.0 2019-11-05 18:54 UTC

This package is auto-updated.

Last update: 2024-09-03 09:50:38 UTC


README

MySQL Handler for Monolog,允许将日志消息存储在MySQL表中。它可以记录文本消息到特定的表,如果不存在,则自动创建表。该类还允许动态添加额外属性,这些属性存储在单独的数据库字段中,可用于后续分析和排序。

寻求帮助

由于我不再使用这个项目,也没有时间像应该的那样维护这个项目,所以我很高兴地找到一个愿意接管它的人。如果您有兴趣接管这个项目,请通过danielherrmann+gitlab@posteo.de与我联系。谢谢!

安装

monolog-mysql可以通过composer获取。只需将以下行添加到composer.json中所需部分,并执行php composer.phar update

"wazaari/monolog-mysql": ">1.0.0"

使用

就像使用其他Monolog处理程序一样使用它,将其推送到Monolog Logger实例的堆栈中。然而,处理程序需要一些参数

  • $pdo 数据库的PDO实例。传递数据库连接的PDO实例,确保已选择数据库。
  • $table 应存储日志的表名
  • $additionalFields 简单数组,包含要存储在数据库中的额外数据库字段。列将自动创建,字段可以稍后用于记录的额外上下文部分。请参阅下面的示例。默认为空数组
  • $level 可以是任何标准Monolog日志级别。使用Monolog静态定义的上下文。默认为Logger::DEBUG
  • $bubble 默认为true
  • $skipDatabaseModifications 定义是否应跳过同步当前数据库状态与代码请求的任何尝试(包括创建表和添加/删除字段)。默认为false

如果将$skipDatabaseModifications设置为true,请使用以下查询模板创建日志表(如果需要,包括额外字段)

CREATE TABLE `log` (
    id BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, channel VARCHAR(255), level INTEGER, message LONGTEXT, time INTEGER UNSIGNED, INDEX(channel) USING HASH, INDEX(level) USING HASH, INDEX(time) USING BTREE
)

示例

假设$pdo是您的数据库实例,您可以使用类如下所示

//Import class
use MySQLHandler\MySQLHandler;

//Create MysqlHandler
$mySQLHandler = new MySQLHandler($pdo, "log", array('username', 'userid'), \Monolog\Logger::DEBUG);

//Create logger
$logger = new \Monolog\Logger($context);
$logger->pushHandler($mySQLHandler);

//Now you can use the logger, and further attach additional information
$logger->addWarning("This is a great message, woohoo!", array('username'  => 'John Doe', 'userid'  => 245));

许可证

此工具是免费软件,并按MIT许可证分发。请查阅LICENSE文件以获取更多信息。