README

关于

KLogger是一个易于使用的PHP日志类，遵循PSR-3规范。它不会对文件权限做出无知的假设（这是预期的）。它旨在是一个可以快速加入到项目中并立即工作的类。

安装

Composer

通过命令行

composer require katzgrau/klogger:1.0.*

在您的composer.json文件中

{
    "require": {
        "katzgrau/klogger": "1.0.*"
    }
}

基本用法

<?php

require 'vendor/autoload.php';

$users = [
    [
        'name' => 'Kenny Katzgrau',
        'username' => 'katzgrau',
    ],
    [
        'name' => 'Dan Horrigan',
        'username' => 'dhrrgn',
    ],
];

$logger = new Katzgrau\KLogger\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' => 'Kenny Katzgrau',
        'username' => 'katzgrau',
    )
    1: array(
        'name' => 'Dan Horrigan',
        'username' => 'dhrrgn',
    )

遵循PSR-3规范

KLogger遵循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 Katzgrau\KLogger\Logger('/var/log/', Psr\Log\LogLevel::WARNING);
$logger->error('Uh Oh!'); // Will be logged
$logger->info('Something Happened Here'); // Will be NOT logged

为什么使用KLogger？

为什么不试试呢？只需将其添加进来即可。如果它能节省您的时间并满足您的需求，那就试试吧！引用我们C代码之父的书中的一句话：“构建在别人的工作上”。

谁使用KLogger？

Klogger已经被用于以下项目的开发中

* The University of Iowa
* The University of Laverne
* The New Jersey Institute of Technology
* Middlesex Hospital in NJ

此外，它已被用于许多商业和个人项目。

特别感谢

特别感谢所有贡献者

许可

MIT许可

版权（c）2008-2014 Kenny Katzgrau katzgrau@gmail.com

在此特此授予任何获得此软件及其相关文档文件（“软件”）副本的任何人，免费使用该软件的权利，不受限制，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利，并允许向提供软件的人授予此类权利，前提是遵守以下条件

flock3/ klogger

维护者

详细信息