codeless/logmore

Minimalist logging tool providing wrappers for openlog, closelog and syslog

This package's canonical repository appears to be gone and the package has been frozen as a result.

v0.9.0 2012-10-12 12:08 UTC

This package is not auto-updated.

Last update: 2023-09-16 08:13:13 UTC


README

The LogMore class is a minimalist PHP logging tool for versions >= PHP 5.2, that provides wrappers for the PHP functions openlog, closelog and syslog.

Usage example from within PHP

require('vendor/codeless/logmore/src/logmore.php');

# Opening of the log is not required, but recommended.
# Here you can pass an ident-string of your application,
# which makes filtering of the messages easier later on:
LogMore::open('nameOfApplication');

# Possible priorities for messages:
LogMore::emerg('a emergency message');
LogMore::alert('an alert message');
LogMore::crit('a critical message');
LogMore::err('an error message');
LogMore::warning('a warning');
LogMore::notice('a notice');
LogMore::info('a informative message');
LogMore::debug('a debug message');

# All messages are formated via (vs)printf,
# so the following is possible:
LogMore::debug('Variable $test is of type %s', gettype($test));

# The number of arguments to the logging functions
# is not restricted by LogMore:
LogMore::notice(
	'Message string coming from file %s at line %i ...',
	__FILE__,
	__LINE__,
	...);

# Disable logging:
LogMore::disable();
# Won't land in the logfile:
LogMore::debug('A debug message');

# Enable logging:
LogMore::enable();
# Will land in the logfile again:
LogMore::debug('Another debug message');

Using LogMore with the Unix/Linux tail-command works very well. While developing, catch the appendage to the logfile by entering the following command on the shell:

/usr/bin/tail -F /path/to/error.log

Multiple logs

LogMore prevents the usage of multiple logs with different idents. After LogMore::open has been called with the ident "x", LogMore will ignore any other call to open() if close() hasn't been called inbetween:

LogMore::open('ident1');
LogMore::open('ident2');
LogMore::debug('A message'); # Still logging with ident1!

LogMore::close(); # Closing ident1
LogMore::open('ident2');
LogMore::debug('A message'); # Logging with ident2!

Installation

Either install LogMore by downloading the src/logmore.php file or by using packagist/composer (see Resources-section).

Compiling

LogMore comes "compiled" already and is ready to be used in your PHP applications. If you want to modify LogMore, please take a look at the accompanied Makefile.

Documentation

Documentation is not included by default but can be compiled using Natural Docs. When you have Natural Docs installed, simply type

make doc

on your commandline in the root-directory of LogMore.

Resources

Ideas for improving LogMore

  • Enabling/disabling logging of individual priorities to reduce syslog()-calls

Credits and Bugreports

LogMore was written by Codeless (http://www.codeless.at/). All bugreports can be directed to more@codeless.at -- even better bugreports are posted on the github-repository of this package: https://www.github.com/codeless/logmore

License

This work is licensed under a Creative Commons Attribution 3.0 Unported License: http://creativecommons.org/licenses/by/3.0/deed.en_US