5e2c7466ad
This patch adds the possibility for extensions and skins to require certain environment abiltites that are not necessarily PHP extensions. For now, the only ability introduced is the ability to shell out, but the processing and testing is written in a more general way to allow users to add more abilties later on by just changing getAbilities(). In theory, this allows using VersionChecker to check for random abilities if they are specified in the constructor, as it is comletely environment agnostic and not really bound to just be used for checking extension compatibility. Furthermore, it is possible to specify custom error messages for each of these abilities in the constructor. Other parts of MediaWiki may use these features to check for requirements while working with totally different abilities. Bug: T212472 Change-Id: Iff8512530b08ef509e7ac0b6ed8fe9578ef3e2a1
105 lines
2.4 KiB
PHP
105 lines
2.4 KiB
PHP
<?php
|
|
/**
|
|
* Copyright (C) 2018 Kunal Mehta <legoktm@member.fsf.org>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @since 1.31
|
|
*/
|
|
class ExtensionDependencyError extends Exception {
|
|
|
|
/**
|
|
* @var string[]
|
|
*/
|
|
public $missingExtensions = [];
|
|
|
|
/**
|
|
* @var string[]
|
|
*/
|
|
public $missingSkins = [];
|
|
|
|
/**
|
|
* @var string[]
|
|
*/
|
|
public $incompatibleExtensions = [];
|
|
|
|
/**
|
|
* @var string[]
|
|
*/
|
|
public $incompatibleSkins = [];
|
|
|
|
/**
|
|
* @var bool
|
|
*/
|
|
public $incompatibleCore = false;
|
|
|
|
/**
|
|
* @var bool
|
|
*/
|
|
public $incompatiblePhp = false;
|
|
|
|
/**
|
|
* @var string[]
|
|
*/
|
|
public $missingPhpExtensions = [];
|
|
|
|
/**
|
|
* @var string[]
|
|
*/
|
|
public $missingAbilities = [];
|
|
|
|
/**
|
|
* @param array $errors Each error has a 'msg' and 'type' key at minimum
|
|
*/
|
|
public function __construct( array $errors ) {
|
|
$msg = '';
|
|
foreach ( $errors as $info ) {
|
|
$msg .= $info['msg'] . "\n";
|
|
switch ( $info['type'] ) {
|
|
case 'incompatible-core':
|
|
$this->incompatibleCore = true;
|
|
break;
|
|
case 'incompatible-php':
|
|
$this->incompatiblePhp = true;
|
|
break;
|
|
case 'missing-phpExtension':
|
|
$this->missingPhpExtensions[] = $info['missing'];
|
|
break;
|
|
case 'missing-ability':
|
|
$this->missingAbilities[] = $info['missing'];
|
|
break;
|
|
case 'missing-skins':
|
|
$this->missingSkins[] = $info['missing'];
|
|
break;
|
|
case 'missing-extensions':
|
|
$this->missingExtensions[] = $info['missing'];
|
|
break;
|
|
case 'incompatible-skins':
|
|
$this->incompatibleSkins[] = $info['incompatible'];
|
|
break;
|
|
case 'incompatible-extensions':
|
|
$this->incompatibleExtensions[] = $info['incompatible'];
|
|
break;
|
|
// default: continue
|
|
}
|
|
}
|
|
|
|
parent::__construct( $msg );
|
|
}
|
|
|
|
}
|