Check PHP Version, as well as for composer dependencies in entry points, and display something vaguely comprehensible in the event of a totally unrecoverable error. More...

Public Member Functions
	checkExtensionExistence ()
	Displays an error, if a PHP extension does not exist.

	checkRequiredPHPVersion ()
	Displays an error, if the installed PHP version does not meet the minimum requirement.

	checkVendorExistence ()
	Displays an error, if the vendor/autoload.php file could not be found.

	getIndexErrorOutput ( $introText, $longTitle, $longHtml)
	Returns an error page, which is suitable for output to the end user via a web browser.

	outputHTMLHeader ()
	Output headers that prevents error pages to be cached.

	setFormat ( $format)
	Set the format used for errors.

	setScriptPath ( $scriptPath)
	Set the script path used for images in HTML-formatted errors.

	triggerError ( $web, $cliText)
	Display something vaguely comprehensible in the event of a totally unrecoverable error.

Public Attributes
string	$format = 'text'
	The format used for errors.

string[]	$functionsExtensionsMapping
	A mapping of PHP functions to PHP extensions.

string	$mwVersion = '1.39'
	The number of the MediaWiki version used.

string	$scriptPath = '/'

Detailed Description

Check PHP Version, as well as for composer dependencies in entry points, and display something vaguely comprehensible in the event of a totally unrecoverable error.

Note: Since we can't rely on anything external, the minimum PHP versions and MW current version are hardcoded in this class.; This class uses setter methods instead of a constructor so that it can be compatible with PHP 4 through PHP 8 (without warnings).

Definition at line 34 of file PHPVersionCheck.php.

Member Function Documentation

◆ checkExtensionExistence()

PHPVersionCheck::checkExtensionExistence ( )

Displays an error, if a PHP extension does not exist.

Definition at line 184 of file PHPVersionCheck.php.

References $ext, and triggerError().

◆ checkRequiredPHPVersion()

PHPVersionCheck::checkRequiredPHPVersion ( )

Displays an error, if the installed PHP version does not meet the minimum requirement.

Definition at line 80 of file PHPVersionCheck.php.

References triggerError().

◆ checkVendorExistence()

PHPVersionCheck::checkVendorExistence ( )

Displays an error, if the vendor/autoload.php file could not be found.

Definition at line 155 of file PHPVersionCheck.php.

References triggerError().

◆ getIndexErrorOutput()

PHPVersionCheck::getIndexErrorOutput	(	$introText,
		$longTitle,
		$longHtml )

Returns an error page, which is suitable for output to the end user via a web browser.

Parameters

string	$introText
string	$longTitle
string	$longHtml

Returns: string

Definition at line 243 of file PHPVersionCheck.php.

Referenced by triggerError().

◆ outputHTMLHeader()

PHPVersionCheck::outputHTMLHeader ( )

Output headers that prevents error pages to be cached.

Definition at line 226 of file PHPVersionCheck.php.

Referenced by triggerError().

◆ setFormat()

PHPVersionCheck::setFormat ( $format )

Set the format used for errors.

Parameters

string $format One of "text" or "html"

Definition at line 64 of file PHPVersionCheck.php.

References $format.

◆ setScriptPath()

PHPVersionCheck::setScriptPath ( $scriptPath )

Set the script path used for images in HTML-formatted errors.

Parameters

string $scriptPath

Definition at line 73 of file PHPVersionCheck.php.

References $scriptPath.

◆ triggerError()

PHPVersionCheck::triggerError	(		$web,
			$cliText )

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).

This function immediately terminates the PHP process.

Parameters

string[]	$web	(string) intro: Short error message, displayed on top. (string) longTitle: Title for the longer message. (string) longHtml: The longer message, as raw HTML.
string	$cliText

Definition at line 308 of file PHPVersionCheck.php.

References getIndexErrorOutput(), and outputHTMLHeader().

Referenced by checkExtensionExistence(), checkRequiredPHPVersion(), and checkVendorExistence().

Member Data Documentation

◆ $format

string PHPVersionCheck::$format = 'text'

The format used for errors.

One of "text" or "html"

Definition at line 52 of file PHPVersionCheck.php.

Referenced by setFormat().

◆ $functionsExtensionsMapping

string [] PHPVersionCheck::$functionsExtensionsMapping

Initial value:

= array(
        'mb_substr'   => 'mbstring',
        'xml_parser_create' => 'xml',
        'ctype_digit' => 'ctype',
        'json_decode' => 'json',
        'iconv'       => 'iconv',
        'mime_content_type' => 'fileinfo',
        'intl_is_failure' => 'intl',
    )

A mapping of PHP functions to PHP extensions.

Definition at line 39 of file PHPVersionCheck.php.

◆ $mwVersion

string PHPVersionCheck::$mwVersion = '1.39'

The number of the MediaWiki version used.

If you're updating MW_VERSION in Defines.php, you must also update this value.

Definition at line 36 of file PHPVersionCheck.php.

◆ $scriptPath

string PHPVersionCheck::$scriptPath = '/'

Definition at line 57 of file PHPVersionCheck.php.

Referenced by setScriptPath().

The documentation for this class was generated from the following file:

includes/PHPVersionCheck.php

Public Member Functions

Public Attributes

Detailed Description

Member Function Documentation

◆ checkExtensionExistence()

◆ checkRequiredPHPVersion()

◆ checkVendorExistence()

◆ getIndexErrorOutput()

◆ outputHTMLHeader()

◆ setFormat()

◆ setScriptPath()

◆ triggerError()

Member Data Documentation

◆ $format

◆ $functionsExtensionsMapping

◆ $mwVersion

◆ $scriptPath