X-Git-Url: https://git.cyclocoop.org/%27.WWW_URL.%27admin/?a=blobdiff_plain;f=includes%2FException.php;h=432b768af26befcf3dc4971a27f070d6603382c0;hb=610db6c3387632b2c4a2a51f7c6c774c046e5153;hp=a5e86cdc05796c639e8c0d6256e2b7467dde91c2;hpb=7e995c96f770e96b1847aa676e35651689f46e4c;p=lhc%2Fweb%2Fwiklou.git diff --git a/includes/Exception.php b/includes/Exception.php index a5e86cdc05..432b768af2 100644 --- a/includes/Exception.php +++ b/includes/Exception.php @@ -22,7 +22,7 @@ class MWException extends Exception { function useOutputPage() { return $this->useMessageCache() && !empty( $GLOBALS['wgFullyInitialised'] ) && - ( !empty( $GLOBALS['wgArticle'] ) || ( !empty( $GLOBALS['wgOut'] ) && !$GLOBALS['wgOut']->isArticle() ) ) && + !empty( $GLOBALS['wgOut'] ) && !empty( $GLOBALS['wgTitle'] ); } @@ -39,7 +39,7 @@ class MWException extends Exception { } } - return is_object( $wgLang ); + return $wgLang instanceof Language; } /** @@ -88,7 +88,7 @@ class MWException extends Exception { $args = array_slice( func_get_args(), 2 ); if ( $this->useMessageCache() ) { - return wfMsgReal( $key, $args ); + return wfMsgNoTrans( $key, $args ); } else { return wfMsgReplaceArgs( $fallback, $args ); } @@ -133,13 +133,8 @@ class MWException extends Exception { /* Return titles of this error page */ function getPageTitle() { - if ( $this->useMessageCache() ) { - return wfMsg( 'internalerror' ); - } else { - global $wgSitename; - - return "$wgSitename error"; - } + global $wgSitename; + return $this->msg( 'internalerror', "$wgSitename error" ); } /** @@ -155,7 +150,7 @@ class MWException extends Exception { $line = $this->getLine(); $message = $this->getMessage(); - if ( isset( $wgRequest ) ) { + if ( isset( $wgRequest ) && !$wgRequest instanceof FauxRequest ) { $url = $wgRequest->getRequestURL(); if ( !$url ) { $url = '[no URL]'; @@ -170,7 +165,6 @@ class MWException extends Exception { /** Output the exception report using HTML */ function reportHTML() { global $wgOut; - if ( $this->useOutputPage() ) { $wgOut->setPageTitle( $this->getPageTitle() ); $wgOut->setRobotPolicy( "noindex,nofollow" ); @@ -179,7 +173,8 @@ class MWException extends Exception { $wgOut->redirect( '' ); $wgOut->clearHTML(); - if ( $hookResult = $this->runHooks( get_class( $this ) ) ) { + $hookResult = $this->runHooks( get_class( $this ) ); + if ( $hookResult ) { $wgOut->addHTML( $hookResult ); } else { $wgOut->addHTML( $this->getHTML() ); @@ -187,17 +182,13 @@ class MWException extends Exception { $wgOut->output(); } else { - if ( $hookResult = $this->runHooks( get_class( $this ) . "Raw" ) ) { + $hookResult = $this->runHooks( get_class( $this ) . "Raw" ); + if ( $hookResult ) { die( $hookResult ); } - if ( defined( 'MEDIAWIKI_INSTALL' ) || $this->htmlBodyOnly() ) { - echo $this->getHTML(); - } else { - echo $this->htmlHeader(); - echo $this->getHTML(); - echo $this->htmlFooter(); - } + echo $this->getHTML(); + die(1); } } @@ -213,53 +204,14 @@ class MWException extends Exception { } if ( self::isCommandLine() ) { - wfPrintError( $this->getText() ); + MWExceptionHandler::printError( $this->getText() ); } else { $this->reportHTML(); } } - /** - * Send headers and output the beginning of the html page if not using - * $wgOut to output the exception. - */ - function htmlHeader() { - global $wgLogo, $wgOutputEncoding; - - 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' ); - } - - $title = $this->getPageTitle(); - return " - - $title - - -

$title

- "; - } - - /** - * print the end of the html page if not using $wgOut. - */ - function htmlFooter() { - return ""; - } - - /** - * headers handled by subclass? - */ - function htmlBodyOnly() { - return false; - } - static function isCommandLine() { - return !empty( $GLOBALS['wgCommandLineMode'] ) && !defined( 'MEDIAWIKI_INSTALL' ); + return !empty( $GLOBALS['wgCommandLineMode'] ); } } @@ -279,122 +231,302 @@ class FatalError extends MWException { } /** + * An error page which can definitely be safely rendered using the OutputPage * @ingroup Exception */ class ErrorPageError extends MWException { - public $title, $msg; + public $title, $msg, $params; /** * Note: these arguments are keys into wfMsg(), not text! */ - function __construct( $title, $msg ) { + function __construct( $title, $msg, $params = null ) { $this->title = $title; $this->msg = $msg; - parent::__construct( wfMsg( $msg ) ); + $this->params = $params; + + if( $msg instanceof Message ){ + parent::__construct( $msg ); + } else { + parent::__construct( wfMsg( $msg ) ); + } } function report() { global $wgOut; - $wgOut->showErrorPage( $this->title, $this->msg ); + $wgOut->showErrorPage( $this->title, $this->msg, $this->params ); $wgOut->output(); } } /** - * Install an exception handler for MediaWiki exception types. + * Show an error when a user tries to do something they do not have the necessary + * permissions for. + * @ingroup Exception */ -function wfInstallExceptionHandler() { - set_exception_handler( 'wfExceptionHandler' ); +class PermissionsError extends ErrorPageError { + public $permission; + + function __construct( $permission ) { + global $wgLang; + + $this->permission = $permission; + + $groups = array_map( + array( 'User', 'makeGroupLinkWiki' ), + User::getGroupsWithPermission( $this->permission ) + ); + + if( $groups ) { + parent::__construct( + 'badaccess', + 'badaccess-groups', + array( + $wgLang->commaList( $groups ), + count( $groups ) + ) + ); + } else { + parent::__construct( + 'badaccess', + 'badaccess-group0' + ); + } + } } /** - * Report an exception to the user + * Show an error when the wiki is locked/read-only and the user tries to do + * something that requires write access + * @ingroup Exception */ -function wfReportException( Exception $e ) { - global $wgShowExceptionDetails; - - $cmdLine = MWException::isCommandLine(); +class ReadOnlyError extends ErrorPageError { + public function __construct(){ + parent::__construct( + 'readonly', + 'readonlytext', + wfReadOnlyReason() + ); + } +} - if ( $e instanceof MWException ) { - try { - $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"; +/** + * Show an error when the user hits a rate limit + * @ingroup Exception + */ +class ThrottledError extends ErrorPageError { + public function __construct(){ + parent::__construct( + 'actionthrottled', + 'actionthrottledtext' + ); + } + public function report(){ + global $wgOut; + $wgOut->setStatusCode( 503 ); + return parent::report(); + } +} - 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."; - } +/** + * Show an error when the user tries to do something whilst blocked + * @ingroup Exception + */ +class UserBlockedError extends ErrorPageError { + public function __construct( Block $block ){ + global $wgLang, $wgRequest; - $message .= "\n"; + $blockerUserpage = $block->getBlocker()->getUserPage(); + $link = "[[{$blockerUserpage->getPrefixedText()}|{$blockerUserpage->getText()}]]"; - if ( $cmdLine ) { - wfPrintError( $message ); - } else { - echo nl2br( htmlspecialchars( $message ) ) . "\n"; - } + $reason = $block->mReason; + if( $reason == '' ) { + $reason = wfMsg( 'blockednoreason' ); } - } else { - $message = "Unexpected non-MediaWiki exception encountered, of type \"" . get_class( $e ) . "\"\n" . - $e->__toString() . "\n"; - if ( $wgShowExceptionDetails ) { - $message .= "\n" . $e->getTraceAsString() . "\n"; + /* $ip returns who *is* being blocked, $intended contains who was meant to be blocked. + * This could be a username, an IP range, or a single IP. */ + $intended = $block->getTarget(); + + parent::__construct( + 'blockedtitle', + $block->mAuto ? 'autoblockedtext' : 'blockedtext', + array( + $link, + $reason, + $wgRequest->getIP(), + $block->getBlocker()->getName(), + $block->getId(), + $wgLang->formatExpiry( $block->mExpiry ), + $intended, + $wgLang->timeanddate( wfTimestamp( TS_MW, $block->mTimestamp ), true ) + ) + ); + } +} + +/** + * Show an error that looks like an HTTP server error. + * Replacement for wfHttpError(). + * + * @ingroup Exception + */ +class HttpError extends MWException { + private $httpCode, $header, $content; + + /** + * Constructor + * + * @param $httpCode Integer: HTTP status code to send to the client + * @param $content String|Message: content of the message + * @param $header String|Message: content of the header (\ and \) + */ + public function __construct( $httpCode, $content, $header = null ){ + parent::__construct( $content ); + $this->httpCode = (int)$httpCode; + $this->header = $header; + $this->content = $content; + } + + public function reportHTML() { + $httpMessage = HttpStatus::getMessage( $this->httpCode ); + + header( "Status: {$this->httpCode} {$httpMessage}" ); + header( 'Content-type: text/html; charset=utf-8' ); + + if ( $this->header === null ) { + $header = $httpMessage; + } elseif ( $this->header instanceof Message ) { + $header = $this->header->escaped(); + } else { + $header = htmlspecialchars( $this->header ); } - if ( $cmdLine ) { - wfPrintError( $message ); + if ( $this->content instanceof Message ) { + $content = $this->content->escaped(); } else { - echo nl2br( htmlspecialchars( $message ) ) . "\n"; + $content = htmlspecialchars( $this->content ); } + + print "\n". + "$header\n" . + "

$header

$content

\n"; } } /** - * Print a message, if possible to STDERR. - * Use this in command line mode only (see isCommandLine) + * Handler class for MWExceptions + * @ingroup Exception */ -function wfPrintError( $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 ); +class MWExceptionHandler { + /** + * Install an exception handler for MediaWiki exception types. + */ + public static function installHandler() { + set_exception_handler( array( 'MWExceptionHandler', 'handle' ) ); } -} -/** - * Exception handler which simulates the appropriate catch() handling: - * - * try { - * ... - * } catch ( MWException $e ) { - * $e->report(); - * } catch ( Exception $e ) { - * echo $e->__toString(); - * } - */ -function wfExceptionHandler( $e ) { - global $wgFullyInitialised; + /** + * Report an exception to the user + */ + protected static function report( Exception $e ) { + global $wgShowExceptionDetails; - wfReportException( $e ); + $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 ); + } + } - // Final cleanup - if ( $wgFullyInitialised ) { - try { - wfLogProfilingData(); // uses $wgRequest, hence the $wgFullyInitialised condition - } catch ( Exception $e ) {} + /** + * Print a message after escaping it and converting newlines to
+ * Use this for non-command line failures + * @param $message String Failure text + */ + private static function escapeEchoAndDie( $message ) { + echo nl2br( htmlspecialchars( $message ) ) . "\n"; + die(1); } - // Exit value should be nonzero for the benefit of shell jobs - exit( 1 ); + /** + * Exception handler which simulates the appropriate catch() handling: + * + * try { + * ... + * } catch ( MWException $e ) { + * $e->report(); + * } catch ( Exception $e ) { + * echo $e->__toString(); + * } + */ + public static function handle( $e ) { + global $wgFullyInitialised; + + self::report( $e ); + + // Final cleanup + if ( $wgFullyInitialised ) { + try { + wfLogProfilingData(); // uses $wgRequest, hence the $wgFullyInitialised condition + } catch ( Exception $e ) {} + } + + // Exit value should be nonzero for the benefit of shell jobs + exit( 1 ); + } }