1. class
  2. Symfony
  3. Component
  4. HttpKernel
  5. Debug
  6. ErrorHandler

ErrorHandler deprecated

class ErrorHandler extends ErrorHandler

deprecated since version 2.3, to be removed in 3.0. Use the same class from the Debug component instead.

ErrorHandler.

Constants

TYPE_DEPRECATION

Methods

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

Registers the error handler.

from ErrorHandler
__construct(BufferingLogger $bootstrappingLogger = null)

No description

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

Sets a logger to non assigned errors levels.

from ErrorHandler
array
setLoggers(array $loggers)

Sets a logger for each error level.

from ErrorHandler
callable|null
setExceptionHandler(callable $handler)

Sets a user exception handler.

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

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

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

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

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

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

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

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

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

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

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

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

from ErrorHandler
static 
handleFatalError(array $error = null)

Shutdown registered function for handling PHP fatal errors.

from ErrorHandler
static 
stackErrors()

Configures the error handler for delayed handling.

from ErrorHandler
static 
unstackErrors()

Unstacks stacked errors and forwards to the logger.

from ErrorHandler
setLevel(int|null $level) deprecated

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

from ErrorHandler
setDisplayErrors(int $displayErrors) deprecated

Sets the display_errors flag value.

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

Sets a logger for the given channel.

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

No description

from ErrorHandler
handleFatal() deprecated

Handles PHP fatal errors.

from ErrorHandler

Details

in ErrorHandler at line line 121
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

in ErrorHandler at line line 156
__construct(BufferingLogger $bootstrappingLogger = null)

Parameters

BufferingLogger $bootstrappingLogger

in ErrorHandler at line line 171
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

in ErrorHandler at line line 205
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

in ErrorHandler at line line 258
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

in ErrorHandler at line line 277
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

in ErrorHandler at line line 300
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

in ErrorHandler at line line 319
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

in ErrorHandler at line line 338
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

in ErrorHandler at line line 379
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

in ErrorHandler at line line 525
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()

in ErrorHandler at line line 592
static handleFatalError(array $error = null)

Shutdown registered function for handling PHP fatal errors.

Parameters

array $error An array as returned by errorgetlast()

in ErrorHandler at line line 652
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.

in ErrorHandler at line line 660
static unstackErrors()

Unstacks stacked errors and forwards to the logger.

in ErrorHandler at line line 705
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)

in ErrorHandler at line line 720
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

in ErrorHandler at line line 741
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)

in ErrorHandler at line line 766
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

in ErrorHandler at line line 778
handleFatal() deprecated

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

Handles PHP fatal errors.