Class ConsoleErrorHandler
Error Handler for Cake console. Does simple printing of the exception that occurred and the stack trace of the error.
Property Summary
Method Summary
-
__construct() public
Constructor
-
_displayError() protected
Prints an error to stderr.
-
_displayException() protected
Prints an exception to stderr.
-
_getMessage() protected
Generates a formatted error message
-
_logError() protected
Log an error.
-
_logException() protected
Handles exception logging
-
_requestContext() protected
Get the request context for an error/exception trace.
-
_stop() protected
Stop the execution and set the exit code for the process.
-
handleError() public
Set as the default error handler by CakePHP.
-
handleException() public
Handle errors in the console environment. Writes errors to stderr, and logs messages if Configure::read('debug') is false.
-
handleFatalError() public
Display/Log a fatal error.
-
increaseMemoryLimit() public
Increases the PHP "memory_limit" ini setting by the specified amount in kilobytes
-
mapErrorCode() public static
Map an error code into an Error word, and log location.
-
register() public
Register the error and exception handlers.
-
wrapAndHandleException() public
Checks the passed exception type. If it is an instance of
Errorthen, it wraps the passed object inside another Exception object for backwards compatibility purposes.
Method Detail
__construct() ¶ public
__construct(array $options = [])Constructor
Parameters
-
array$options optional Options for the error handler.
_displayError() ¶ protected
_displayError(array $error, bool $debug): voidPrints an error to stderr.
Template method of BaseErrorHandler.
Parameters
-
array$error An array of error data.
-
bool$debug Whether or not the app is in debug mode.
Returns
void_displayException() ¶ protected
_displayException(Exception $exception): voidPrints an exception to stderr.
Subclasses should implement this method to display an uncaught exception as desired for the runtime they operate in.
Parameters
-
Exception$exception The exception to handle
Returns
void_getMessage() ¶ protected
_getMessage(Exception $exception): stringGenerates a formatted error message
Parameters
-
Exception$exception Exception instance
Returns
stringFormatted message
_logError() ¶ protected
_logError(string $level, array $data): boolLog an error.
Parameters
-
string$level The level name of the log.
-
array$data Array of error data.
Returns
bool_logException() ¶ protected
_logException(Exception $exception): boolHandles exception logging
Parameters
-
Exception$exception Exception instance.
Returns
bool_requestContext() ¶ protected
_requestContext(Cake\Network\Request $request): stringGet the request context for an error/exception trace.
Parameters
-
Cake\Network\Request$request The request to read from.
Returns
string_stop() ¶ protected
_stop(int $code): voidStop the execution and set the exit code for the process.
Implemented in subclasses that need it.
Parameters
-
int$code The exit code.
Returns
voidhandleError() ¶ public
handleError(int $code, string $description, string|null $file = null, int|null $line = null, array|null $context = null): boolSet as the default error handler by CakePHP.
Use config/error.php to customize or replace this error handler. This function will use Debugger to display errors when debug > 0. And will log errors to Log, when debug == 0.
You can use the 'errorLevel' option to set what type of errors will be handled. Stack traces for errors can be enabled with the 'trace' option.
Parameters
-
int$code Code of error
-
string$description Error description
-
string|null$file optional File on which error occurred
-
int|null$line optional Line that triggered the error
-
array|null$context optional Context
Returns
boolTrue if error was handled
handleException() ¶ public
handleException(Exception $exception): voidHandle errors in the console environment. Writes errors to stderr, and logs messages if Configure::read('debug') is false.
Uses a template method provided by subclasses to display errors in an environment appropriate way.
Parameters
-
Exception$exception Exception instance.
Returns
voidThrows
ExceptionWhen renderer class not found
See Also
handleFatalError() ¶ public
handleFatalError(int $code, string $description, string $file, int $line): boolDisplay/Log a fatal error.
Parameters
-
int$code Code of error
-
string$description Error description
-
string$file File on which error occurred
-
int$line Line that triggered the error
Returns
boolincreaseMemoryLimit() ¶ public
increaseMemoryLimit(string $additionalKb): voidIncreases the PHP "memory_limit" ini setting by the specified amount in kilobytes
Parameters
-
string$additionalKb Number in kilobytes
Returns
voidmapErrorCode() ¶ public static
mapErrorCode(int $code): arrayMap an error code into an Error word, and log location.
Parameters
-
int$code Error code to map
Returns
arrayArray of error word, and log location.
wrapAndHandleException() ¶ public
wrapAndHandleException(Exception|Error $exception): voidChecks the passed exception type. If it is an instance of Error
then, it wraps the passed object inside another Exception object
for backwards compatibility purposes.
Parameters
-
Exception|Error$exception The exception to handle
Returns
void