master/php/MWException_8php_source.html

 <?php
 class MWException extends Exception {
     public function useOutputPage() {
         return $this->useMessageCache() &&
         !empty( $GLOBALS['wgFullyInitialised'] ) &&
         !empty( $GLOBALS['wgOut'] ) &&
         !defined( 'MEDIAWIKI_INSTALL' );
     }

     public function isLoggable() {
         return true;
     }

     public function useMessageCache() {
         global $wgLang;

         foreach ( $this->getTrace() as $frame ) {
             if ( isset( $frame['class'] ) && $frame['class'] === LocalisationCache::class ) {
                 return false;
             }
         }

         return $wgLang instanceof Language;
     }

     public function msg( $key, $fallback, ...$params ) {
         global $wgSitename;

         // FIXME: Keep logic in sync with MWExceptionRenderer::msg.
         $res = false;
         if ( $this->useMessageCache() ) {
             try {
                 $res = wfMessage( $key, ...$params )->text();
             } catch ( Exception $e ) {
             }
         }
         if ( $res === false ) {
             $res = wfMsgReplaceArgs( $fallback, $params );
             // If an exception happens inside message rendering,
             // {{SITENAME}} sometimes won't be replaced.
             $res = strtr( $res, [
                 '{{SITENAME}}' => $wgSitename,
             ] );
         }
         return $res;
     }

     public function getHTML() {
         global $wgShowExceptionDetails;

         if ( $wgShowExceptionDetails ) {
             return '<p>' . nl2br( htmlspecialchars( MWExceptionHandler::getLogMessage( $this ) ) ) .
             '</p><p>Backtrace:</p><p>' .
             nl2br( htmlspecialchars( MWExceptionHandler::getRedactedTraceAsString( $this ) ) ) .
             "</p>\n";
         } else {
             $logId = WebRequest::getRequestId();
             $type = static::class;
             return Html::errorBox(
             htmlspecialchars(
                 '[' . $logId . '] ' .
                 gmdate( 'Y-m-d H:i:s' ) . ": " .
                 $this->msg( "internalerror-fatal-exception",
                     "Fatal exception of type $1",
                     $type,
                     $logId,
                     MWExceptionHandler::getURL()
                 )
             ) ) .
             "<!-- Set \$wgShowExceptionDetails = true; " .
             "at the bottom of LocalSettings.php to show detailed " .
             "debugging information. -->";
         }
     }

     public function getText() {
         global $wgShowExceptionDetails;

         if ( $wgShowExceptionDetails ) {
             return MWExceptionHandler::getLogMessage( $this ) .
             "\nBacktrace:\n" . MWExceptionHandler::getRedactedTraceAsString( $this ) . "\n";
         } else {
             return "Set \$wgShowExceptionDetails = true; " .
             "in LocalSettings.php to show detailed debugging information.\n";
         }
     }

     public function getPageTitle() {
         return $this->msg( 'internalerror', 'Internal error' );
     }

     public function reportHTML() {
         global $wgOut, $wgSitename;
         if ( $this->useOutputPage() ) {
             $wgOut->prepareErrorPage( $this->getPageTitle() );
             // Manually set the html title, since sometimes
             // {{SITENAME}} does not get replaced for exceptions
             // happening inside message rendering.
             $wgOut->setHTMLTitle(
                 $this->msg(
                     'pagetitle',
                     "$1 - $wgSitename",
                     $this->getPageTitle()
                 )
             );

             $wgOut->addHTML( $this->getHTML() );

             $wgOut->output();
         } else {
             self::header( 'Content-Type: text/html; charset=utf-8' );
             echo "<!DOCTYPE html>\n" .
                 '<html><head>' .
                 // Mimick OutputPage::setPageTitle behaviour
                 '<title>' .
                 htmlspecialchars( $this->msg( 'pagetitle', "$1 - $wgSitename", $this->getPageTitle() ) ) .
                 '</title>' .
                 '<style>body { font-family: sans-serif; margin: 0; padding: 0.5em 2em; }</style>' .
                 "</head><body>\n";

             echo $this->getHTML();

             echo "</body></html>\n";
         }
     }

     public function report() {
         global $wgMimeType;

         if ( defined( 'MW_API' ) ) {
             // Unhandled API exception, we can't be sure that format printer is alive
             self::header( 'MediaWiki-API-Error: internal_api_error_' . static::class );
             wfHttpError( 500, 'Internal Server Error', $this->getText() );
         } elseif ( self::isCommandLine() ) {
             $message = $this->getText();
             $this->writeToCommandLine( $message );
         } else {
             self::statusHeader( 500 );
             self::header( "Content-Type: $wgMimeType; charset=utf-8" );

             $this->reportHTML();
         }
     }

     private function writeToCommandLine( $message ) {
         // T17602: STDERR may not be available
         if ( !defined( 'MW_PHPUNIT_TEST' ) && defined( 'STDERR' ) ) {
             fwrite( STDERR, $message );
         } else {
             echo $message;
         }
     }

     public static function isCommandLine() {
         return !empty( $GLOBALS['wgCommandLineMode'] );
     }

     private static function header( $header ) {
         if ( !headers_sent() ) {
             header( $header );
         }
     }

     private static function statusHeader( $code ) {
         if ( !headers_sent() ) {
             HttpStatus::header( $code );
         }
     }
 }
