miladrahimi/phplogger

此包已被弃用,不再维护。未建议替代包。

免费PHP日志记录器,用于整洁且强大的项目!

1.6 2015-08-21 05:32 UTC

This package is auto-updated.

Last update: 2020-02-09 18:51:31 UTC


README

PHP项目的简单日志记录器

概述

PHP Logger 是一个简单的包,用于 PHP 开发者进行日志记录。它基于 PSR-3 标准实现。

安装

使用 Composer(推荐)

如果您不熟悉 Composer,请阅读 如何在 PHP 项目中使用 Composer 文章。

在您的项目根目录中运行以下命令

composer require miladrahimi/phplogger

手动

只要它遵循 PSR-0PSR-4 标准,您就可以使用自己的自动加载器。只需将 src 目录的内容放入您的 vendor 目录。

入门

PHPLogger 有潜力将日志存储到不同类型的存储中,但现在您只能使用目录(文件系统)来存储。以下代码说明了如何定义一个目录存储并将其注入到 Logger 类中

use MiladRahimi\PHPLogger\Logger;
use MiladRahimi\PHPLogger\Directory;

$dir = new Directory("./logs/");
$logger = new Logger($dir);

如上代码片段所示,您可以通过 Logger 构造函数注入存储,但如果您想使用更多存储,您也可以通过以下方法添加它们

$logger->addStorage($my_storage);

现在您可以存储您的第一个日志

$logger->alert("This is an alert!");

警告不仅支持开箱即用的日志级别,您可以在 PSR-3 页面上查看所有支持的日志级别。

日志方法

更广泛的方法是 Logger::log() 方法,该方法将日志级别作为其第一个参数捕获。以下示例显示了如何使用此方法

use MiladRahimi\PHPLogger\Logger;
use MiladRahimi\PHPLogger\Directory;

$directory = new Directory(__DIR__);
$logger = new Logger($directory);
$logger->log("alert", "This is an alert message!");

为了遵循标准,您可以使用由 PSR-3 标准提供的 LogLevel 常量。

use MiladRahimi\PHPLogger\Logger;
use MiladRahimi\PHPLogger\Directory;
use Psr\Log\LogLevel;

$logger = new Logger(new Directory(__DIR__));
$logger->log(LogLevel::ALERT, "This is an error message!");

上下文

上下文是 Logger::log() 方法的第三个参数,对于直接级别日志方法(如 Log::alert())是第二个参数。该参数可以是数组或对象,您可以使用它来存储与日志消息一起的更多详细信息。

许可证

PHPLogger 由 Milad Rahimi 创建,并使用 MIT 许可证 发布。