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
-
_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.
-
mapErrorCode() public static
Map an error code into an Error word, and log location.
-
register() public
Register the error and exception handlers.
Method Detail
__construct() ¶ public
__construct(array $options = [])
Constructor
Parameters
-
array
$options optional Options for the error handler.
_displayError() ¶ protected
_displayError(array $error, bool $debug): void
Prints 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): void
Prints 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): string
Generates a formatted error message
Parameters
-
Exception
$exception Exception instance
Returns
string
_logError() ¶ protected
_logError(string $level, array $data): bool
Log an error.
Parameters
-
string
$level The level name of the log.
-
array
$data Array of error data.
Returns
bool
_logException() ¶ protected
_logException(Exception $exception): bool
Handles exception logging
Parameters
-
Exception
$exception Exception instance.
Returns
bool
_stop() ¶ protected
_stop(int $code): void
Stop the execution and set the exit code for the process.
Implemented in subclasses that need it.
Parameters
-
int
$code The exit code.
Returns
void
handleError() ¶ public
handleError(int $code, string $description, string|null $file = null, int|null $line = null, array|null $context = null): bool
Set 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
bool
handleException() ¶ public
handleException(Exception $exception): void
Handle 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
void
Throws
Exception
When renderer class not found
See Also
handleFatalError() ¶ public
handleFatalError(int $code, string $description, string $file, int $line): bool
Display/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
bool
mapErrorCode() ¶ public static
mapErrorCode(int $code): array
Map an error code into an Error word, and log location.
Parameters
-
int
$code Error code to map
Returns
array