MWExceptionHandler\getLogMessage
static getLogMessage( $e)
Get a message formatting the exception message and its origin.
Definition: MWExceptionHandler.php:458

WebRequest\getRequestId
static getRequestId()
Get the unique request ID.
Definition: WebRequest.php:309

$wgSitename
$wgSitename
Name of the site.
Definition: DefaultSettings.php:80

$wgMimeType
$wgMimeType
The default Content-Type header.
Definition: DefaultSettings.php:3258

MWException\getPageTitle
getPageTitle()
Return the title of the page when reporting this error in a HTTP response.
Definition: MWException.php:156

$type
$type
Definition: testCompression.php:48

MWException\isLoggable
isLoggable()
Whether to log this exception in the exception debug log.
Definition: MWException.php:45

MWException\useMessageCache
useMessageCache()
Can the extension use the Message class/wfMessage to get i18n-ed messages?
Definition: MWException.php:54

MWException\statusHeader
static statusHeader( $code)
Definition: MWException.php:256

$res
$res
Definition: testCompression.php:52

$wgShowExceptionDetails
$wgShowExceptionDetails
If set to true, uncaught exceptions will print the exception message and a complete stack trace to ou...
Definition: DefaultSettings.php:6318

MWException\getHTML
getHTML()
If $wgShowExceptionDetails is true, return a HTML message with a backtrace to the error...
Definition: MWException.php:104

Html\errorBox
static errorBox( $html, $heading='', $className='')
Return an error box.
Definition: Html.php:739

$wgLang
$wgLang
Definition: Setup.php:857

MWException\msg
msg( $key, $fallback,... $params)
Get a message from i18n.
Definition: MWException.php:75

MWExceptionHandler\getRedactedTraceAsString
static getRedactedTraceAsString( $e)
Generate a string representation of an exception&#39;s stack trace.
Definition: MWExceptionHandler.php:352

Language

wfMsgReplaceArgs
wfMsgReplaceArgs( $message, $args)
Replace message parameter keys on the given formatted output.
Definition: GlobalFunctions.php:1299

HttpStatus\header
static header( $code)
Output an HTTP status code header.
Definition: HttpStatus.php:96

wfHttpError
wfHttpError( $code, $label, $desc)
Provide a simple HTTP error.
Definition: GlobalFunctions.php:1659

MWExceptionHandler\getURL
static getURL()
If the exception occurred in the course of responding to a request, returns the requested URL...
Definition: MWExceptionHandler.php:443

$GLOBALS
$GLOBALS['IP']
Definition: ComposerHookHandler.php:6

$header
$header
Definition: updateCredits.php:41

MWException\isCommandLine
static isCommandLine()
Check whether we are in command line mode or not to report the exception in the correct format...
Definition: MWException.php:241

MWException\getText
getText()
Get the text to display when reporting the error on the command line.
Definition: MWException.php:139

$fallback
$fallback
Definition: MessagesAb.php:11

MWException\useOutputPage
useOutputPage()
Should the exception use $wgOut to output the error?
Definition: MWException.php:32

MWException\reportHTML
reportHTML()
Output the exception report using HTML.
Definition: MWException.php:163

MWException\report
report()
Output a report about the exception and takes care of formatting.
Definition: MWException.php:202

$wgOut
$wgOut
Definition: Setup.php:862

MWException\header
static header( $header)
Send a header, if we haven&#39;t already sent them.
Definition: MWException.php:250

wfMessage
wfMessage( $key,... $params)
This is the function for getting translated interface messages.
Definition: GlobalFunctions.php:1264

MWException

MWException\writeToCommandLine
writeToCommandLine( $message)
Write a message to stderr falling back to stdout if stderr unavailable.
Definition: MWException.php:226

Exception