(bug 28978) jquery.autoEllipsis cache doesn't take position into account, leads to...
[lhc/web/wiklou.git] / includes / Exception.php
index 0b77322..4c7fb6e 100644 (file)
@@ -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['wgArticle'] ) || ( !empty( $GLOBALS['wgOut'] ) && !$GLOBALS['wgOut']->isArticleRelated() ) ) &&
                        !empty( $GLOBALS['wgTitle'] );
        }
 
@@ -32,12 +32,14 @@ class MWException extends Exception {
         */
        function useMessageCache() {
                global $wgLang;
+
                foreach ( $this->getTrace() as $frame ) {
                        if ( isset( $frame['class'] ) && $frame['class'] === 'LocalisationCache' ) {
                                return false;
                        }
                }
-               return is_object( $wgLang );
+
+               return $wgLang instanceof Language;
        }
 
        /**
@@ -49,20 +51,26 @@ class MWException extends Exception {
         */
        function runHooks( $name, $args = array() ) {
                global $wgExceptionHooks;
-               if( !isset( $wgExceptionHooks ) || !is_array( $wgExceptionHooks ) )
+
+               if ( !isset( $wgExceptionHooks ) || !is_array( $wgExceptionHooks ) ) {
                        return; // Just silently ignore
-               if( !array_key_exists( $name, $wgExceptionHooks ) || !is_array( $wgExceptionHooks[ $name ] ) )
+               }
+
+               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' )
+               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 ) )
+
+                       if ( is_string( $result ) )
                                return $result;
                }
        }
@@ -78,8 +86,9 @@ class MWException extends Exception {
         */
        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 );
                }
