MyLogPHP

MyLogPHP is a single PHP class to easily keep log files in CSV format.

Download the latest version

MyLogPHP.class.php (1.2.5)

Any CSV reader can be used to open the generated logs, but If you need a recomendation, try the CSVFileView or LogExpert. Both can parse/show the CSV columns and watch realtime changes in log file (like tail on Linux).

Features

• One single file to rule them all!
• Super easy start.
• Two extra columns are automatically added in the CSV: the number of execution line and the path of host script where the log was called.
• Minimum PHP version: 5.1

Want more features? I am listening!

Create an issue in https://github.com/llagerlof/MyLogPHP/issues/new

Quick start

Include in your script the file "MyLogPHP.class.php".

include('MyLogPHP.class.php');

Instantiate the object. Optionally you can pass the log file name and the separator as a parameter. Default log file name is "_MyLogPHP-1.2.log.csv" in current folder, and default separator is comma (,).

$log = new MyLogPHP('./log/debug.log.csv');

Make sure the directory where the log will be created is writable.

Call method "info", "warning", "error" or "debug" to write the messages. The first parameter is the message, the optional second parameter is a free tag at your choice to help you filter the log when opened by an spreadsheet software, like OpenOffice Calc or Microsoft Excel.

$log->info('This message will be logged in the file debug.log.csv','TIP');

That's it!

Examples

$log = new MyLogPHP();

$log->info('The program starts here.');

$log->warning('This problem can affect the program logic');

$log->warning('Use this software at your own risk!');

$log->info('Lawrence Lagerlof','AUTHOR');

$log->info('Asimov rulez','FACT');

$log->error('Everything crash and burn','IE');

$log->debug("select * from table",'DB');

Changelog

1.2.5

• Solved a bug that was preventing the replacement of consecutives spaces and tabs for one space.

1.2.4

• All consecutives spaces and tabs are removed from output.

1.2.3

• PHPDOC comment style applied to the class.
• An issue with the newer version of PHP and the date() function was solved.

1.2.2

• Line breaks of VALUE field are converted to spaces to prevent some CSV readers wrongly interpret line breaks as new CSV lines.
• The VALUE field now is trimmed before output.

1.2.1

• Disable a warning message if an internal variable is not set.

1.2

• Two columns added in CSV output: LINE and FILE.

1.1

• Added support to choose the field separator. Comma is still the default.