On this page
Class BaseErrorHandler
Base error handler that provides logic common to the CLI + web error/exception handlers.
Subclasses are required to implement the template methods to handle displaying the errors in their environment.
Direct Subclasses
Method Summary
- Display an error message in an environment specific way.
- Display an exception in an environment specific way.
-
_getMessage() protectedGenerates a formatted error message
-
_logError() protectedLog an error.
-
_logException() protectedHandles exception logging
-
_requestContext() protectedGet the request context for an error/exception trace.
-
_stop() protectedStop the process.
-
handleError() publicSet as the default error handler by CakePHP.
-
handleException() publicHandle uncaught exceptions.
-
handleFatalError() publicDisplay/Log a fatal error.
-
increaseMemoryLimit() public
Increases the PHP "memory_limit" ini setting by the specified amount in kilobytes
- Map an error code into an Error word, and log location.
-
register() publicRegister the error and exception handlers.
-
wrapAndHandleException() public
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.
Method Detail
_displayError()source abstract protected
_displayError( array $error , boolean $debug )
Display an error message in an environment specific way.
Subclasses should implement this method to display the error as desired for the runtime they operate in.
Parameters
-
array
$error
- An array of error data.
-
boolean
$debug
- Whether or not the app is in debug mode.
_displayException()source abstract protected
_displayException( Exception $exception )
Display an exception in an environment specific way.
Subclasses should implement this method to display an uncaught exception as desired for the runtime they operate in.
Parameters
-
Exception
$exception
- The uncaught exception.
_getMessage()source protected
_getMessage( Exception $exception )
Generates a formatted error message
Parameters
-
Exception
$exception
- Exception instance
Returns
stringFormatted message
_logError()source protected
_logError( string $level , array $data )
Log an error.
Parameters
-
string
$level
- The level name of the log.
-
array
$data
- Array of error data.
Returns
boolean_logException()source protected
_logException( Exception $exception )
Handles exception logging
Parameters
-
Exception
$exception
- Exception instance.
Returns
boolean_requestContext()source protected
_requestContext( Cake\Network\Request $request )
Get the request context for an error/exception trace.
Parameters
Cake\Network\Request
$request
- The request to read from.
Returns
string_stop()source protected
_stop( integer $code )
Stop the process.
Implemented in subclasses that need it.
Parameters
-
integer
$code
- Exit code.
handleError()source public
handleError( integer $code , string $description , string|null $file null , integer|null $line null , array|null $context null )
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
-
integer
$code
- Code of error
-
string
$description
- Error description
-
string|null
$file
optional null - File on which error occurred
-
integer|null
$line
optional null - Line that triggered the error
-
array|null
$context
optional null - Context
Returns
booleanTrue if error was handled
handleException()source public
handleException( Exception $exception )
Handle uncaught exceptions.
Uses a template method provided by subclasses to display errors in an environment appropriate way.
Parameters
-
Exception
$exception
- Exception instance.
Throws
ExceptionWhen renderer class not found
See
http://php.net/manual/en/function.set-exception-handler.phphandleFatalError()source public
handleFatalError( integer $code , string $description , string $file , integer $line )
Display/Log a fatal error.
Parameters
-
integer
$code
- Code of error
-
string
$description
- Error description
-
string
$file
- File on which error occurred
-
integer
$line
- Line that triggered the error
Returns
booleanincreaseMemoryLimit()source public
increaseMemoryLimit( string $additionalKb )
Increases the PHP "memory_limit" ini setting by the specified amount in kilobytes
Parameters
-
string
$additionalKb
- Number in kilobytes
mapErrorCode()source public static
mapErrorCode( integer $code )
Map an error code into an Error word, and log location.
Parameters
-
integer
$code
- Error code to map
Returns
arrayArray of error word, and log location.
wrapAndHandleException()source public
wrapAndHandleException( Exception|Error $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.
Parameters
-
Exception|Error
$exception
- The exception to handle
© 2005–2016 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.
http://api.cakephp.org/3.2/class-Cake.Error.BaseErrorHandler.html