mirror of
https://gerrit.wikimedia.org/r/mediawiki/skins/Vector.git
synced 2024-11-27 09:00:04 +00:00
8dc9511bbc
composer: * mediawiki/mediawiki-codesniffer: 36.0.0 → 37.0.0 npm: * svgo: 2.3.0 → 2.3.1 * https://npmjs.com/advisories/1754 (CVE-2021-33587) * postcss: 7.0.35 → 7.0.36 * https://npmjs.com/advisories/1693 (CVE-2021-23368) * trim-newlines: 3.0.0 → 3.0.1 * https://npmjs.com/advisories/1753 (CVE-2021-33623) * prismjs: 1.23.0 → 1.24.1 * https://npmjs.com/advisories/1762 (CVE-2021-32723) Change-Id: Ief0fe110b6746c209085502cf4639429a4116ab5
112 lines
3.2 KiB
PHP
112 lines
3.2 KiB
PHP
<?php
|
|
|
|
/**
|
|
* 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.
|
|
* http://www.gnu.org/copyleft/gpl.html
|
|
*
|
|
* @file
|
|
* @since 1.35
|
|
*/
|
|
|
|
namespace Vector\FeatureManagement\Requirements;
|
|
|
|
use Vector\FeatureManagement\Requirement;
|
|
|
|
/**
|
|
* Some application state changes throughout the lifetime of the application, e.g. `wgSitename` or
|
|
* `wgFullyInitialised`, which signals whether the application boot process has finished and
|
|
* critical resources like database connections are available.
|
|
*
|
|
* The `DynamicStateRequirement` allows us to define requirements that lazily evaluate the
|
|
* application state statically, e.g.
|
|
*
|
|
* ```lang=php
|
|
* $featureManager->registerComplexRequirement(
|
|
* new DynamicConfigRequirement(
|
|
* $config,
|
|
* 'Sitename',
|
|
* 'Foo'
|
|
* )
|
|
* );
|
|
* ```
|
|
*
|
|
* registers a requirement that will evaluate to true only when `mediawiki/includes/Setup.php` has
|
|
* finished executing (after all service wiring has executed). I.e., every call to
|
|
* `Requirement->isMet()` reinterrogates the Config object for the current state and returns it.
|
|
* Contrast to
|
|
*
|
|
* ```lang=php
|
|
* $featureManager->registerRequirement(
|
|
* 'Foo',
|
|
* $config->get( 'Sitename' )
|
|
* );
|
|
* ```
|
|
*
|
|
* wherein state is evaluated only once at registration time and permanently cached.
|
|
*
|
|
* NOTE: This API hasn't settled. It may change at any time without warning. Please don't bind to
|
|
* it unless you absolutely need to
|
|
*
|
|
* @unstable
|
|
*
|
|
* @package Vector\FeatureManagement\Requirements
|
|
* @internal
|
|
*/
|
|
final class DynamicConfigRequirement implements Requirement {
|
|
|
|
/**
|
|
* @var \Config
|
|
*/
|
|
private $config;
|
|
|
|
/**
|
|
* @var string
|
|
*/
|
|
private $configName;
|
|
|
|
/**
|
|
* @var string
|
|
*/
|
|
private $requirementName;
|
|
|
|
/**
|
|
* @param \Config $config
|
|
* @param string $configName Any `Config` key. This name is used to query `$config` state. E.g.,
|
|
* `'DBname'`. See https://www.mediawiki.org/wiki/Manual:Configuration_settings
|
|
* @param string $requirementName The name of the requirement presented to FeatureManager.
|
|
* This name _usually_ matches the `$configName` parameter for simplicity but allows for
|
|
* abstraction as needed. See `Requirement->getName()`.
|
|
*/
|
|
public function __construct( \Config $config, string $configName, string $requirementName ) {
|
|
$this->config = $config;
|
|
$this->configName = $configName;
|
|
$this->requirementName = $requirementName;
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function getName(): string {
|
|
return $this->requirementName;
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function isMet(): bool {
|
|
return (bool)$this->config->get( $this->configName );
|
|
}
|
|
}
|