MediaWiki REL1_39
PHPVersionCheck Class Reference

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$formatOne 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: