<?php
+// @codingStandardsIgnoreFile Generic.Arrays.DisallowLongArraySyntax
+// @codingStandardsIgnoreFile Generic.Files.LineLength
+// @codingStandardsIgnoreFile MediaWiki.Usage.DirUsage.FunctionFound
/**
* Check PHP Version, as well as for composer dependencies in entry points,
* and display something vaguely comprehensible in the event of a totally
*
* @file
*/
-
-/**
- * Check php version and that external dependencies are installed, and
- * display an informative error if either condition is not satisfied.
- *
- * @note Since we can't rely on anything, the minimum PHP versions and MW current
- * version are hardcoded here
- */
-function wfEntryPointCheck( $entryPoint ) {
- $mwVersion = '1.29';
- $minimumVersionPHP = '5.5.9';
- $phpVersion = PHP_VERSION;
-
- if ( !function_exists( 'version_compare' )
- || version_compare( $phpVersion, $minimumVersionPHP ) < 0
- ) {
- wfPHPVersionError( $entryPoint, $mwVersion, $minimumVersionPHP, $phpVersion );
- }
-
- // @codingStandardsIgnoreStart MediaWiki.Usage.DirUsage.FunctionFound
- if ( !file_exists( dirname( __FILE__ ) . '/../vendor/autoload.php' ) ) {
- // @codingStandardsIgnoreEnd
- wfMissingVendorError( $entryPoint, $mwVersion );
- }
-
- // List of functions and their associated PHP extension to check for
- // @codingStandardsIgnoreStart Generic.Arrays.DisallowLongArraySyntax
- $extensions = array(
+class PHPVersionCheck {
+ /* @var string The number of the MediaWiki version used */
+ var $mwVersion = '1.29';
+ /* @var string The minimum php version for MediaWiki to run */
+ var $minimumVersionPHP = '5.5.9';
+ var $functionsExtensionsMapping = array(
'mb_substr' => 'mbstring',
'utf8_encode' => 'xml',
'ctype_digit' => 'ctype',
'json_decode' => 'json',
'iconv' => 'iconv',
);
- // List of extensions we're missing
- $missingExtensions = array();
- // @codingStandardsIgnoreEnd
- foreach ( $extensions as $function => $extension ) {
- if ( !function_exists( $function ) ) {
- $missingExtensions[] = $extension;
+ /**
+ * @var string Which entry point we are protecting. One of:
+ * - index.php
+ * - load.php
+ * - api.php
+ * - mw-config/index.php
+ * - cli
+ */
+ var $entryPoint = null;
+
+ /**
+ * @param string $entryPoint Which entry point we are protecting. One of:
+ * - index.php
+ * - load.php
+ * - api.php
+ * - mw-config/index.php
+ * - cli
+ * @return $this
+ */
+ function setEntryPoint( $entryPoint ) {
+ $this->entryPoint = $entryPoint;
+ }
+
+ /**
+ * Returns the version of the installed php implementation.
+ *
+ * @return string
+ */
+ function getPHPImplVersion() {
+ return PHP_VERSION;
+ }
+
+ /**
+ * Displays an error, if the installed php version does not meet the minimum requirement.
+ *
+ * @return $this
+ */
+ function checkRequiredPHPVersion() {
+ if ( !function_exists( 'version_compare' )
+ || version_compare( $this->getPHPImplVersion(), $this->minimumVersionPHP ) < 0
+ ) {
+ $shortText = "MediaWiki $this->mwVersion requires at least PHP version"
+ . " $this->minimumVersionPHP, you are using PHP {$this->getPHPImplVersion()}.";
+
+ $longText = "Error: You might be using on older PHP version. \n"
+ . "MediaWiki $this->mwVersion needs PHP $this->minimumVersionPHP or higher.\n\n"
+ . "Check if you have a newer php executable with a different name, "
+ . "such as php5.\n\n";
+
+ $longHtml = <<<HTML
+ Please consider <a href="http://www.php.net/downloads.php">upgrading your copy of PHP</a>.
+ PHP versions less than 5.5.0 are no longer supported by the PHP Group and will not receive
+ security or bugfix updates.
+ </p>
+ <p>
+ If for some reason you are unable to upgrade your PHP version, you will need to
+ <a href="https://www.mediawiki.org/wiki/Download">download</a> an older version
+ of MediaWiki from our website. See our
+ <a href="https://www.mediawiki.org/wiki/Compatibility#PHP">compatibility page</a>
+ for details of which versions are compatible with prior versions of PHP.
+HTML;
+ $this->triggerError( 'Supported PHP versions', $shortText, $longText, $longHtml );
}
}
- if ( $missingExtensions ) {
- wfMissingExtensions( $entryPoint, $mwVersion, $missingExtensions );
+ /**
+ * Displays an error, if the vendor/autoload.php file could not be found.
+ *
+ * @return $this
+ */
+ 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 now 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.";
+
+ $longHtml = <<<HTML
+ MediaWiki now also has some external dependencies that need to be installed via
+ composer or from a separate git repo. Please see
+ <a href="https://www.mediawiki.org/wiki/Download_from_Git#Fetch_external_libraries">mediawiki.org</a>
+ for help on installing the required components.
+HTML;
+
+ $this->triggerError( 'External dependencies', $shortText, $longText, $longHtml );
+ }
}
-}
-/**
- * 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 $type Which entry point we are protecting. One of:
- * - index.php
- * - load.php
- * - api.php
- * - mw-config/index.php
- * - cli
- * @param string $mwVersion The number of the MediaWiki version used
- * @param string $title HTML code to be put within an <h2> tag
- * @param string $shortText
- * @param string $longText
- * @param string $longHtml
- */
-function wfGenericError( $type, $mwVersion, $title, $shortText, $longText, $longHtml ) {
- $protocol = isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0';
+ /**
+ * Displays an error, if a PHP extension does not exist.
+ *
+ * @return $this
+ */
+ 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://secure.php.net';
+ foreach ( $missingExtensions as $ext ) {
+ $missingExtText .= " * $ext <$baseUrl/$ext>\n";
+ $missingExtHtml .= "<li><b>$ext</b> "
+ . "(<a href=\"$baseUrl/$ext\">more information</a>)</li>";
+ }
+
+ $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 = <<<HTML
+ You are missing a required extension to PHP that MediaWiki
+ requires to run. Please install:
+ <ul>
+ $missingExtHtml
+ </ul>
+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';
- if ( $type == 'cli' ) {
- $finalOutput = $longText;
- } else {
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' );
+ }
- if ( $type == 'index.php' || $type == 'mw-config/index.php' ) {
- $pathinfo = pathinfo( $_SERVER['SCRIPT_NAME'] );
- if ( $type == 'mw-config/index.php' ) {
- $dirname = dirname( $pathinfo['dirname'] );
- } else {
- $dirname = $pathinfo['dirname'];
- }
- $encLogo = htmlspecialchars(
- str_replace( '//', '/', $dirname . '/' ) .
- 'resources/assets/mediawiki.png'
- );
- $shortHtml = htmlspecialchars( $shortText );
+ /**
+ * Returns an error page, which is suitable for output to the end user via a web browser.
+ *
+ * @param $title
+ * @param $longHtml
+ * @param $shortText
+ * @return string
+ */
+ function getIndexErrorOutput( $title, $longHtml, $shortText ) {
+ $pathinfo = pathinfo( $_SERVER['SCRIPT_NAME'] );
+ if ( $this->entryPoint == 'mw-config/index.php' ) {
+ $dirname = dirname( $pathinfo['dirname'] );
+ } else {
+ $dirname = $pathinfo['dirname'];
+ }
+ $encLogo =
+ htmlspecialchars( str_replace( '//', '/', $dirname . '/' ) .
+ 'resources/assets/mediawiki.png' );
+ $shortHtml = htmlspecialchars( $shortText );
- header( 'Content-type: text/html; charset=UTF-8' );
+ header( 'Content-type: text/html; charset=UTF-8' );
- $finalOutput = <<<HTML
+ $finalOutput = <<<HTML
<!DOCTYPE html>
<html lang="en" dir="ltr">
<head>
<meta charset="UTF-8" />
- <title>MediaWiki {$mwVersion}</title>
+ <title>MediaWiki {$this->mwVersion}</title>
<style media='screen'>
body {
color: #000;
</head>
<body>
<img src="{$encLogo}" alt='The MediaWiki logo' />
- <h1>MediaWiki {$mwVersion} internal error</h1>
+ <h1>MediaWiki {$this->mwVersion} internal error</h1>
<div class='error'>
<p>
{$shortHtml}
</body>
</html>
HTML;
- // Handle everything that's not index.php
- } else {
- // So nothing thinks this is JS or CSS
- $finalOutput = ( $type == 'load.php' ) ? "/* $shortText */" : $shortText;
- }
- }
- echo "$finalOutput\n";
- die( 1 );
-}
-
-/**
- * Display an error for the minimum PHP version requirement not being satisfied.
- *
- * @param string $type See wfGenericError
- * @param string $mwVersion See wfGenericError
- * @param string $minimumVersionPHP The minimum PHP version supported by MediaWiki
- * @param string $phpVersion The current PHP version
- */
-function wfPHPVersionError( $type, $mwVersion, $minimumVersionPHP, $phpVersion ) {
- $shortText = "MediaWiki $mwVersion requires at least "
- . "PHP version $minimumVersionPHP, you are using PHP $phpVersion.";
-
- $longText = "Error: You might be using on older PHP version. \n"
- . "MediaWiki $mwVersion needs PHP $minimumVersionPHP or higher.\n\n"
- . "Check if you have a newer php executable with a different name, such as php5.\n\n";
-
- $longHtml = <<<HTML
- Please consider <a href="http://www.php.net/downloads.php">upgrading your copy of PHP</a>.
- PHP versions less than 5.5.0 are no longer supported by the PHP Group and will not receive
- security or bugfix updates.
- </p>
- <p>
- If for some reason you are unable to upgrade your PHP version, you will need to
- <a href="https://www.mediawiki.org/wiki/Download">download</a> an older version
- of MediaWiki from our website. See our
- <a href="https://www.mediawiki.org/wiki/Compatibility#PHP">compatibility page</a>
- for details of which versions are compatible with prior versions of PHP.
-HTML;
- wfGenericError( $type, $mwVersion, 'Supported PHP versions', $shortText, $longText, $longHtml );
-}
-
-/**
- * Display an error for the vendor/autoload.php file not being found.
- *
- * @param string $type See wfGenericError
- * @param string $mwVersion See wfGenericError
- */
-function wfMissingVendorError( $type, $mwVersion ) {
- $shortText = "Installing some external dependencies (e.g. via composer) is required.";
- $longText = "Error: You are missing some external dependencies. \n"
- . "MediaWiki now 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.";
+ return $finalOutput;
+ }
- // @codingStandardsIgnoreStart Generic.Files.LineLength
- $longHtml = <<<HTML
- MediaWiki now also has some external dependencies that need to be installed via
- composer or from a separate git repo. Please see
- <a href="https://www.mediawiki.org/wiki/Download_from_Git#Fetch_external_libraries">mediawiki.org</a>
- for help on installing the required components.
-HTML;
- // @codingStandardsIgnoreEnd
+ /**
+ * 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 <h2> tag
+ * @param string $shortText
+ * @param string $longText
+ * @param string $longHtml
+ */
+ function triggerError( $title, $shortText, $longText, $longHtml ) {
+ switch ( $this->entryPoint ) {
+ case 'cli':
+ $finalOutput = $longText;
+ break;
+ case 'index.php':
+ case 'mw-config/index.php':
+ $this->outputHTMLHeader();
+ $finalOutput = $this->getIndexErrorOutput( $title, $longHtml, $shortText );
+ break;
+ case 'load.php':
+ $this->outputHTMLHeader();
+ $finalOutput = "/* $shortText */";
+ break;
+ default:
+ $this->outputHTMLHeader();
+ // Handle everything that's not index.php
+ $finalOutput = $shortText;
+ }
- wfGenericError( $type, $mwVersion, 'External dependencies', $shortText, $longText, $longHtml );
+ echo "$finalOutput\n";
+ die( 1 );
+ }
}
/**
- * Display an error for a PHP extension not existing.
+ * Check php version and that external dependencies are installed, and
+ * display an informative error if either condition is not satisfied.
*
- * @param string $type See wfGenericError
- * @param string $mwVersion See wfGenericError
- * @param array $missingExts The extensions we're missing
+ * @note Since we can't rely on anything, the minimum PHP versions and MW current
+ * version are hardcoded here
*/
-function wfMissingExtensions( $type, $mwVersion, $missingExts ) {
- $shortText = "Installing some PHP extensions is required.";
-
- $missingExtText = '';
- $missingExtHtml = '';
- $baseUrl = 'https://secure.php.net';
- foreach ( $missingExts as $ext ) {
- $missingExtText .= " * $ext <$baseUrl/$ext>\n";
- $missingExtHtml .= "<li><b>$ext</b> "
- . "(<a href=\"$baseUrl/$ext\">more information</a>)</li>";
- }
-
- $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 = <<<HTML
- You are missing a required extension to PHP that MediaWiki
- requires to run. Please install:
- <ul>
- $missingExtHtml
- </ul>
-HTML;
-
- wfGenericError( $type, $mwVersion, 'Required components', $shortText,
- $cliText, $longHtml );
+function wfEntryPointCheck( $entryPoint ) {
+ $phpVersionCheck = new PHPVersionCheck();
+ $phpVersionCheck->setEntryPoint( $entryPoint );
+ $phpVersionCheck->checkRequiredPHPVersion();
+ $phpVersionCheck->checkVendorExistence();
+ $phpVersionCheck->checkExtensionExistence();
}
<?php
/**
- * Mark a revision as patrolled on a page
- *
* Copyright © 2011 Alexandre Emsenhuber
*
* This program is free software; you can redistribute it and/or modify
*
* @ingroup Actions
*/
-class MarkpatrolledAction extends FormlessAction {
+class MarkpatrolledAction extends FormAction {
public function getName() {
return 'markpatrolled';
}
protected function getDescription() {
+ // Disable default header "subtitle"
return '';
}
- public function onView() {
- $request = $this->getRequest();
+ public function getRestriction() {
+ return 'patrol';
+ }
- $rcId = $request->getInt( 'rcid' );
- $rc = RecentChange::newFromId( $rcId );
- if ( is_null( $rc ) ) {
+ protected function getRecentChange( $data = null ) {
+ $rc = null;
+ // Note: This works both on initial GET url and after submitting the form
+ $rcId = $data ? intval( $data['rcid'] ) : $this->getRequest()->getInt( 'rcid' );
+ if ( $rcId ) {
+ $rc = RecentChange::newFromId( $rcId );
+ }
+ if ( !$rc ) {
throw new ErrorPageError( 'markedaspatrollederror', 'markedaspatrollederrortext' );
}
+ return $rc;
+ }
- $user = $this->getUser();
- if ( !$user->matchEditToken( $request->getVal( 'token' ), $rcId ) ) {
- throw new ErrorPageError( 'sessionfailure-title', 'sessionfailure' );
- }
+ protected function preText() {
+ $rc = $this->getRecentChange();
+ $title = $rc->getTitle();
+
+ // Based on logentry-patrol-patrol (see PatrolLogFormatter)
+ $revId = $rc->getAttribute( 'rc_this_oldid' );
+ $query = [
+ 'curid' => $rc->getAttribute( 'rc_cur_id' ),
+ 'diff' => $revId,
+ 'oldid' => $rc->getAttribute( 'rc_last_oldid' )
+ ];
+ $revlink = Linker::link( $title, htmlspecialchars( $revId ), [], $query );
+ $pagelink = Linker::link( $title, htmlspecialchars( $title->getPrefixedText() ) );
+ return $this->msg( 'confirm-markpatrolled-top' )->params(
+ $title->getPrefixedText(),
+ // Provide pre-rendered link as parser would render [[:$1]] as bold non-link
+ Message::rawParam( $pagelink ),
+ Message::rawParam( $revlink )
+ )->parse();
+ }
+
+ protected function alterForm( HTMLForm $form ) {
+ $form->addHiddenField( 'rcid', $this->getRequest()->getInt( 'rcid' ) );
+ $form->setTokenSalt( 'patrol' );
+ $form->setSubmitTextMsg( 'confirm-markpatrolled-button' );
+ }
+
+ /**
+ * @return bool|array True for success, false for didn't-try, array of errors on failure
+ */
+ public function onSubmit( $data ) {
+ $user = $this->getUser();
+ $rc = $this->getRecentChange( $data );
$errors = $rc->doMarkPatrolled( $user );
if ( in_array( [ 'rcpatroldisabled' ], $errors ) ) {
throw new ErrorPageError( 'rcpatroldisabled', 'rcpatroldisabledtext' );
}
- if ( in_array( [ 'hookaborted' ], $errors ) ) {
- // The hook itself has handled any output
- return;
- }
-
- # It would be nice to see where the user had actually come from, but for now just guess
+ // Guess where the user came from
+ // TODO: Would be nice to see where the user actually came from
if ( $rc->getAttribute( 'rc_type' ) == RC_NEW ) {
$returnTo = 'Newpages';
} elseif ( $rc->getAttribute( 'rc_log_type' ) == 'upload' ) {
$this->getOutput()->setPageTitle( $this->msg( 'markedaspatrollederror' ) );
$this->getOutput()->addWikiMsg( 'markedaspatrollederror-noautopatrol' );
$this->getOutput()->returnToMain( null, $return );
-
- return;
+ return true;
}
- if ( count( $errors ) ) {
- throw new PermissionsError( 'patrol', $errors );
+ if ( $errors ) {
+ if ( !in_array( [ 'hookaborted' ], $errors ) ) {
+ throw new PermissionsError( 'patrol', $errors );
+ }
+ // The hook itself has handled any output
+ return $errors;
}
- # Inform the user
$this->getOutput()->setPageTitle( $this->msg( 'markedaspatrolled' ) );
$this->getOutput()->addWikiMsg( 'markedaspatrolledtext', $rc->getTitle()->getPrefixedText() );
$this->getOutput()->returnToMain( null, $return );
+ return true;
+ }
+
+ public function onSuccess() {
+ // Required by parent class. Redundant as our onSubmit handles output already.
}
public function doesWrites() {