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.
-
getMessageForException() protected
Generate the message for the exception
-
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
string_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\Http\ServerRequest $request): stringGet the request context for an error/exception trace.
Parameters
-
Cake\Http\ServerRequest$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
voidgetMessageForException() ¶ protected
getMessageForException(Exception $exception, bool $isPrevious = false): stringGenerate the message for the exception
Parameters
-
Exception$exception The exception to log a message for.
-
bool$isPrevious optional False for original exception, true for previous
Returns
stringhandleError() ¶ 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 mode is on. And will log errors to Log, when debug mode is off.
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
boolhandleException() ¶ 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(int $additionalKb): voidIncreases the PHP "memory_limit" ini setting by the specified amount in kilobytes
Parameters
-
int$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
arraywrapAndHandleException() ¶ public
wrapAndHandleException(ExceptionError $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
-
ExceptionError$exception The exception to handle
Returns
void