\Cake\Error\MiddlewareErrorHandlerMiddleware

Error handling middleware.

Traps exceptions and converts them into HTML or content-type appropriate error pages using the CakePHP ExceptionRenderer.

Summary

Methods
Properties
Constants
setConfig()
getConfig()
config()
configShallow()
__construct()
__invoke()
handleException()
No public properties found
No constants found
_configRead()
_configWrite()
_configDelete()
handleInternalError()
getRenderer()
logException()
getMessage()
getMessageForException()
$_config
$_configInitialized
$_defaultConfig
$exceptionRenderer
N/A
No private methods found
No private properties found
N/A

Properties

$_config

$_config : array

Runtime config

Type

array

$_configInitialized

$_configInitialized : boolean

Whether the config property has already been configured with defaults

Type

boolean

$_defaultConfig

$_defaultConfig : array

Default configuration values.

  • log Enable logging of exceptions.
  • skipLog List of exceptions to skip logging. Exceptions that extend one of the listed exceptions will also not be logged. Example:

    'skipLog' => ['Cake\Error\NotFoundException', 'Cake\Error\UnauthorizedException']
  • trace Should error logs include stack traces?

Type

array

Methods

setConfig()

setConfig(string|array  $key, mixed|null  $value = null, boolean  $merge = true) : $this

Sets the config.

Usage

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']);

Parameters

string|array $key

The key to set, or a complete array of configs.

mixed|null $value

The value to set.

boolean $merge

Whether to recursively merge or overwrite existing config, defaults to true.

Throws

\Cake\Core\Exception\Exception

When trying to set a key that is invalid.

Returns

$this

getConfig()

getConfig(string|null  $key = null, mixed  $default = null) : mixed

Returns the config.

Usage

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');

Parameters

string|null $key

The key to get or null for the whole config.

mixed $default

The return value when the key does not exist.

Returns

mixed —

Config value being read.

config()

config(string|array|null  $key = null, mixed|null  $value = null, boolean  $merge = true) : mixed

Gets/Sets the config.

Usage

Reading the whole config:

$this->config();

Reading a specific value:

$this->config('key');

Reading a nested value:

$this->config('some.nested.key');

Setting a specific value:

$this->config('key', $value);

Setting a nested value:

$this->config('some.nested.key', $value);

Updating multiple config settings at the same time:

$this->config(['one' => 'value', 'another' => 'value']);

Parameters

string|array|null $key

The key to get/set, or a complete array of configs.

mixed|null $value

The value to set.

boolean $merge

Whether to recursively merge or overwrite existing config, defaults to true.

Throws

\Cake\Core\Exception\Exception

When trying to set a key that is invalid.

Returns

mixed —

Config value being read, or the object itself on write operations.

configShallow()

configShallow(string|array  $key, mixed|null  $value = null) : $this

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']);

Parameters

string|array $key

The key to set, or a complete array of configs.

mixed|null $value

The value to set.

Returns

$this

__construct()

__construct(string|callable|null  $exceptionRenderer = null, array  $config = array()) 

Constructor

Parameters

string|callable|null $exceptionRenderer

The renderer or class name to use or a callable factory. If null, Configure::read('Error.exceptionRenderer') will be used.

array $config

Configuration options to use. If empty, Configure::read('Error') will be used.

_configRead()

_configRead(string|null  $key) : mixed

Reads a config key.

Parameters

string|null $key

Key to read.

Returns

mixed

_configWrite()

_configWrite(string|array  $key, mixed  $value, boolean|string  $merge = false) : void

Writes a config key.

Parameters

string|array $key

Key to write to.

mixed $value

Value to write.

boolean|string $merge

True to merge recursively, 'shallow' for simple merge, false to overwrite, defaults to false.

Throws

\Cake\Core\Exception\Exception

if attempting to clobber existing config

_configDelete()

_configDelete(string  $key) : void

Deletes a single config key.

Parameters

string $key

Key to delete.

Throws

\Cake\Core\Exception\Exception

if attempting to clobber existing config

getRenderer()

getRenderer(\Exception  $exception, \Psr\Http\Message\ServerRequestInterface  $request) : \Cake\Error\ExceptionRendererInterface

Get a renderer instance

Parameters

\Exception $exception

The exception being rendered.

\Psr\Http\Message\ServerRequestInterface $request

The request.

Throws

\Exception

When the renderer class cannot be found.

Returns

\Cake\Error\ExceptionRendererInterface

The exception renderer.

logException()

logException(\Psr\Http\Message\ServerRequestInterface  $request, \Exception  $exception) : void

Log an error for the exception if applicable.

Parameters

\Psr\Http\Message\ServerRequestInterface $request

The current request.

\Exception $exception

The exception to log a message for.

getMessage()

getMessage(\Psr\Http\Message\ServerRequestInterface  $request, \Exception  $exception) : string

Generate the error log message.

Parameters

\Psr\Http\Message\ServerRequestInterface $request

The current request.

\Exception $exception

The exception to log a message for.

Returns

string —

Error message

getMessageForException()

getMessageForException(\Exception  $exception, boolean  $isPrevious = false) : string

Generate the message for the exception

Parameters

\Exception $exception

The exception to log a message for.

boolean $isPrevious

False for original exception, true for previous

Returns

string —

Error message