MWException.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Exception;
 
use Exception;
use LocalisationCache;
use MediaWiki\Debug\MWDebug;
use Wikimedia\Message\MessageParam;
use Wikimedia\Message\MessageSpecifier;
 
class MWException extends Exception {
 
    public function isLoggable() {
        return true;
    }
 
    public function useMessageCache() {
        foreach ( $this->getTrace() as $frame ) {
            if ( isset( $frame['class'] ) && $frame['class'] === LocalisationCache::class ) {
                return false;
            }
        }
        return true;
    }
 
    public function msg( $key, $fallback, ...$params ) {
        // NOTE: Keep logic in sync with MWExceptionRenderer::msg.
        $res = false;
        if ( $this->useMessageCache() ) {
            try {
                $res = wfMessage( $key, ...$params )->text();
            } catch ( Exception $e ) {
            }
        }
        if ( $res === false ) {
            // Fallback to static message text and generic sitename.
            // Avoid live config as this must work before Setup/MediaWikiServices finish.
            $res = wfMsgReplaceArgs( $fallback, $params );
            $res = strtr( $res, [
                '{{SITENAME}}' => 'MediaWiki',
            ] );
        }
        return $res;
    }
 
    public function report() {
        // May be overridden by subclasses to replace the whole error page
        MWExceptionRenderer::output( $this, MWExceptionRenderer::AS_PRETTY );
    }
 
    final public function hasOverriddenHandler(): bool {
        return MWDebug::detectDeprecatedOverride( $this, __CLASS__, 'report' );
    }
 
    public static function isCommandLine() {
        return MW_ENTRY_POINT === 'cli';
    }
 
}
 
class_alias( MWException::class, 'MWException' );