PHPXRef 0.7.1 : phpBB-3.2.11-deutsch : Detail view of ErrorHandler.php

Class: ErrorHandler - X-Ref

A generic ErrorHandler for the PHP engine.

Provides five bit fields that control how errors are handled:
- thrownErrors: errors thrown as \ErrorException
- loggedErrors: logged errors, when not @-silenced
- scopedErrors: errors thrown or logged with their local context
- tracedErrors: errors logged with their stack trace, only once for repeated errors
- screamedErrors: never @-silenced errors

Each error level can be logged by a dedicated PSR-3 logger object.
Screaming only applies to logging.
Throwing takes precedence over logging.
Uncaught exceptions are logged as E_ERROR.
E_DEPRECATED and E_USER_DEPRECATED levels never throw.
E_RECOVERABLE_ERROR and E_USER_ERROR levels always throw.
Non catchable errors that can be detected at shutdown time are logged when the scream bit field allows so.
As errors have a performance cost, repeated errors are all logged, so that the developer
can see them and weight them as more important to fix than others of the same level.

Registers the error handler.

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

__construct(BufferingLogger $bootstrappingLogger = null) X-Ref

No description

setDefaultLogger(LoggerInterface $logger, $levels = null, $replace = false) X-Ref

Sets a logger to non assigned errors levels.

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

setLoggers(array $loggers) X-Ref

Sets a logger for each error level.

param: array $loggers Error levels to [LoggerInterface|null, LogLevel::*] map
return: array The previous map

setExceptionHandler($handler) X-Ref

Sets a user exception handler.

param: callable $handler A handler that will be called on Exception
return: callable|null The previous exception handler

throwAt($levels, $replace = false) X-Ref

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

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

scopeAt($levels, $replace = false) X-Ref

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

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

traceAt($levels, $replace = false) X-Ref

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

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

screamAt($levels, $replace = false) X-Ref

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

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

reRegister($prev) X-Ref

Re-registers as a PHP error handler if levels changed.

handleError($type, $message, $file, $line) X-Ref

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

param: int $type One of the E_* constants
param: string $message
param: string $file
param: int $line
return: bool Returns false when no handling happens so that the PHP engine can handle the error itself

handleException($exception, array $error = null) X-Ref

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

param: \Exception|\Throwable $exception An exception to handle
param: array $error An array as returned by error_get_last()

handleFatalError(array $error = null) X-Ref

Shutdown registered function for handling PHP fatal errors.

param: array $error An array as returned by error_get_last()

stackErrors() X-Ref

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.

unstackErrors() X-Ref

Unstacks stacked errors and forwards to the logger.

getFatalErrorHandlers() X-Ref

Gets the fatal error handlers.

Override this method if you want to define more fatal error handlers.

return: FatalErrorHandlerInterface[] An array of FatalErrorHandlerInterface

setLevel($level) X-Ref

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

param: int|null $level The level (null to use the error_reporting() value and 0 to disable)

setDisplayErrors($displayErrors) X-Ref

Sets the display_errors flag value.

param: int $displayErrors The display_errors flag value

setLogger(LoggerInterface $logger, $channel = 'deprecation') X-Ref

Sets a logger for the given channel.

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

handle($level, $message, $file = 'unknown', $line = 0, $context = array() X-Ref

handleFatal() X-Ref

Handles PHP fatal errors.

Class: ErrorHandlerCanary - X-Ref

Private class used to work around https://bugs.php.net/54275.

__construct() X-Ref

No description

__destruct() X-Ref

No description

File Size:	894 lines (33 kb)
Included or required:	0 times
Referenced:	0 times
Includes or requires:	0 files

PHP Cross Reference of phpBB-3.2.11-deutsch

/vendor/symfony/debug/ -> ErrorHandler.php (summary)

Defines 2 classes