liberta/logger

一个简单的日志系统

2.0 2015-06-05 15:19 UTC

This package is not auto-updated.

Last update: 2024-10-02 09:36:36 UTC


README

Paul Coifier 创建的项目。

关于

Liberta-Logger 是一个易于使用的符合 PSR-3 的 PHP 日志类。它不会对文件权限过于天真(这是预期的)。它旨在成为一个可以快速包含到项目中并立即开始工作的类。

如果您需要一个支持 PHP < 5.3 的日志记录器。

安装

Composer

从命令行

composer require liberta\logger:dev-master

在您的 composer.json

{
    "require": {
        "liberta/logger": "dev-master"
    }
}

基本用法

<?php

require 'vendor/autoload.php';

$users = [
    [
        'name' => 'Paul Coiffier',
        'username' => 'pcoiffier',
    ],
    [
        'name' => 'Audrey Dupont',
        'username' => 'adupont',
    ],
];

$logger = new Liberta\Logger\Logger(__DIR__.'/logs');
$logger->info('Returned a million search results');
$logger->error('Oh dear.');
$logger->debug('Got these users from the Database.', $users);

输出

[2014-03-20 3:35:43.762437] [INFO] Returned a million search results
[2014-03-20 3:35:43.762578] [ERROR] Oh dear.
[2014-03-20 3:35:43.762795] [DEBUG] Got these users from the Database.
    0: array(
        'name' => 'Paul Coiffier',
        'username' => 'coiffierp',
    )
    1: array(
        'name' => 'Michel Dupont',
        'username' => 'mdup',
    )

PSR-3 兼容

Liberta-Logger 是 PSR-3 兼容的。这意味着它实现了 Psr\Log\LoggerInterface

请在此处查看接口定义。

设置日志级别阈值

您可以使用 Psr\Log\LogLevel 常量来设置日志级别阈值,这样任何低于该级别的消息都不会被记录。

默认级别

默认级别是 DEBUG,这意味着所有内容都将被记录。

可用级别

<?php
use Psr\Log\LogLevel;

// These are in order of highest priority to lowest.
LogLevel::EMERGENCY;
LogLevel::ALERT;
LogLevel::CRITICAL;
LogLevel::ERROR;
LogLevel::WARNING;
LogLevel::NOTICE;
LogLevel::INFO;
LogLevel::DEBUG;

示例

<?php
// The 
$logger = new Liberta\Logger\Logger('/var/log/', Psr\Log\LogLevel::WARNING);
$logger->error('Uh Oh!'); // Will be logged
$logger->info('Something Happened Here'); // Will be NOT logged

附加选项

MLogger 通过构造函数中的第三个参数支持附加选项

<?php
// Example
$logger = new Liberta\Llogger\Logger('/var/log/', Psr\Log\LogLevel::WARNING, array (
    'extension' => 'log', // changes the log file extension
));

以下是完整列表

许可

MIT 许可证

版权(c)2015 Paul Coiffier coiffier.paul@gmail.com 版权(c)2008-2014 Kenny Katzgrau katzgrau@gmail.com

特此授予任何人获得此软件及其相关文档文件(“软件”)副本的权利,免费使用软件,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本,并允许向软件提供者提供软件的人这样做,前提是受以下条件约束

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“现状”提供,不提供任何形式的质量保证,明示或暗示的保证,包括但不限于适销性、针对特定目的的适用性和非侵权性保证。在任何情况下,作者或版权所有者不对任何索赔、损害或其他责任负责,无论此类索赔、损害或其他责任是基于合同、侵权或其他方式,与软件或软件的使用或其他交易有关。