DeprecatedHooks.php

Go to the documentation of this file.

<?php
namespace MediaWiki\HookContainer;
 
use InvalidArgumentException;
 
class DeprecatedHooks {
 
    private $deprecatedHooks = [
        'AddNewAccount' => [ 'deprecatedVersion' => '1.27', 'silent' => true ],
        'BaseTemplateAfterPortlet' => [ 'deprecatedVersion' => '1.35' ],
        'BeforeParserFetchTemplateAndtitle' => [ 'deprecatedVersion' => '1.36' ],
        'BeforeParserrenderImageGallery' => [ 'deprecatedVersion' => '1.35' ],
        'EditPageBeforeEditToolbar' => [ 'deprecatedVersion' => '1.36' ],
        'InternalParseBeforeSanitize' => [ 'deprecatedVersion' => '1.35' ],
        'LinksUpdateConstructed' => [ 'deprecatedVersion' => '1.38' ],
        'LinksUpdateAfterInsert' => [ 'deprecatedVersion' => '1.38' ],
        'LocalFile::getHistory' => [ 'deprecatedVersion' => '1.37' ],
        'MagicWordwgVariableIDs' => [ 'deprecatedVersion' => '1.35', 'silent' => true ],
        'PageContentSave' => [ 'deprecatedVersion' => '1.35', 'silent' => true ],
        'ParserGetVariableValueVarCache' => [ 'deprecatedVersion' => '1.35' ],
        'ParserSectionCreate' => [ 'deprecatedVersion' => '1.35' ],
        'ParserTestTables' => [ 'deprecatedVersion' => '1.36', 'silent' => true ],
        'PrefixSearchBackend' => [ 'deprecatedVersion' => '1.27', 'silent' => true ],
        'ProtectionForm::buildForm' => [ 'deprecatedVersion' => '1.36', 'silent' => true ],
        'ResourceLoaderTestModules' => [ 'deprecatedVersion' => '1.33' ],
        'RollbackComplete' => [ 'deprecatedVersion' => '1.36', 'silent' => true ],
        'SpecialMuteSubmit' => [ 'deprecatedVersion' => '1.35', 'silent' => true ],
        'UserLoadFromDatabase' => [ 'deprecatedVersion' => '1.37' ],
        'UserSetCookies' => [ 'deprecatedVersion' => '1.27' ],
        'WikiPageDeletionUpdates' => [ 'deprecatedVersion' => '1.32', 'silent' => true ],
        'userCan' => [ 'deprecatedVersion' => '1.37' ],
        'ArticleDelete' => [ 'deprecatedVersion' => '1.37', 'silent' => true ],
        'ArticleDeleteComplete' => [ 'deprecatedVersion' => '1.37', 'silent' => true ],
        'SkinTemplateNavigation' => [ 'deprecatedVersion' => '1.39' ],
        'SkinTemplateNavigation::SpecialPage' => [ 'deprecatedVersion' => '1.39' ],
    ];
 
    public function __construct( array $deprecatedHooks = [] ) {
        foreach ( $deprecatedHooks as $hook => $info ) {
            $this->markDeprecated(
                $hook,
                $info['deprecatedVersion'],
                $info['component'] ?? false,
                $info['silent'] ?? false
            );
        }
    }
 
    public function markDeprecated(
        string $hook, string $version, ?string $component = null, bool $silent = false
    ): void {
        if ( isset( $this->deprecatedHooks[$hook] ) ) {
            throw new InvalidArgumentException(
                "Cannot mark hook '$hook' deprecated with version $version. " .
                "It is already marked deprecated with version " .
                $this->deprecatedHooks[$hook]['deprecatedVersion']
            );
        }
        $hookInfo = [
            'deprecatedVersion' => $version,
            'silent' => $silent
        ];
        if ( $component ) {
            $hookInfo['component'] = $component;
        }
        $this->deprecatedHooks[$hook] = $hookInfo;
    }
 
    public function isHookDeprecated( string $hook ): bool {
        return isset( $this->deprecatedHooks[$hook] );
    }
 
    public function getDeprecationInfo( ?string $hook = null ): ?array {
        if ( !$hook ) {
            return $this->deprecatedHooks;
        }
        return $this->deprecatedHooks[$hook] ?? null;
    }
}