PEAR_ErrorStack improvements

Introduction

PEAR_ErrorStack with its great features, is still young and could be improved again. It has built-in support for PEAR::Log, to log errors as they occur. It's a very cool feature, but sometimes developpers have already a own logging system, and they can't plug-in PEAR_ErrorStack without coding again the Log interface.

With this proposal, we could used PEAR_ErrorStack with all Loggers: PEAR::Log or a private system.

• [1] improves of PEAR_ErrorStack (from PEAR 1.3.3.1)
• [2] example of a private error handler (myPHPLogger class) using only PHP functions
• [3] PEAR_ErrorStack using a custom error handler
• [4] Download all source codes

2004-12-21: feature added to allows to log an error and halt a script easily. The new bundle available to download is PEAR_ErrorStack-1.4.0dev3.tgz

2004-11-29: fixed some minor errors with myPHPLogger.php. The new bundle available to download is PEAR_ErrorStack-1.4.0dev2.tgz

Changes on PEAR_ErrorStack

NOTE: lines number striked are related to PEAR_ErrorStack-1.4.0dev2.tgz (previous proposal)

Have a look on source code [1]; functions modified are :

• setDefaultLogger, lines 310 to 317 315 to 322
• setLogger, lines 323 to 330 328 to 335
• setContextCallback, line 391 396 (i don't think the 'return' is necessary here, i've removed it !)
• _log, lines 638 to 672 650 to 684
• PEAR_ERRORSTACK_DIE, lines 125 to 128, line 554, lines 583 to 585, and lines 598 to 600

The setDefaultLogger and setLogger methods allows now to defines any valid callback, AND NO MORE only a PEAR::Log object.
A valid callback is:

• a function, with a pear_errorstack error array as parameter
• a log class-method, with a pear_errorstack error array as parameter
• a PEAR::Log object

The _log method, allows now to log error message with PEAR::Log 1.8.7 (1.9.0, not yet released, because requires my hack: see cvs http://cvs.php.net/co.php/pear/Log/Log.php?r=1.46).

Example of private error logging system with only PHP functions

Have a look on source code [2]. The class is defined on lines 11 to 110. A new instance is created on line 113 with all default options, and on lines 116 to 122, we've created a custom configuration. Logging errors (display, and file ) occurs only if php.ini directives are set to '1' (see lines 58, 59).

The new PEAR_ErrorStack unit test

Have a look on source code [3]. This example will use the new version of PEAR_ErrorStack with:

• a global error handler: see lines 29 to 39 and 49, 50; to produces warning MYPACKAGE_ERROR_NOFILE
• a local error handler (myPHPLogger with default options): see line 61; to produces critical error MYPACKAGE_ERROR_DBCRIT
• a local error handler (myPHPLogger with custom options): see line 72; to produces debug info MYPACKAGE_DEBUG_ERRORHANDLING