X-Git-Url: https://git.heureux-cyclage.org/?a=blobdiff_plain;ds=sidebyside;f=includes%2FException.php;h=8c4e0a754fa15be1e26e064304cae17798edd3e7;hb=a40a045f5f04a6287e90d46555956698abaa0025;hp=eeb45594a0e3975658a65b8de57d5964d95eda79;hpb=29946e5f61624bac681e828c2b52509fcf2a3e11;p=lhc%2Fweb%2Fwiklou.git diff --git a/includes/Exception.php b/includes/Exception.php index eeb45594a0..8c4e0a754f 100644 --- a/includes/Exception.php +++ b/includes/Exception.php @@ -1,193 +1,549 @@ useMessageCache() && + !empty( $GLOBALS['wgFullyInitialised'] ) && + !empty( $GLOBALS['wgOut'] ) && + !empty( $GLOBALS['wgTitle'] ); } + /** + * Can the extension use wfMsg() to get i18n messages ? + * @return bool + */ function useMessageCache() { global $wgLang; - return is_object( $wgLang ); + + foreach ( $this->getTrace() as $frame ) { + if ( isset( $frame['class'] ) && $frame['class'] === 'LocalisationCache' ) { + return false; + } + } + + return $wgLang instanceof Language; + } + + /** + * Run hook to allow extensions to modify the text of the exception + * + * @param $name String: class name of the exception + * @param $args Array: arguments to pass to the callback functions + * @return Mixed: string to output or null if any hook has been called + */ + function runHooks( $name, $args = array() ) { + global $wgExceptionHooks; + + if ( !isset( $wgExceptionHooks ) || !is_array( $wgExceptionHooks ) ) { + return; // Just silently ignore + } + + if ( !array_key_exists( $name, $wgExceptionHooks ) || !is_array( $wgExceptionHooks[ $name ] ) ) { + return; + } + + $hooks = $wgExceptionHooks[ $name ]; + $callargs = array_merge( array( $this ), $args ); + + foreach ( $hooks as $hook ) { + if ( is_string( $hook ) || ( is_array( $hook ) && count( $hook ) >= 2 && is_string( $hook[0] ) ) ) { // 'function' or array( 'class', hook' ) + $result = call_user_func_array( $hook, $callargs ); + } else { + $result = null; + } + + if ( is_string( $result ) ) { + return $result; + } + } } + /** + * Get a message from i18n + * + * @param $key String: message name + * @param $fallback String: 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 + * @return String message with arguments replaced + */ function msg( $key, $fallback /*[, params...] */ ) { $args = array_slice( func_get_args(), 2 ); + if ( $this->useMessageCache() ) { - return wfMsgReal( $key, $args ); + return wfMsgNoTrans( $key, $args ); } else { return wfMsgReplaceArgs( $fallback, $args ); } } - + + /** + * 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. + * + * @return String html to output + */ function getHTML() { - return '
' . htmlspecialchars( $this->getMessage() ) . - '
Backtrace:
' . nl2br( htmlspecialchars( $this->getTraceAsString() ) ) . - "
\n"; + global $wgShowExceptionDetails; + + if ( $wgShowExceptionDetails ) { + return '' . nl2br( htmlspecialchars( $this->getMessage() ) ) . + '
Backtrace:
' . nl2br( htmlspecialchars( $this->getTraceAsString() ) ) . + "
\n"; + } else { + return "Set \$wgShowExceptionDetails = true; " . + "at the bottom of LocalSettings.php to show detailed " . + "debugging information.
"; + } } + /** + * If $wgShowExceptionDetails is true, return a text message with a + * backtrace to the error. + * @return string + */ function getText() { - return $this->getMessage() . - "\nBacktrace:\n" . $this->getTraceAsString() . "\n"; + global $wgShowExceptionDetails; + + if ( $wgShowExceptionDetails ) { + return $this->getMessage() . + "\nBacktrace:\n" . $this->getTraceAsString() . "\n"; + } else { + return "Set \$wgShowExceptionDetails = true; " . + "in LocalSettings.php to show detailed debugging information.\n"; + } } - + + /** + * Return titles of this error page + * @return String + */ function getPageTitle() { - if ( $this->useMessageCache() ) { - return wfMsg( 'internalerror' ); + return $this->msg( 'internalerror', "Internal error" ); + } + + /** + * Return the requested URL and point to file and line number from which the + * exception occured + * + * @return String + */ + function getLogMessage() { + global $wgRequest; + + $file = $this->getFile(); + $line = $this->getLine(); + $message = $this->getMessage(); + + if ( isset( $wgRequest ) && !$wgRequest instanceof FauxRequest ) { + $url = $wgRequest->getRequestURL(); + if ( !$url ) { + $url = '[no URL]'; + } } else { - global $wgSitename; - return "$wgSitename error"; + $url = '[no req]'; } + + return "$url Exception from line $line of $file: $message"; } - + + /** Output the exception report using HTML */ function reportHTML() { global $wgOut; if ( $this->useOutputPage() ) { - $wgOut->setPageTitle( $this->getPageTitle() ); - $wgOut->setRobotpolicy( "noindex,nofollow" ); - $wgOut->setArticleRelated( false ); - $wgOut->enableClientCache( false ); - $wgOut->redirect( '' ); - $wgOut->clearHTML(); - $wgOut->addHTML( $this->getHTML() ); + $wgOut->prepareErrorPage( $this->getPageTitle() ); + + $hookResult = $this->runHooks( get_class( $this ) ); + if ( $hookResult ) { + $wgOut->addHTML( $hookResult ); + } else { + $wgOut->addHTML( $this->getHTML() ); + } + $wgOut->output(); } else { - echo $this->htmlHeader(); + $hookResult = $this->runHooks( get_class( $this ) . "Raw" ); + if ( $hookResult ) { + die( $hookResult ); + } + echo $this->getHTML(); - echo $this->htmlFooter(); + die(1); } } - - function reportText() { - echo $this->getText(); - } + /** + * Output a report about the exception and takes care of formatting. + * It will be either HTML or plain text based on isCommandLine(). + */ function report() { - global $wgCommandLineMode; - if ( $wgCommandLineMode ) { - $this->reportText(); - } else { - $this->reportHTML(); - } - } + $log = $this->getLogMessage(); - function htmlHeader() { - global $wgLogo, $wgSitename, $wgOutputEncoding; + if ( $log ) { + wfDebugLog( 'exception', $log ); + } - if ( !headers_sent() ) { - header( 'HTTP/1.0 500 Internal Server Error' ); - header( 'Content-type: text/html; charset='.$wgOutputEncoding ); - /* Don't cache error pages! They cause no end of trouble... */ - header( 'Cache-control: none' ); - header( 'Pragma: nocache' ); + if ( self::isCommandLine() ) { + MWExceptionHandler::printError( $this->getText() ); + } else { + $this->reportHTML(); } - $title = $this->getPageTitle(); - echo " - -$content
\n"; + } } -?> +/** + * Handler class for MWExceptions + * @ingroup Exception + */ +class MWExceptionHandler { + /** + * Install an exception handler for MediaWiki exception types. + */ + public static function installHandler() { + set_exception_handler( array( 'MWExceptionHandler', 'handle' ) ); + } + + /** + * Report an exception to the user + */ + protected static function report( Exception $e ) { + global $wgShowExceptionDetails; + + $cmdLine = MWException::isCommandLine(); + + if ( $e instanceof MWException ) { + try { + // Try and show the exception prettily, with the normal skin infrastructure + $e->report(); + } catch ( Exception $e2 ) { + // Exception occurred from within exception handler + // Show a simpler error message for the original exception, + // don't try to invoke report() + $message = "MediaWiki internal error.\n\n"; + + if ( $wgShowExceptionDetails ) { + $message .= 'Original exception: ' . $e->__toString() . "\n\n" . + 'Exception caught inside exception handler: ' . $e2->__toString(); + } else { + $message .= "Exception caught inside exception handler.\n\n" . + "Set \$wgShowExceptionDetails = true; at the bottom of LocalSettings.php " . + "to show detailed debugging information."; + } + + $message .= "\n"; + + if ( $cmdLine ) { + self::printError( $message ); + } else { + self::escapeEchoAndDie( $message ); + } + } + } else { + $message = "Unexpected non-MediaWiki exception encountered, of type \"" . get_class( $e ) . "\"\n" . + $e->__toString() . "\n"; + + if ( $wgShowExceptionDetails ) { + $message .= "\n" . $e->getTraceAsString() . "\n"; + } + + if ( $cmdLine ) { + self::printError( $message ); + } else { + self::escapeEchoAndDie( $message ); + } + } + } + + /** + * Print a message, if possible to STDERR. + * Use this in command line mode only (see isCommandLine) + * @param $message String Failure text + */ + public static function printError( $message ) { + # NOTE: STDERR may not be available, especially if php-cgi is used from the command line (bug #15602). + # Try to produce meaningful output anyway. Using echo may corrupt output to STDOUT though. + if ( defined( 'STDERR' ) ) { + fwrite( STDERR, $message ); + } else { + echo( $message ); + } + } + + /** + * Print a message after escaping it and converting newlines to