MWException Class Reference

MediaWiki exception. More...

Inheritance diagram for MWException:

Collaboration diagram for MWException:

Public Member Functions
	getHTML ()
	If $wgShowExceptionDetails is true, return a HTML message with a backtrace to the error, otherwise show a message to ask to set it to true to show that information. More...
	getPageTitle ()
	Return the title of the page when reporting this error in a HTTP response. More...
	getText ()
	Get the text to display when reporting the error on the command line. More...
	isLoggable ()
	Whether to log this exception in the exception debug log. More...
	msg ($key, $fallback)
	Get a message from i18n. More...
	report ()
	Output a report about the exception and takes care of formatting. More...
	reportHTML ()
	Output the exception report using HTML. More...
	runHooks ($name, $args=[])
	Run hook to allow extensions to modify the text of the exception. More...
	useMessageCache ()
	Can the extension use the Message class/wfMessage to get i18n-ed messages? More...
	useOutputPage ()
	Should the exception use $wgOut to output the error? More...

Static Public Member Functions
static	isCommandLine ()
	Check whether we are in command line mode or not to report the exception in the correct format. More...

Static Private Member Functions
static	header ($header)
	Send a header, if we haven't already sent them. More...
static	statusHeader ($code)

Detailed Description

MediaWiki exception.

Definition at line 26 of file MWException.php.

Member Function Documentation

MWException::getHTML

(

)

If $wgShowExceptionDetails is true, return a HTML message with a backtrace to the error, otherwise show a message to ask to set it to true to show that information.

Returns

string Html to output

Definition at line 135 of file MWException.php.

References $type, $wgShowExceptionDetails, MWExceptionHandler\getLogMessage(), MWExceptionHandler\getRedactedTraceAsString(), WebRequest\getRequestId(), MWExceptionHandler\getURL(), global, and msg().

Referenced by reportHTML(), and wfStreamThumb().

MWException::getPageTitle

(

)

Return the title of the page when reporting this error in a HTTP response.

Returns

string

Definition at line 185 of file MWException.php.

References msg().

Referenced by reportHTML().

MWException::getText

(

)

Get the text to display when reporting the error on the command line.

If $wgShowExceptionDetails is true, return a text message with a backtrace to the error.

Returns

string

Definition at line 168 of file MWException.php.

References $wgShowExceptionDetails, MWExceptionHandler\getLogMessage(), MWExceptionHandler\getRedactedTraceAsString(), and global.

Referenced by ChangePassword\execute(), CreateAndPromote\execute(), and report().

static MWException::header (   $header )

staticprivate

Send a header, if we haven't already sent them.

We shouldn't, but sometimes we might in a weird case like Export

Parameters

string

$header

Definition at line 263 of file MWException.php.

Referenced by HttpError\__construct(), HttpError\getHTML(), and HttpError\report().

static MWException::isCommandLine ( )

static

Check whether we are in command line mode or not to report the exception in the correct format.

Returns

bool

Definition at line 254 of file MWException.php.

References $GLOBALS.

Referenced by MWExceptionHandler\report().

MWException::isLoggable

(

)

Whether to log this exception in the exception debug log.

Since

1.23

Returns

bool

Definition at line 45 of file MWException.php.

MWException::msg	(		$key,
			$fallback
	)

Get a message from i18n.

Parameters

string	$key	Message name
string	$fallback	Default message if the message cache can't be called by the exception The function also has other parameters that are arguments for the message

Returns

string Message with arguments replaced

Definition at line 116 of file MWException.php.

References $args, $e, $fallback, useMessageCache(), wfMessage(), and wfMsgReplaceArgs().

Referenced by ErrorPageError\__construct(), getHTML(), DBExpectedError\getPageTitle(), getPageTitle(), DBQueryError\getTextContent(), ErrorPageError\report(), UserNotLoggedIn\report(), reportHTML(), and MediaWiki\Auth\AuthPluginPrimaryAuthenticationProviderTest\testProviderChangeAuthenticationData().

MWException::report

(

)

Output a report about the exception and takes care of formatting.

It will be either HTML or plain text based on isCommandLine().

Definition at line 231 of file MWException.php.

References $wgMimeType, getText(), global, MWExceptionHandler\printError(), reportHTML(), and wfHttpError().

MWException::reportHTML

(

)

Output the exception report using HTML.

Definition at line 192 of file MWException.php.

References $wgOut, $wgSitename, getHTML(), getPageTitle(), global, msg(), runHooks(), and useOutputPage().

Referenced by report().

MWException::runHooks	(		$name,
			$args = []
	)

Run hook to allow extensions to modify the text of the exception.

Parameters

string	$name	Class name of the exception
array	$args	Arguments to pass to the callback functions

Returns

string|null String to output or null if any hook has been called

Definition at line 73 of file MWException.php.

References $args, $name, $wgExceptionHooks, as, and global.

Referenced by reportHTML().

static MWException::statusHeader (   $code )

staticprivate

Definition at line 268 of file MWException.php.

References $code, and HttpStatus\header().

MWException::useMessageCache

(

)

Can the extension use the Message class/wfMessage to get i18n-ed messages?

Returns

bool

Definition at line 54 of file MWException.php.

References $wgLang, as, and global.

Referenced by msg(), DBConnectionError\msg(), and useOutputPage().

MWException::useOutputPage

(

)

Should the exception use $wgOut to output the error?

Returns

bool

Definition at line 32 of file MWException.php.

References $GLOBALS, and useMessageCache().

Referenced by reportHTML().

---

The documentation for this class was generated from the following file:

• includes/exception/MWException.php