ErrorHandler ^deprecated

static ErrorHandler register(ErrorHandler|null|int $handler = null, bool $replace = true)

Registers the error handler.

Parameters

ErrorHandler|null|int	$handler	The handler to register, or @deprecated (since version 2.6, to be removed in 3.0) bit field of thrown levels
bool	$replace	Whether to replace or not any existing handler

Return Value

ErrorHandler

The registered error handler

__construct(BufferingLogger $bootstrappingLogger = null)

Parameters

BufferingLogger

$bootstrappingLogger

setDefaultLogger(LoggerInterface $logger, array|int $levels = null, bool $replace = false)

Sets a logger to non assigned errors levels.

Parameters

LoggerInterface	$logger	A PSR-3 logger to put as default for the given levels
array|int	$levels	An array map of E* to LogLevel::* or an integer bit field of E* constants
bool	$replace	Whether to replace or not any existing logger

array setLoggers(array $loggers)

Sets a logger for each error level.

Parameters

array

$loggers

Error levels to [LoggerInterface|null, LogLevel::*] map

Return Value

array

The previous map

Exceptions

InvalidArgumentException

callable|null setExceptionHandler(callable $handler)

Sets a user exception handler.

Parameters

callable

$handler

A handler that will be called on Exception

Return Value

callable|null

The previous exception handler

Exceptions

InvalidArgumentException

int throwAt(int $levels, bool $replace = false)

Sets the PHP error levels that throw an exception when a PHP error occurs.

Parameters

int	$levels	A bit field of E_* constants for thrown errors
bool	$replace	Replace or amend the previous value

Return Value

int	The previous value

int scopeAt(int $levels, bool $replace = false)

Sets the PHP error levels for which local variables are preserved.

Parameters

int	$levels	A bit field of E_* constants for scoped errors
bool	$replace	Replace or amend the previous value

Return Value

int	The previous value

int traceAt(int $levels, bool $replace = false)

Sets the PHP error levels for which the stack trace is preserved.

Parameters

int	$levels	A bit field of E_* constants for traced errors
bool	$replace	Replace or amend the previous value

Return Value

int	The previous value

int screamAt(int $levels, bool $replace = false)

Sets the error levels where the @-operator is ignored.

Parameters

int	$levels	A bit field of E_* constants for screamed errors
bool	$replace	Replace or amend the previous value

Return Value

int	The previous value

bool handleError($type, $message, $file, $line, array $context, array $backtrace = null)

Handles errors by filtering then logging them according to the configured bit fields.

Parameters

	$type
	$message
	$file
	$line
array	$context
array	$backtrace

Return Value

bool	Returns false when no handling happens so that the PHP engine can handle the error itself.

Exceptions

ErrorException

When $this->thrownErrors requests so

handleException(Exception|Throwable $exception, array $error = null)

Handles an exception by logging then forwarding it to another handler.

Parameters

Exception|Throwable	$exception	An exception to handle
array	$error	An array as returned by errorgetlast()

static handleFatalError(array $error = null)

Shutdown registered function for handling PHP fatal errors.

Parameters

array

$error

An array as returned by errorgetlast()

static stackErrors()

Configures the error handler for delayed handling.

Ensures also that non-catchable fatal errors are never silenced.

As shown by http://bugs.php.net/42098 and http://bugs.php.net/60724 PHP has a compile stage where it behaves unusually. To workaround it, we plug an error handler that only stacks errors for later.

The most important feature of this is to prevent autoloading until unstackErrors() is called.

static unstackErrors()

Unstacks stacked errors and forwards to the logger.

setLevel(int|null $level) ^deprecated

^deprecated

since version 2.6, to be removed in 3.0. Use throwAt() instead.

Sets the level at which the conversion to Exception is done.

Parameters

int|null

$level

The level (null to use the error_reporting() value and 0 to disable)

setDisplayErrors(int $displayErrors) ^deprecated

^deprecated

since version 2.6, to be removed in 3.0. Use throwAt() instead.

Sets the display_errors flag value.

Parameters

int

$displayErrors

The display_errors flag value

static setLogger(LoggerInterface $logger, string $channel = 'deprecation') ^deprecated

^deprecated

since version 2.6, to be removed in 3.0. Use setLoggers() or setDefaultLogger() instead.

Sets a logger for the given channel.

Parameters

LoggerInterface	$logger	A logger interface
string	$channel	The channel associated with the logger (deprecation, emergency or scream)

handle($level, $message, $file = 'unknown', $line, $context = array()) ^deprecated

^deprecated

since version 2.6, to be removed in 3.0. Use handleError() instead.

Parameters

	$level
	$message
	$file
	$line
	$context

handleFatal() ^deprecated

^deprecated

since version 2.6, to be removed in 3.0. Use handleFatalError() instead.

Handles PHP fatal errors.