README

关于

loggy是一个简单的PHP日志类。

它可以帮助你将消息记录到文件中。

用法

初始化

首先，创建一些空白文件来存储日志。确保它们是可写的。

// Create a default version of loggy.
// default = $loggy->(TRUE, 20, 80, 'D F j, G:i:s T, Y', 'UTC);
$loggy = new loggy();

// Create a custom version of loggy.
$write_enabled = TRUE; // Enable writing to files.
$type_width = 30; // Width allocated to the message type.
$divider_width = 100; // Width allocated to the divider.
$date_format = 'D F j, G:i:s T'; // https://php.ac.cn/manual/en/function.date.php
$timezone_identifier = 'Asia/Toykyo'; // https://php.ac.cn/manual/en/timezones.php
$loggy = new loggy(
    $write_enabled,
    $type_width,
    $divider_width,
    $date_format,
    $timezone_identifier
);

// Options can also be set after initialization.
$loggy->write_enabled = FALSE;
$loggy->type_width = 35;
$loggy->divider_width = 50;
$loggy->date_format = 'D F j';
$loggy->timezone_identifier = 'UTC';

修改日志

// Add a message to the log.
$type = 'error';
$message = 'Parsing failed';
$loggy->add($type, $message);

// Clear the log.
$loggy->clear();

// Clear one type.
$loggy->clear('error');

// Clear many types.
$loggy->clear(array('error', 'feature', 'warning'));

返回日志信息

// Get the log.
$log = $loggy->get();

// Get one logged type.
$log = $loggy->get('error');

// Get many logged types.
$log = $loggy->get(array('error', 'feature', 'warning'));

// Count all the logged items.
$num_logged_items = $loggy->count();

// Count only one type of logged items.
$num_errors = $log = $loggy->count('error');

// Get many types of logged items,
$num_items = $loggy->count(array('error', 'feature', 'warning'));

将日志写入文件

// Write the entire logs at the end of the desired file.
$filename = 'logs.txt';
$loggy->write($filename);

// Write one type at the end of the desired file.
$filename = 'logs.txt';
$type = 'error';
$loggy->write($filename, $type);

// Write many types at the end of the desired file.
$filename = 'logs.txt';
$types = array('error', 'feature', 'warning');
$loggy->write($filename, $types);