Logging With PHP - Turning Up The Heat

(Page 4 of 9 )

If the thought of rolling your own code doesn't appeal to you, you can also use PHP's built-in error_log() function, which logs data both to a file and elsewhere. The error_log() function needs a minimum of two arguments: the error message to be logged, and an integer indicating where the message should be sent. There are three possible integer values in PHP 4.x:

0 - send the message to the system logger ("syslogd" on *NIX, and the Event Log on Windows NT);

1 - send the message to the specified email address;

3 - send the message to the specified file;

Here's a trivial example which demonstrates how this works:

<?php
// set a variable
$temp = 101.6;
// test it and log an error
// this will only work if 
// you have "log_errors" and "error_log" set in your php.ini file if
($temp > 98.6) {
error_log("Body temperature above normal.", 0);
}
?>

Now, if you look at the system log file after running the script, you'll see something like this:

[28-Feb-2002 15:50:49] Body temperature above normal.

You can also write the error message to a file,

<?php
// set a variable
$temp = 101.6;
// test it and log an error
if ($temp > 98.6)
{
error_log("Body temperature above normal.", 3, "a.out");
}
?>

or send it out as email.

<?php
// set a variable
$temp = 101.6;
// test it and log an error
if ($temp > 98.6)
{
error_log("Body temperature above normal.", 1,
"administrator@this.body.com"); }
?>

It's possible to combine this error logging facility with a custom error handler to ensure that all script errors get logged to a file. Here's an example which demonstrates this:

<?php
// custom handler
function eh($type, $msg, $file, $line)
{
// log all errors
error_log("$msg (error type $type)", 0);
// if fatal error, die()
if ($type == E_USER_ERROR)
{
die($msg);
}
}
// report all errors
error_reporting(E_ALL);
// define custom handler
set_error_handler("eh");
// let's now write some bad code
// this will trigger a warning, since the file doesn't exist
include("common.php"); ?>

And here's the output that gets logged to the system log file:

[28-Feb-2002 16:15:06] Failed opening 'common.php' for inclusion
(include_path='.;') (error type 2)

Next: Biting Into A PEAR >>
 

More PHP Articles
More By icarus, (c) Melonfire

Comments On: Logging With PHP

· I like the simple example that loggs to a file and with a small modification, we can...    · This is a great stuff...But how can we make the log file thus created write...    · This should do it:[code]function log_action($msg) { $today =...    · This should do it:[code]function log_action($msg) { $today =...   >>> Post your comment now!