'mbstring',
'xml_parser_create' => 'xml',
'ctype_digit' => 'ctype',
'json_decode' => 'json',
'iconv' => 'iconv',
'mime_content_type' => 'fileinfo',
);
/**
* @var string $format The format used for errors. One of "text" or "html"
*/
var $format = 'text';
/**
* @var string $scriptPath
*/
var $scriptPath = '/';
/**
* Set the format used for errors.
*
* @param string $format One of "text" or "html"
*/
function setFormat( $format ) {
$this->format = $format;
}
/**
* Set the script path used for images in HTML-formatted errors.
*
* @param string $scriptPath
*/
function setScriptPath( $scriptPath ) {
$this->scriptPath = $scriptPath;
}
/**
* Displays an error, if the installed PHP version does not meet the minimum requirement.
*/
function checkRequiredPHPVersion() {
$minimumVersion = '7.2.9';
if ( version_compare( PHP_VERSION, $minimumVersion ) < 0 ) {
$shortText = "MediaWiki $this->mwVersion requires at least PHP version $minimumVersion; "
. "you are using PHP " . PHP_VERSION . ".";
$longText = "Error: You might be using an older PHP version (PHP " . PHP_VERSION . ").\n"
. "MediaWiki $this->mwVersion needs PHP $minimumVersion or higher.\n\nCheck if you "
. "have a newer PHP executable with a different name.\n\n";
// phpcs:disable Generic.Files.LineLength
$longHtml = <<upgrading your copy of PHP.
PHP versions less than v7.1.0 are no longer supported by the PHP Group and will not receive
security or bugfix updates.
If for some reason you are unable to upgrade your PHP version, you will need to
download an older version of
MediaWiki from our website. See our
compatibility page
for details of which versions are compatible with prior versions of PHP.
HTML;
// phpcs:enable Generic.Files.LineLength
$this->triggerError(
"Supported PHP versions",
$shortText,
$longText,
$longHtml
);
}
}
/**
* Displays an error, if the vendor/autoload.php file could not be found.
*/
function checkVendorExistence() {
if ( !file_exists( dirname( __FILE__ ) . '/../vendor/autoload.php' ) ) {
$shortText = "Installing some external dependencies (e.g. via composer) is required.";
$longText = "Error: You are missing some external dependencies. \n"
. "MediaWiki also has some external dependencies that need to be installed\n"
. "via composer or from a separate git repo. Please see\n"
. "https://www.mediawiki.org/wiki/Download_from_Git#Fetch_external_libraries\n"
. "for help on installing the required components.";
// phpcs:disable Generic.Files.LineLength
$longHtml = <<mediawiki.org
for help on installing the required components.
HTML;
// phpcs:enable Generic.Files.LineLength
$this->triggerError( 'External dependencies', $shortText, $longText, $longHtml );
}
}
/**
* Displays an error, if a PHP extension does not exist.
*/
function checkExtensionExistence() {
$missingExtensions = array();
foreach ( $this->functionsExtensionsMapping as $function => $extension ) {
if ( !function_exists( $function ) ) {
$missingExtensions[] = $extension;
}
}
if ( $missingExtensions ) {
$shortText = "Installing some PHP extensions is required.";
$missingExtText = '';
$missingExtHtml = '';
$baseUrl = 'https://www.php.net';
foreach ( $missingExtensions as $ext ) {
$missingExtText .= " * $ext <$baseUrl/$ext>\n";
$missingExtHtml .= "
$ext "
. "(more information)";
}
$cliText = "Error: Missing one or more required components of PHP.\n"
. "You are missing a required extension to PHP that MediaWiki needs.\n"
. "Please install:\n" . $missingExtText;
$longHtml = <<
$missingExtHtml
HTML;
$this->triggerError( 'Required components', $shortText, $cliText, $longHtml );
}
}
/**
* Output headers that prevents error pages to be cached.
*/
function outputHTMLHeader() {
$protocol = isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0';
header( "$protocol 500 MediaWiki configuration Error" );
// Don't cache error pages! They cause no end of trouble...
header( 'Cache-control: none' );
header( 'Pragma: no-cache' );
}
/**
* Returns an error page, which is suitable for output to the end user via a web browser.
*
* @param string $title
* @param string $longHtml
* @param string $shortText
* @return string
*/
function getIndexErrorOutput( $title, $longHtml, $shortText ) {
$encLogo =
htmlspecialchars( str_replace( '//', '/', $this->scriptPath . '/' ) .
'resources/assets/mediawiki.png' );
$shortHtml = htmlspecialchars( $shortText );
header( 'Content-type: text/html; charset=UTF-8' );
$finalOutput = <<
MediaWiki {$this->mwVersion}
MediaWiki {$this->mwVersion} internal error
{$shortHtml}
{$title}
{$longHtml}
HTML;
return $finalOutput;
}
/**
* Display something vaguely comprehensible in the event of a totally unrecoverable error.
* Does not assume access to *anything*; no globals, no autoloader, no database, no localisation.
* Safe for PHP4 (and putting this here means that WebStart.php and GlobalSettings.php
* no longer need to be).
*
* Calling this function kills execution immediately.
*
* @param string $title HTML code to be put within an tag
* @param string $shortText
* @param string $longText
* @param string $longHtml
*/
function triggerError( $title, $shortText, $longText, $longHtml ) {
if ( $this->format === 'html' ) {
// Used by index.php and mw-config/index.php
$this->outputHTMLHeader();
$finalOutput = $this->getIndexErrorOutput( $title, $longHtml, $shortText );
} else {
// Used by Maintenance.php (CLI)
$finalOutput = $longText;
}
echo "$finalOutput\n";
die( 1 );
}
}
/**
* Check PHP version and that external dependencies are installed, and
* display an informative error if either condition is not satisfied.
*
* @param string $format One of "text" or "html"
* @param string $scriptPath Used when an error is formatted as HTML.
*/
function wfEntryPointCheck( $format = 'text', $scriptPath = '/' ) {
$phpVersionCheck = new PHPVersionCheck();
$phpVersionCheck->setFormat( $format );
$phpVersionCheck->setScriptPath( $scriptPath );
$phpVersionCheck->checkRequiredPHPVersion();
$phpVersionCheck->checkVendorExistence();
$phpVersionCheck->checkExtensionExistence();
}