@@ -94,7 +103,8 @@ class MWException extends Exception {
         */
        function getHTML() {
                global $wgShowExceptionDetails;
-               if( $wgShowExceptionDetails ) {
+
+               if ( $wgShowExceptionDetails ) {
                        return '<p>' . nl2br( htmlspecialchars( $this->getMessage() ) ) .
                                '</p><p>Backtrace:</p><p>' . nl2br( htmlspecialchars( $this->getTraceAsString() ) ) .
                                "</p>\n";
@@ -111,7 +121,8 @@ class MWException extends Exception {
         */
        function getText() {
                global $wgShowExceptionDetails;
-               if( $wgShowExceptionDetails ) {
+
+               if ( $wgShowExceptionDetails ) {
                        return $this->getMessage() .
                                "\nBacktrace:\n" . $this->getTraceAsString() . "\n";
                } else {
@@ -122,12 +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" );
        }
 
        /**
@@ -138,9 +145,11 @@ class MWException extends Exception {
         */
        function getLogMessage() {
                global $wgRequest;
+
                $file = $this->getFile();
                $line = $this->getLine();
                $message = $this->getMessage();
+
                if ( isset( $wgRequest ) ) {
                        $url = $wgRequest->getRequestURL();
                        if ( !$url ) {
@@ -156,6 +165,7 @@ 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" );
@@ -163,22 +173,26 @@ class MWException extends Exception {
                        $wgOut->enableClientCache( false );
                        $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() );
                        }
+
                        $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();
+
+                       $html = $this->getHTML();
+                       if ( defined( 'MEDIAWIKI_INSTALL' ) ) {
+                               echo $html;
                        } else {
-                               echo $this->htmlHeader();
-                               echo $this->getHTML();
-                               echo $this->htmlFooter();
+                               wfDie( $html );
                        }
                }
        }
@@ -189,9 +203,11 @@ class MWException extends Exception {
         */
        function report() {
                $log = $this->getLogMessage();
+
                if ( $log ) {
                        wfDebugLog( 'exception', $log );
                }
+
                if ( self::isCommandLine() ) {
                        wfPrintError( $this->getText() );
                } else {
@@ -202,39 +218,65 @@ class MWException extends Exception {
        /**
         * Send headers and output the beginning of the html page if not using
         * $wgOut to output the exception.
+        * @deprecated since 1.18 call wfDie() if you need to die immediately
         */
        function htmlHeader() {
-               global $wgLogo, $wgOutputEncoding;
+               global $wgLogo, $wgLang;
 
                if ( !headers_sent() ) {
                        header( 'HTTP/1.0 500 Internal Server Error' );
-                       header( 'Content-type: text/html; charset='.$wgOutputEncoding );
+                       header( 'Content-type: text/html; charset=UTF-8' );
                        /* Don't cache error pages!  They cause no end of trouble... */
                        header( 'Cache-control: none' );
                        header( 'Pragma: nocache' );
                }
-               $title = $this->getPageTitle();
-               return "<html>
-               <head>
-               <title>$title</title>
-               </head>
-               <body>
-               <h1><img src='$wgLogo' style='float:left;margin-right:1em' alt=''/>$title</h1>
-               ";
+
+               $head = Html::element( 'title', null, $this->getPageTitle() ) . "\n";
+               $head .= Html::inlineStyle( <<<ENDL
+       body {
+               color: #000;
+               background-color: #fff;
+               font-family: sans-serif;
+               padding: 2em;
+               text-align: center;
+       }
+       p, img, h1 {
+               text-align: left;
+               margin: 0.5em 0;
+       }
+       h1 {
+               font-size: 120%;
+       }
+ENDL
+               );
+
+               $dir = 'ltr';
+               $code = 'en';
+
+               if ( $wgLang instanceof Language ) {
+                       $dir = $wgLang->getDir();
+                       $code = $wgLang->getCode();
+               }
+
+               $header = Html::element( 'img', array(
+                       'src' => $wgLogo,
+                       'alt' => '' ) );
+
+               $attribs = array( 'dir' => $dir, 'lang' => $code );
+
+               return
+                       Html::htmlHeader( $attribs ) .
+                       Html::rawElement( 'head', null, $head ) . "\n".
+                       Html::openElement( 'body' ) . "\n" .
+                       $header . "\n";
        }
 
        /**
         * print the end of the html page if not using $wgOut.
+        * @deprecated since 1.18
         */
        function htmlFooter() {
-               return "</body></html>";
-       }
-       
-       /**
-        * headers handled by subclass?
-        */
-       function htmlBodyOnly() {
-               return false;
+               return Html::closeElement( 'body' ) . Html::closeElement( 'html' );
        }
 
        static function isCommandLine() {
@@ -258,27 +300,154 @@ 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 );
+
+               if ( $wgOut->getTitle() ) {
+                       $wgOut->debug( 'Original title: ' . $wgOut->getTitle()->getPrefixedText() . "\n" );
+               }
+               $wgOut->setPageTitle( wfMsg( $this->title ) );
+               $wgOut->setHTMLTitle( wfMsg( 'errorpagetitle' ) );
+               $wgOut->setRobotPolicy( 'noindex,nofollow' );
+               $wgOut->setArticleRelated( false );
+               $wgOut->enableClientCache( false );
+               $wgOut->mRedirect = '';
+               $wgOut->clearHTML();
+
+               if( $this->msg instanceof Message ){
+                       $wgOut->addHTML( $this->msg->parse() );
+               } else {
+                       $wgOut->addWikiMsgArray( $this->msg, $this->params );
+               }
+
+               $wgOut->returnToMain();
                $wgOut->output();
        }
 }
 
+/**
+ * Show an error when a user tries to do something they do not have the necessary
+ * permissions for.
+ */
+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'
+                       );
+               }
+       }
+}
+
+/**
+ * Show an error when the wiki is locked/read-only and the user tries to do
+ * something that requires write access
+ */
+class ReadOnlyError extends ErrorPageError {
+       public function __construct(){
+               parent::__construct(
+                       'readonly',
+                       'readonlytext',
+                       wfReadOnlyReason()
+               );
+       }
+}
+
+/**
+ * Show an error when the user hits a rate limit
+ */
+class ThrottledError extends ErrorPageError {
+       public function __construct(){
+               parent::__construct(
+                       'actionthrottled',
+                       'actionthrottledtext'
+               );
+       }
+       public function report(){
+               global $wgOut;
+               $wgOut->setStatusCode( 503 );
+               return parent::report();
+       }
+}
+
+/**
+ * Show an error when the user tries to do something whilst blocked
+ */
+class UserBlockedError extends ErrorPageError {
+       public function __construct( Block $block ){
+               global $wgLang;
+
+               $blockerUserpage = $block->getBlocker()->getUserPage();
+               $link = "[[{$blockerUserpage->getPrefixedText()}|{$blockerUserpage->getText()}]]";
+
+               $reason = $block->mReason;
+               if( $reason == '' ) {
+                       $reason = wfMsg( 'blockednoreason' );
+               }
+
+               /* $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 ? 'autoblocketext' : 'blockedtext',
+                       array(
+                               $link,
+                               $reason,
+                               wfGetIP(),
+                               $block->getBlocker()->getName(),
+                               $block->getId(),
+                               $wgLang->formatExpiry( $block->mExpiry ),
+                               $intended,
+                               $wgLang->timeanddate( wfTimestamp( TS_MW, $block->mTimestamp ), true )
+                       )
+               );
+       }
+}
+
 /**
  * Install an exception handler for MediaWiki exception types.
  */
@@ -293,14 +462,17 @@ function wfReportException( 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();
@@ -309,23 +481,27 @@ function wfReportException( Exception $e ) {
                                        "Set \$wgShowExceptionDetails = true; at the bottom of LocalSettings.php " .
                                        "to show detailed debugging information.";
                        }
+
                        $message .= "\n";
+
                        if ( $cmdLine ) {
                                wfPrintError( $message );
                        } else {
-                               echo nl2br( htmlspecialchars( $message ) ). "\n";
+                               wfDie( nl2br( htmlspecialchars( $message ) ) ) . "\n";
                        }
                }
        } else {
                $message = "Unexpected non-MediaWiki exception encountered, of type \"" . get_class( $e ) . "\"\n" .
                        $e->__toString() . "\n";
+
                if ( $wgShowExceptionDetails ) {
-                       $message .= "\n" . $e->getTraceAsString() ."\n";
+                       $message .= "\n" . $e->getTraceAsString() . "\n";
                }
+
                if ( $cmdLine ) {
                        wfPrintError( $message );
                } else {
-                       echo nl2br( htmlspecialchars( $message ) ). "\n";
+                       wfDie( nl2br( htmlspecialchars( $message ) ) ) . "\n";
                }
        }
 }
@@ -335,7 +511,7 @@ function wfReportException( Exception $e ) {
  * Use this in command line mode only (see isCommandLine)
  */
 function wfPrintError( $message ) {
-       #NOTE: STDERR may not be available, especially if php-cgi is used from the command line (bug #15602).
+       # 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 );
@@ -357,9 +533,10 @@ function wfPrintError( $message ) {
  */
 function wfExceptionHandler( $e ) {
        global $wgFullyInitialised;
+
        wfReportException( $e );
 
-       // Final cleanup, similar to wfErrorExit()
+       // Final cleanup
        if ( $wgFullyInitialised ) {
                try {
                        wfLogProfilingData(); // uses $wgRequest, hence the $wgFullyInitialised condition