MediaWiki
1.27.1
|
Handler class for MWExceptions. More...
Static Public Member Functions | |
static | getLogContext ($e) |
Get a PSR-3 log event context from an Exception. More... | |
static | getLogId ($e) |
Get the ID for this exception. More... | |
static | getLogMessage ($e) |
Get a message formatting the exception message and its origin. More... | |
static | getPublicLogMessage (Exception $e) |
static | getRedactedTrace ($e) |
Return a copy of an exception's backtrace as an array. More... | |
static | getRedactedTraceAsString ($e) |
Generate a string representation of an exception's stack trace. More... | |
static | getStructuredExceptionData ($e) |
Get a structured representation of an Exception. More... | |
static | getURL () |
If the exception occurred in the course of responding to a request, returns the requested URL. More... | |
static | handleError ($level, $message, $file=null, $line=null) |
Handler for set_error_handler() callback notifications. More... | |
static | handleException ($e) |
Exception handler which simulates the appropriate catch() handling: More... | |
static | handleFatalError ($level=null, $message=null, $file=null, $line=null, $context=null, $trace=null) |
Dual purpose callback used as both a set_error_handler() callback and a registered shutdown function. More... | |
static | installHandler () |
Install handlers with PHP. More... | |
static | jsonSerializeException ($e, $pretty=false, $escaping=0) |
Serialize an Exception object to JSON. More... | |
static | logException ($e) |
Log an exception to the exception log (if enabled). More... | |
static | prettyPrintTrace (array $trace, $pad= '') |
Generate a string representation of a stacktrace. More... | |
static | printError ($message) |
Print a message, if possible to STDERR. More... | |
static | redactTrace (array $trace) |
Redact a stacktrace generated by Exception::getTrace(), debug_backtrace() or similar means. More... | |
static | rollbackMasterChangesAndLog ($e) |
If there are any open database transactions, roll them back and log the stack trace of the exception that should have been caught so the transaction could be aborted properly. More... | |
Static Protected Member Functions | |
static | logError (ErrorException $e, $channel) |
Log an exception that wasn't thrown but made to wrap an error. More... | |
static | report ($e) |
Report an exception to the user. More... | |
Static Protected Attributes | |
static | $fatalErrorTypes |
static | $handledFatalCallback = false |
static | $reservedMemory |
Handler class for MWExceptions.
Definition at line 27 of file MWExceptionHandler.php.
|
static |
Get a PSR-3 log event context from an Exception.
Creates a structured array containing information about the provided exception that can be used to augment a log message sent to a PSR-3 logger.
Exception | Throwable | $e |
Definition at line 508 of file MWExceptionHandler.php.
References $e, and WebRequest\getRequestId().
|
static |
Get the ID for this exception.
The ID is saved so that one can match the one output to the user (when $wgShowExceptionDetails is set to false), to the entry in the debug log.
Exception | Throwable | $e |
Definition at line 452 of file MWExceptionHandler.php.
References WebRequest\getRequestId(), and wfDeprecated().
|
static |
Get a message formatting the exception message and its origin.
Exception | Throwable | $e |
Definition at line 479 of file MWExceptionHandler.php.
References $e, $line, $type, and WebRequest\getRequestId().
Referenced by ResourceLoader\formatExceptionNoComment(), MWException\getHTML(), and MWException\getText().
|
static |
Definition at line 490 of file MWExceptionHandler.php.
References $type, and WebRequest\getRequestId().
Referenced by ResourceLoader\formatExceptionNoComment().
|
static |
Return a copy of an exception's backtrace as an array.
Like Exception::getTrace, but replaces each element in each frame's argument array with the name of its class (if the element is an object) or its type (if the element is a PHP primitive).
Exception | Throwable | $e |
Definition at line 416 of file MWExceptionHandler.php.
References $e.
Referenced by MediaWiki\Logger\LegacyLogger\format(), and MWExceptionHandlerTest\testGetRedactedTrace().
|
static |
Generate a string representation of an exception's stack trace.
Like Exception::getTraceAsString, but replaces argument values with argument type or class name.
Exception | Throwable | $e |
Definition at line 357 of file MWExceptionHandler.php.
References $e.
Referenced by MWException\getHTML(), MWException\getText(), and ApiMain\substituteResultWithError().
|
static |
Get a structured representation of an Exception.
Returns an array of structured data (class, message, code, file, backtrace) derived from the given exception. The backtrace information will be redacted as per getRedactedTraceAsArray().
Exception | Throwable | $e |
Definition at line 526 of file MWExceptionHandler.php.
References $e, WebRequest\getRequestId(), and global.
|
static |
If the exception occurred in the course of responding to a request, returns the requested URL.
Otherwise, returns false.
Definition at line 464 of file MWExceptionHandler.php.
References $wgRequest, and global.
Referenced by MWException\getHTML().
|
static |
Handler for set_error_handler() callback notifications.
Receive a callback from the interpreter for a raised error, create an ErrorException, and log the exception to the 'error' logging channel(s). If the raised error is a fatal error type (only under HHVM) delegate to handleFatalError() instead.
int | $level | Error level raised |
string | $message | |
string | $file | |
int | $line |
Definition at line 204 of file MWExceptionHandler.php.
|
static |
Exception handler which simulates the appropriate catch() handling:
try { ... } catch ( Exception $e ) { $e->report(); } catch ( Exception $e ) { echo $e->__toString(); }
Exception | Throwable | $e |
Definition at line 164 of file MWExceptionHandler.php.
References $e.
Referenced by MediaWiki\doPostOutputShutdown(), and MediaWiki\run().
|
static |
Dual purpose callback used as both a set_error_handler() callback and a registered shutdown function.
Receive a callback from the interpreter for a raised error or system shutdown, check for a fatal error, and log to the 'fatal' logging channel.
Special handling is included for missing class errors as they may indicate that the user needs to install 3rd-party libraries via Composer or other means.
int | $level | Error level raised |
string | $message | Error message |
string | $file | File that error was raised in |
int | $line | Line number error was raised at |
array | $context | Active symbol table point of error |
array | $trace | Backtrace at point of error (undocumented HHVM feature) |
Definition at line 270 of file MWExceptionHandler.php.
References $line, on, or, and wfRandomString().
|
static |
Install handlers with PHP.
Definition at line 48 of file MWExceptionHandler.php.
|
static |
Serialize an Exception object to JSON.
The JSON object will have keys 'id', 'file', 'line', 'message', and 'url'. These keys map to string values, with the exception of 'line', which is a number, and 'url', which may be either a string URL or or null if the exception did not occur in the context of serving a web request.
If $wgLogExceptionBacktrace is true, it will also have a 'backtrace' key, mapped to the array return value of Exception::getTrace, but with each element in each frame's "args" array (if set) replaced with the argument's class name (if the argument is an object) or type name (if the argument is a PHP primitive).
Exception | Throwable | $e | |
bool | $pretty | Add non-significant whitespace to improve readability (default: false). |
int | $escaping | Bitfield consisting of FormatJson::.*_OK class constants. |
Definition at line 610 of file MWExceptionHandler.php.
References $e, and FormatJson\encode().
Referenced by MWExceptionTest\testJsonserializeexceptionBacktracingDisabled(), MWExceptionTest\testJsonserializeexceptionBacktracingEnabled(), MWExceptionTest\testJsonserializeexceptionKeys(), and MWExceptionTest\testJsonSerializeExceptions().
|
staticprotected |
Log an exception that wasn't thrown but made to wrap an error.
ErrorException | $e | |
string | $channel |
Definition at line 649 of file MWExceptionHandler.php.
References $suppressed, FormatJson\ALL_OK, and Hooks\run().
|
static |
Log an exception to the exception log (if enabled).
This method must not assume the exception is an MWException, it is also used to handle PHP exceptions or exceptions from other libraries.
Exception | Throwable | $e |
Definition at line 624 of file MWExceptionHandler.php.
References $e, FormatJson\ALL_OK, and Hooks\run().
Referenced by ResourceLoader\applyFilter(), WikiPage\doViewUpdates(), DeferredUpdates\execute(), JobRunner\executeJob(), ApiMain\handleException(), ResourceLoader\makeModuleResponse(), JobQueueGroup\pushLazyJobs(), ResourceLoader\respond(), LoadBalancer\rollbackMasterChanges(), DatabaseBase\runOnTransactionIdleCallbacks(), DatabaseBase\runOnTransactionPreCommitCallbacks(), User\saveSettings(), and MediaWiki\triggerJobs().
|
static |
Generate a string representation of a stacktrace.
array | $trace | |
string | $pad | Constant padding to add to each line of trace |
Definition at line 369 of file MWExceptionHandler.php.
References as.
Referenced by MediaWiki\Logger\LegacyLogger\format(), and MediaWiki\Logger\Monolog\LineFormatter\normalizeExceptionArray().
|
static |
Print a message, if possible to STDERR.
Use this in command line mode only (see isCommandLine)
string | $message | Failure text |
Definition at line 118 of file MWExceptionHandler.php.
Referenced by MWException\report().
|
static |
Redact a stacktrace generated by Exception::getTrace(), debug_backtrace() or similar means.
Replaces each element in each frame's argument array with the name of its class (if the element is an object) or its type (if the element is a PHP primitive).
array | $trace | Stacktrace |
Definition at line 430 of file MWExceptionHandler.php.
Referenced by MediaWiki\Logger\Monolog\LineFormatter\exceptionAsArray().
|
staticprotected |
Report an exception to the user.
Exception | Throwable | $e |
Definition at line 61 of file MWExceptionHandler.php.
References $e, global, and MWException\isCommandLine().
|
static |
If there are any open database transactions, roll them back and log the stack trace of the exception that should have been caught so the transaction could be aborted properly.
Exception | Throwable | $e |
Definition at line 137 of file MWExceptionHandler.php.
References $e, $factory, and wfGetLBFactory().
Referenced by JobRunner\executeJob(), ApiMain\handleException(), AssembleUploadChunksJob\run(), and PublishStashedFileJob\run().
|
staticprotected |
Definition at line 36 of file MWExceptionHandler.php.
|
staticprotected |
Definition at line 43 of file MWExceptionHandler.php.
|
staticprotected |
Definition at line 32 of file MWExceptionHandler.php.