Error Handler provides basic error and exception handling for your application. It captures and handles all unhandled exceptions and errors. Displays helpful framework errors when debug mode is on.
When debug mode is off a ExceptionRenderer will render 404 or 500 errors. If an uncaught exception is thrown and it is a type that ExceptionRenderer does not know about it will be treated as a 500 error.
You can implement application specific exception handling in one of a few ways. Each approach gives you different amounts of control over the exception handling process.
exceptionRenderer
option to inject an Exception renderer. This will let you keep the existing handling logic but override the rendering logic.This gives you full control over the exception handling process. The class you choose should be loaded in your config/error.php and registered as the default exception handler.
exceptionRenderer
If you don't want to take control of the exception handling, but want to change how exceptions are rendered you can use exceptionRenderer
option to choose a class to render exception pages. By default Cake\Error\ExceptionRenderer
is used. Your custom exception renderer class should be placed in src/Error.
Your custom renderer should expect an exception in its constructor, and implement a render method. Failing to do so will cause additional errors.
Using the built-in exception handling, you can log all the exceptions that are dealt with by ErrorHandler by setting log
option to true in your config/error.php. Enabling this will log every exception to Log and the configured loggers.
Error handler also provides the built in features for handling php errors (trigger_error). While in debug mode, errors will be output to the screen using debugger. While in production mode, errors will be logged to Log. You can control which errors are logged by setting errorLevel
option in config/error.php.
When ErrorHandler is used for handling errors, you can enable error logging by setting the log
option to true. This will log all errors to the configured log handlers.
You can control which errors are logged / displayed by ErrorHandler by setting errorLevel
. Setting this to one or a combination of a few of the E_* constants will only enable the specified errors:
$options['errorLevel'] = E_ALL & ~E_NOTICE;
Would enable handling for all non Notice errors.
array
Runtime config
bool
Whether the config property has already been configured with defaults
array
Options to use for the Error handling.
bool
\Cake\Error\ErrorLoggerInterface|null
Exception logger instance.
Merge provided config with existing config. Unlike config()
which does a recursive merge for nested keys, this method does a simple merge.
Increases the PHP "memory_limit" ini setting by the specified amount in kilobytes
Checks 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.
__construct(array $config)
Constructor
array
$config optional The options for error handling.
_configDelete(string $key)
Deletes a single config key.
string
$key Key to delete.
Cake\Core\Exception\Exception
_configRead(?string $key)
Reads a config key.
string|null
$key Key to read.
mixed
_configWrite(mixed $key, mixed $value, mixed $merge)
Writes a config key.
string|array
$key Key to write to.
mixed
$value Value to write.
bool|string
$merge optional True to merge recursively, 'shallow' for simple merge, false to overwrite, defaults to false.
Cake\Core\Exception\Exception
_displayError(array $error, bool $debug)
Display an error.
Template method of BaseErrorHandler.
array
$error An array of error data.
bool
$debug Whether or not the app is in debug mode.
_displayException(\Throwable $exception)
Displays an exception response body.
\Throwable
$exception The exception to display.
Exception
_logError(mixed $level, array $data)
Log an error.
int|string
$level The level name of the log.
array
$data Array of error data.
bool
_logInternalError(\Throwable $exception)
Log internal errors.
\Throwable
$exception Exception.
_sendResponse(mixed $response)
Method that can be easily stubbed in testing.
string|\Cake\Http\Response
$response Either the message or response object.
_stop(int $code)
Stop the process.
Implemented in subclasses that need it.
int
$code Exit code.
configShallow(mixed $key, mixed $value)
Merge provided config with existing config. Unlike config()
which does a recursive merge for nested keys, this method does a simple merge.
Setting a specific value:
$this->configShallow('key', $value);
Setting a nested value:
$this->configShallow('some.nested.key', $value);
Updating multiple config settings at the same time:
$this->configShallow(['one' => 'value', 'another' => 'value']);
string|array
$key The key to set, or a complete array of configs.
mixed|null
$value optional The value to set.
$this
getConfig(?string $key, mixed $default)
Returns the config.
Reading the whole config:
$this->getConfig();
Reading a specific value:
$this->getConfig('key');
Reading a nested value:
$this->getConfig('some.nested.key');
Reading with default value:
$this->getConfig('some-key', 'default-value');
string|null
$key optional The key to get or null for the whole config.
mixed
$default optional The return value when the key does not exist.
mixed
Configuration data at the named key or null if the key does not exist.
getConfigOrFail(string $key)
Returns the config for this specific key.
The config value for this key must exist, it can never be null.
string
$key The key to get.
mixed
Configuration data at the named key
InvalidArgumentException
getLogger()
Get exception logger.
\Cake\Error\ErrorLoggerInterface
getRenderer(\Throwable $exception, ?\Psr\Http\Message\ServerRequestInterface $request)
Get a renderer instance.
\Throwable
$exception The exception being rendered.
\Psr\Http\Message\ServerRequestInterface|null
$request optional The request.
\Cake\Error\ExceptionRendererInterface
The exception renderer.
RuntimeException
handleError(int $code, string $description, ?string $file, ?int $line, ?array $context)
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 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.
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
bool
True if error was handled
handleException(\Throwable $exception)
Handle uncaught exceptions.
Uses a template method provided by subclasses to display errors in an environment appropriate way.
\Throwable
$exception Exception instance.
Exception
handleFatalError(int $code, string $description, string $file, int $line)
Display/Log a fatal error.
int
$code Code of error
string
$description Error description
string
$file File on which error occurred
int
$line Line that triggered the error
bool
increaseMemoryLimit(int $additionalKb)
Increases the PHP "memory_limit" ini setting by the specified amount in kilobytes
int
$additionalKb Number in kilobytes
logException(\Throwable $exception, ?\Psr\Http\Message\ServerRequestInterface $request)
Log an error for the exception if applicable.
\Throwable
$exception The exception to log a message for.
\Psr\Http\Message\ServerRequestInterface
$request optional The current request.
bool
mapErrorCode(int $code)
Map an error code into an Error word, and log location.
int
$code Error code to map
array
Array of error word, and log location.
register()
Register the error and exception handlers.
setConfig(mixed $key, mixed $value, mixed $merge)
Sets the config.
Setting a specific value:
$this->setConfig('key', $value);
Setting a nested value:
$this->setConfig('some.nested.key', $value);
Updating multiple config settings at the same time:
$this->setConfig(['one' => 'value', 'another' => 'value']);
string|array
$key The key to set, or a complete array of configs.
mixed|null
$value optional The value to set.
bool
$merge optional Whether to recursively merge or overwrite existing config, defaults to true.
$this
Cake\Core\Exception\Exception
wrapAndHandleException(\Throwable $exception)
Checks 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.
\Throwable
$exception The exception to handle
Runtime config
array
Whether the config property has already been configured with defaults
bool
Options to use for the Error handling.
array
bool
Exception logger instance.
\Cake\Error\ErrorLoggerInterface|null
© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.1/class-Cake.Error.ErrorHandler.html