File: ErrorStack.php

Source Location: /PEAR-1.7.2/PEAR/ErrorStack.php

Classes:

Error Stack Implementation

Page Details:

Error Stack Implementation

This is an incredibly simple implementation of a very complex error handling facility. It contains the ability to track multiple errors from multiple packages simultaneously. In addition, it can track errors of many levels, save data along with the error, context information such as the exact file, line number, class and function that generated the error, and if necessary, it can raise a traditional PEAR_Error. It has built-in support for PEAR::Log, to log errors as they occur

Since version 0.2alpha, it is also possible to selectively ignore errors, through the use of an error callback, see pushCallback()

Since version 0.3alpha, it is possible to specify the exception class returned from push()

Since version PEAR1.3.2, ErrorStack no longer instantiates an exception class. This can still be done quite handily in an error callback or by manipulating the returned array

Author: Greg Beaver <cellog@php.net>
Version: CVS: $Id: ErrorStack.php,v 1.28 2008/01/03 20:26:35 cellog Exp $
Copyright: 2004-2008 Greg Beaver
Link: http://pear.php.net/package/PEAR_ErrorStack
License: PHP License 3.0

PEAR_ERRORSTACK_DIE [line 110]

PEAR_ERRORSTACK_DIE = 5

If this is returned, then the error is logged and die() is called.

One of four possible return values from the error Callback

See: PEAR_ErrorStack::_errorCallback()

[ Top ]

PEAR_ERRORSTACK_ERR_NONCLASS [line 117]

PEAR_ERRORSTACK_ERR_NONCLASS = 1

Error code for an attempt to instantiate a non-class as a PEAR_ErrorStack in the singleton method.

[ Top ]

PEAR_ERRORSTACK_ERR_OBJTOSTRING [line 123]

PEAR_ERRORSTACK_ERR_OBJTOSTRING = 2

Error code for an attempt to pass an object into PEAR_ErrorStack::getMessage()

that has no __toString() method

[ Top ]

PEAR_ERRORSTACK_IGNORE [line 106]

PEAR_ERRORSTACK_IGNORE = 4

If this is returned, then the error is completely ignored.

One of four possible return values from the error Callback

See: PEAR_ErrorStack::_errorCallback()

[ Top ]

PEAR_ERRORSTACK_LOG [line 102]

PEAR_ERRORSTACK_LOG = 3

If this is returned, then the error will only be logged, but not pushed onto the error stack.

One of four possible return values from the error Callback

See: PEAR_ErrorStack::_errorCallback()

[ Top ]

PEAR_ERRORSTACK_PUSH [line 97]

PEAR_ERRORSTACK_PUSH = 2

If this is returned, then the error will only be pushed onto the stack, and not logged.

One of four possible return values from the error Callback

See: PEAR_ErrorStack::_errorCallback()

[ Top ]

PEAR_ERRORSTACK_PUSHANDLOG [line 92]

PEAR_ERRORSTACK_PUSHANDLOG = 1

If this is returned, then the error will be both pushed onto the stack and logged.

One of four possible return values from the error Callback

See: PEAR_ErrorStack::_errorCallback()

[ Top ]