Skip to content

Latest commit

 

History

History
173 lines (103 loc) · 3.51 KB

README.md

File metadata and controls

173 lines (103 loc) · 3.51 KB
Raw

\Log\Beffered

NAME

\Log\Buffered -

SYNOPSIS

// Load the dependencies first
require_once '/path/to/Term/ANSIColor.php';
require_once '/path/to/Log/Minimal.php'

require_once '/path/to/Log/Buffered.php';

$log = new \Log\Buffered(
    array(
        'buffer_size' => 10240, // 5120 bytes by default
    )
);
$log->debugf('This is a %s message: %s', 'debug'); // This message never be output
$log->infof('This is an %s message: %s', 'info');
$log->warnf('This is a %s message: %s', 'warn');
$log->critf('This is a %s message: %s', 'crit');

DEPENDENCIES

\Log\Buffered has the dependency on the following:

METHODS

__construct

__constract(array $attrs)

Parameters

$attrs can contain the keys below:

file

Path to a file into which logger writes.

color

Outputs colored messages if set a true value, false by default.

debug

Outputs debug messages if set a true value, false by default.

log_level

The lower limit of the log level. info by default. NOTE: To output debug messages set debug to log_level and a true value to debug.

trace_level

The depth of stack trace. 1 by default.

buffer_size

Set the size of buffer which allow to buffer messages within given size. 5120 bytes by default. You must specify this between \Log\Buffered::MIN_BUFFER_SIZE and \Log\Buffered::MAX_BUFFER_SIZE, or an Exception will be thrown.

debugf

void debugf(string $format [, mixed $val [, mixed ...]])

infof

void infof(string $format [, mixed $val [, mixed ...]])

warnf

void infof(string $format [, mixed $val [, mixed ...]])

critf

void infof(string $format [, mixed $val [, mixed ...]])

These methods above buffer messages until buffered messages reach buffer_size you specified. If you try to buffer messages more than buffer_size the logger will flush buffered messages automatically with the caution below.

***************************** CAUTION!!! **********************************
Flush the buffer, because the size of buffered messages reached 1024.
If you want to buffer more messages, set the more large size to buffer_size
in the constructor or by calling \Log\Buffered::setBufferSize().

Parameters

The same as the built-in function sprintf.

append

void append(string $message)

Append a given message to the buffer. Usually you don't have to use this directly.

Parameters

$message

A string to be buffered.

flush

void flush(void)

Flush buffered messages.

clear

void clear(void)

Clear the buffer.

getMinBufferSize

int getMinBufferSize(void)

Returns the size of min buffer size 1024 bytes.

getMaxBufferSize

int getMaxBufferSize(void)

Returns the size of max buffer size 5120000 bytes.

getBufferedSize

int getBufferedSize(void)

Returns the size of buffered messages.

ENABLING DEBUG MESSAGES

There are two ways to enable debug messages:

  1. By Environment Values
  2. By Constructor

By Environment Values

$_SERVER['LM_DEBUG']     = true;
$_SERVER['LM_LOG_LEVEL'] = 'debug';
$log = new \Log\Buffered();
$log->debugf('This is a %s message: %s', 'debug');

By Constructor

$log = new \Log\Buffered(
    array(
        'debug'     => true,
        'log_level' => 'debug',
    )
);
$log->debugf('This is a %s message: %s', 'debug');

AUTHOR

travail

LICENSE

This library is free software. You can redistribute it and/or modify it under the same terms as PHP itself.