* Remove Exception.php's reliance on wfDie(), as well as the awful constant MEDIAWIKI...
[lhc/web/wiklou.git] / includes / Exception.php
index 0e07194..8cce9a0 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']->isArticleRelated() ) ) &&
+                       !empty( $GLOBALS['wgOut'] ) &&
                        !empty( $GLOBALS['wgTitle'] );
        }
 
@@ -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" );
        }
 
        /**
@@ -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" );
@@ -193,13 +187,8 @@ class MWException extends Exception {
                                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);
                }
        }
 
@@ -215,83 +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, $wgLang;
-
-               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' );
-               }
-
-               $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' => '' ), $this->getPageTitle() );
-
-               $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.
-        */
-       function htmlFooter() {
-               return Html::closeElement( 'body' ) . Html::closeElement( 'html' );
-       }
-
-       /**
-        * headers handled by subclass?
-        */
-       function htmlBodyOnly() {
-               return false;
-       }
-
        static function isCommandLine() {
-               return !empty( $GLOBALS['wgCommandLineMode'] ) && !defined( 'MEDIAWIKI_INSTALL' );
+               return !empty( $GLOBALS['wgCommandLineMode'] );
        }
 }
 
@@ -360,6 +280,7 @@ class ErrorPageError extends MWException {
 /**
  * Show an error when a user tries to do something they do not have the necessary
  * permissions for.
+ * @ingroup Exception
  */
 class PermissionsError extends ErrorPageError {
        public $permission;
@@ -395,6 +316,7 @@ class PermissionsError extends ErrorPageError {
 /**
  * Show an error when the wiki is locked/read-only and the user tries to do
  * something that requires write access
+ * @ingroup Exception
  */
 class ReadOnlyError extends ErrorPageError {
        public function __construct(){
@@ -408,6 +330,7 @@ class ReadOnlyError extends ErrorPageError {
 
 /**
  * Show an error when the user hits a rate limit
+ * @ingroup Exception
  */
 class ThrottledError extends ErrorPageError {
        public function __construct(){
@@ -425,6 +348,7 @@ class ThrottledError extends ErrorPageError {
 
 /**
  * Show an error when the user tries to do something whilst blocked
+ * @ingroup Exception
  */
 class UserBlockedError extends ErrorPageError {
        public function __construct( Block $block ){
@@ -460,100 +384,117 @@ class UserBlockedError extends ErrorPageError {
 }
 
 /**
- * Install an exception handler for MediaWiki exception types.
- */
-function wfInstallExceptionHandler() {
-       set_exception_handler( 'wfExceptionHandler' );
-}
-
-/**
- * Report an exception to the user
+ * Handler class for MWExceptions
+ * @ingroup Exception
  */
-function wfReportException( Exception $e ) {
-       global $wgShowExceptionDetails;
+class MWExceptionHandler {
+       /**
+        * Install an exception handler for MediaWiki exception types.
+        */
+       public static function installHandler() {
+               set_exception_handler( array( 'MWExceptionHandler', 'handle' ) );
+       }
 
-       $cmdLine = MWException::isCommandLine();
+       /**
+        * Report an exception to the user
+        */
+       protected static function report( Exception $e ) {
+               global $wgShowExceptionDetails;
 
-       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";
+               $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 .= '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" . $e->getTraceAsString() . "\n";
                        }
 
-                       $message .= "\n";
-
                        if ( $cmdLine ) {
-                               wfPrintError( $message );
+                               self::printError( $message );
                        } else {
-                               wfDie( htmlspecialchars( $message ) ) . "\n";
+                               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 ) {
-                       wfPrintError( $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 {
-                       wfDie( htmlspecialchars( $message ) ) . "\n";
+                       echo( $message );
                }
        }
-}
 
-/**
- * Print a message, if possible to STDERR.
- * 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).
-       #      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 <br>
+        * Use this for non-command line failures
+        * @param $message String Failure text
+        */
+       private static function escapeEchoAndDie( $message ) {
+               echo nl2br( htmlspecialchars( $message ) ) . "\n";
+               die(1);
        }
-}
 
-/**
- * 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;
+       /**
       * 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;
 
-       wfReportException( $e );
+               self::report( $e );
 
-       // Final cleanup
-       if ( $wgFullyInitialised ) {
-               try {
-                       wfLogProfilingData(); // uses $wgRequest, hence the $wgFullyInitialised condition
-               } catch ( Exception $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 );
+               // Exit value should be nonzero for the benefit of shell jobs
+               exit( 1 );
+       }
 }