value ] into a self instance * * @param array $vars * @return AbuseFilterVariableHolder */ public static function newFromArray( array $vars ) : AbuseFilterVariableHolder { $ret = new self; foreach ( $vars as $var => $value ) { $ret->setVar( $var, $value ); } return $ret; } /** * @param string $variable * @param mixed $datum */ public function setVar( $variable, $datum ) { $variable = strtolower( $variable ); if ( !( $datum instanceof AFPData || $datum instanceof AFComputedVariable ) ) { $datum = AFPData::newFromPHPVar( $datum ); } $this->mVars[$variable] = $datum; } /** * Get all variables stored in this object * * @return (AFPData|AFComputedVariable)[] */ public function getVars() { return $this->mVars; } /** * @param string $variable * @param string $method * @param array $parameters */ public function setLazyLoadVar( $variable, $method, $parameters ) { $placeholder = new AFComputedVariable( $method, $parameters ); $this->setVar( $variable, $placeholder ); } /** * Get a variable from the current object * * @param string $varName The variable name * @return AFPData */ public function getVar( $varName ) { $varName = strtolower( $varName ); if ( $this->mVarsVersion === 1 && in_array( $varName, AbuseFilter::getDeprecatedVariables() ) ) { // Variables are stored with old names, but the parser has given us // a new name. Translate it back. $varName = array_search( $varName, AbuseFilter::getDeprecatedVariables() ); } if ( isset( $this->mVars[$varName] ) ) { /** @var $variable AFComputedVariable|AFPData */ $variable = $this->mVars[$varName]; if ( $variable instanceof AFComputedVariable ) { $value = $variable->compute( $this ); $this->setVar( $varName, $value ); return $value; } elseif ( $variable instanceof AFPData ) { return $variable; } } elseif ( array_key_exists( $varName, AbuseFilter::$disabledVars ) ) { wfWarn( "Disabled variable $varName requested. Please fix the filter as this will " . "be removed soon." ); } return new AFPData( AFPData::DUNDEFINED ); } /** * @return AbuseFilterVariableHolder */ public static function merge() { $newHolder = new AbuseFilterVariableHolder; $newHolder->addHolders( ...func_get_args() ); return $newHolder; } /** * Merge any number of holders given as arguments into this holder. * * @throws MWException */ public function addHolders() { $holders = func_get_args(); foreach ( $holders as $addHolder ) { if ( !is_object( $addHolder ) ) { throw new MWException( 'Invalid argument to AbuseFilterVariableHolder::addHolders' ); } $this->mVars = array_merge( $this->mVars, $addHolder->mVars ); } } /** * Export all variables stored in this object as string * * @return string[] */ public function exportAllVars() { $exported = []; foreach ( array_keys( $this->mVars ) as $varName ) { $exported[$varName] = $this->getVar( $varName )->toString(); } return $exported; } /** * Export all non-lazy variables stored in this object as string * * @return string[] */ public function exportNonLazyVars() { $exported = []; foreach ( $this->mVars as $varName => $data ) { if ( !( $data instanceof AFComputedVariable ) ) { $exported[$varName] = $this->getVar( $varName )->toString(); } } return $exported; } /** * Dump all variables stored in this object in their native types. * If you want a not yet set variable to be included in the results you can * either set $compute to an array with the name of the variable or set * $compute to true to compute all not yet set variables. * * @param array|bool $compute Variables we should copute if not yet set * @param bool $includeUserVars Include user set variables * @return array */ public function dumpAllVars( $compute = [], $includeUserVars = false ) { $coreVariables = []; if ( !$includeUserVars ) { // Compile a list of all variables set by the extension to be able // to filter user set ones by name global $wgRestrictionTypes; $activeVariables = array_keys( AbuseFilter::getBuilderValues()['vars'] ); $deprecatedVariables = array_keys( AbuseFilter::getDeprecatedVariables() ); $disabledVariables = array_keys( AbuseFilter::$disabledVars ); $coreVariables = array_merge( $activeVariables, $deprecatedVariables, $disabledVariables ); // @todo _restrictions variables should be handled in builderValues as well. $prefixes = [ 'moved_from', 'moved_to', 'page' ]; foreach ( $wgRestrictionTypes as $action ) { foreach ( $prefixes as $prefix ) { $coreVariables[] = "{$prefix}_restrictions_$action"; } } $coreVariables = array_map( 'strtolower', $coreVariables ); } $exported = []; foreach ( array_keys( $this->mVars ) as $varName ) { $computeThis = ( is_array( $compute ) && in_array( $varName, $compute ) ) || $compute === true; if ( ( $includeUserVars || in_array( strtolower( $varName ), $coreVariables ) ) && // Only include variables set in the extension in case $includeUserVars is false ( $computeThis || $this->mVars[$varName] instanceof AFPData ) ) { $exported[$varName] = $this->getVar( $varName )->toNative(); } } return $exported; } /** * @param string $var * @return bool */ public function varIsSet( $var ) { return array_key_exists( $var, $this->mVars ); } /** * Compute all vars which need DB access. Useful for vars which are going to be saved * cross-wiki or used for offline analysis. */ public function computeDBVars() { static $dbTypes = [ 'links-from-wikitext-or-database', 'load-recent-authors', 'page-age', 'get-page-restrictions', 'simple-user-accessor', 'user-age', 'user-groups', 'user-rights', 'revision-text-by-id', 'revision-text-by-timestamp' ]; /** @var AFComputedVariable[] $missingVars */ $missingVars = array_filter( $this->mVars, function ( $el ) { return ( $el instanceof AFComputedVariable ); } ); foreach ( $missingVars as $name => $value ) { if ( in_array( $value->mMethod, $dbTypes ) ) { $value = $value->compute( $this ); $this->setVar( $name, $value ); } } } }