add error codes to be ingored
boolean
addIgnore
(mixed $codes)
-
mixed
$codes: either an array of error code or a single code that will be ignored in future
empty list of errors to be ignored
boolean
clearExpect
()
empty list of errors to be ignored
boolean
clearIgnore
()
retrieves the current error handling settings for the specified error level.
array
getErrorHandling
(int $level)
-
int
$level: The error level to retrieve. This can be any of PHP's own error levels, e.g. E_ALL, E_NOTICE...
recieve all registerd error codes that will be ignored
array
getExpect
()
recieve all registerd error codes that will be ignored
array
getIgnore
()
method for checking whether the return value of a pat application method is a pat error object.
boolean
isError
(mixed &$object)
remove top of error-codes from stack
boolean
popExpect
()
add expected errors to stack
boolean
pushExpect
(mixed $codes)
-
mixed
$codes: either an array of error code or a single code that will be ignored in future
creates a new patError object given the specified information.
mixed
&raise
(int $level, string $code, string $msg, [mixed $info = null])
-
int
$level: The error level - use any of PHP's own error levels for this: E_ERROR, E_WARNING, E_NOTICE, E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE.
-
string
$code: The application-internal error code for this error
-
string
$msg: The error message, which may also be shown the user if need be.
-
mixed
$info: Optional: Additional error information (usually only developer-relevant information that the user should never see, like a database DSN).
wrapper for the raise() method where you do not have to specify the error level - a patError object with error level E_ERROR will be returned.
object
&raiseError
(string $code, string $msg, [mixed $info = null])
-
string
$code: The application-internal error code for this error
-
string
$msg: The error message, which may also be shown the user if need be.
-
mixed
$info: Optional: Additional error information (usually only developer-relevant information that the user should never see, like a database DSN).
wrapper for the raise() method where you do not have to specify the error level - a patError object with error level E_NOTICE will be returned.
object
&raiseNotice
(string $code, string $msg, [mixed $info = null])
-
string
$code: The application-internal error code for this error
-
string
$msg: The error message, which may also be shown the user if need be.
-
mixed
$info: Optional: Additional error information (usually only developer-relevant information that the user should never see, like a database DSN).
wrapper for the raise() method where you do not have to specify the error level - a patError object with error level E_WARNING will be returned.
object
&raiseWarning
(string $code, string $msg, [mixed $info = null])
-
string
$code: The application-internal error code for this error
-
string
$msg: The error message, which may also be shown the user if need be.
-
mixed
$info: Optional: Additional error information (usually only developer-relevant information that the user should never see, like a database DSN).
register a new error level
This allows you to add custom error levels to the built-in
- E_NOTICE
- E_WARNING
- E_NOTICE
You may use this level in subsequent calls to raise(). Error handling will be set to 'ignore' for the new level, you may change it by using setErrorHandling().
You could be using PHP's predefined constants for error levels or any other integer value.
boolean
registerErrorLevel
(integer $level, string $name)
-
integer
$level: error level
-
string
$name: human-readable name
removeIgnore
boolean
removeIgnore
(mixed $codes)
setErrorClass
In order to autoload this class, the filename containing that class must be named like the class itself; with an appending ".php". Although the file must be stored in the same directory as patErrorManager.php (this file)
boolean
setErrorClass
(string $name)
sets the way the patErrorManager will handle teh different error levels. Use this if you want to override the default settings.
Error handling modes:
- ignore
- trigger
- verbose
- echo
- callback
- die
You may also set the error handling for several modes at once using PHP's bit operations. Examples:
- E_ALL = Set the handling for all levels
- E_ERROR | E_WARNING = Set the handling for errors and warnings
- E_ALL ^ E_ERROR = Set the handling for all levels except errors
mixed
setErrorHandling
(int $level, string $mode, [mixed $options = null])
-
int
$level: The error level for which to set the error handling
-
string
$mode: The mode to use for the error handling.
-
mixed
$options: Optional: Any options needed for the given mode.
translate an error level
returns the human-readable name for an error level, e.g. E_ERROR will be translated to 'Error'.
string
translateErrorLevel
(integer $level)
-
integer
$level: error level