MissingExtensionException.php

Go to the documentation of this file.

<?php
 
namespace MediaWiki\Registration;
 
use Exception;
use MediaWiki\Html\TemplateParser;
use Wikimedia\Http\HttpStatus;
use Wikimedia\ObjectCache\EmptyBagOStuff;
 
class MissingExtensionException extends Exception {
    private bool $isSkin;
    private string $extName = 'unknown';
    private string $path;
    private string $error;
 
    public function __construct( string $path, string $error ) {
        $this->isSkin = str_ends_with( $path, "/skin.json" );
        $m = [];
        preg_match( "!/([^/]*)/[^/]*.json$!", $path, $m );
        if ( $m ) {
            $this->extName = $m[1];
        }
        $this->path = $path;
        $this->error = $error;
 
        parent::__construct( "Error Loading extension. Unable to open file $path: $error" );
    }
 
    private function renderHtml() {
        if ( !headers_sent() ) {
            HttpStatus::header( 500 );
            header( 'Content-Type: text/html; charset=UTF-8' );
        }
 
        $templateParser = new TemplateParser( null, new EmptyBagOStuff() );
 
        try {
            echo $templateParser->processTemplate(
                'ExtensionConfigError',
                [
                    'version' => MW_VERSION,
                    'path' => $this->path,
                    'type' => $this->isSkin ? 'skin' : 'extension',
                    'error' => $this->error,
                    'extName' => $this->extName,
                    'trace' => $this->getTraceAsString(),
                    'mwLogo' => $this->getMWLogo(),
                ]
            );
        } catch ( Exception $e ) {
            echo 'Error: ' . htmlspecialchars( $e->getMessage() );
        }
    }
 
    private function renderText() {
        $type = $this->isSkin ? 'skin' : 'extension';
        echo "Error: The $this->extName $type cannot be loaded. "
            . "Check that all of its files are installed properly.\n\n";
        echo $this->getTraceAsString();
        echo "\n";
    }
 
    public function render(): never {
        if ( wfIsCli() ) {
            $this->renderText();
        } else {
            $this->renderHtml();
        }
        // Make sure that the error gets into logs.
        error_log( $this->getMessage() );
        exit( 1 );
    }
 
    private function getMWLogo() {
        global $wgResourceBasePath;
        $suffix = "/resources/assets/mediawiki.png";
        if ( $wgResourceBasePath !== null ) {
            // We are early in setup, so we can't rely on this.
            return $wgResourceBasePath . $suffix;
        }
        $path = '/';
        foreach ( array_filter( explode( '/', $_SERVER['PHP_SELF'] ) ) as $part ) {
            if ( !preg_match( '/\.php$/', $part ) ) {
                $path .= "$part/";
            } else {
                break;
            }
        }
 
        return $path . $suffix;
    }
}
 
class_alias( MissingExtensionException::class, 'MissingExtensionException' );