Title.php

Go to the documentation of this file.

<?php
use MediaWiki\DAO\WikiAwareEntityTrait;
use MediaWiki\Interwiki\InterwikiLookup;
use MediaWiki\Linker\LinkTarget;
use MediaWiki\Logger\LoggerFactory;
use MediaWiki\MediaWikiServices;
use MediaWiki\Page\PageIdentity;
use MediaWiki\Page\PageIdentityValue;
use MediaWiki\Page\ProperPageIdentity;
use Wikimedia\Assert\Assert;
use Wikimedia\Assert\PreconditionException;
use Wikimedia\Rdbms\Database;
use Wikimedia\Rdbms\IDatabase;
 
class Title implements LinkTarget, PageIdentity, IDBAccessObject {
    use WikiAwareEntityTrait;
 
    private static $titleCache = null;
 
    private const CACHE_MAX = 1000;
 
    public const GAID_FOR_UPDATE = 512;
 
    public const NEW_CLONE = 'clone';
 
    /***************************************************************************/
    // region   Private member variables
    public $mTextform = '';
    public $mUrlform = '';
    public $mDbkeyform = '';
    public $mNamespace = NS_MAIN;
    public $mInterwiki = '';
    private $mLocalInterwiki = false;
    public $mFragment = '';
 
    public $mArticleID = -1;
 
    protected $mLatestID = false;
 
    private $mContentModel = false;
 
    private $mForcedContentModel = false;
 
    private $mEstimateRevisions;
 
    public $mRestrictions = [];
 
    protected $mOldRestrictions = false;
 
    public $mCascadeRestriction;
 
    public $mCascadingRestrictions;
 
    protected $mRestrictionsExpiry = [];
 
    protected $mHasCascadingRestrictions;
 
    public $mCascadeSources;
 
    public $mRestrictionsLoaded = false;
 
    public $prefixedText = null;
 
    public $mTitleProtection;
 
    public $mDefaultNamespace = NS_MAIN;
 
    protected $mLength = -1;
 
    public $mRedirect = null;
 
    private $mHasSubpages;
 
    private $mPageLanguage;
 
    private $mDbPageLanguage = false;
 
    private $mTitleValue = null;
 
    private $mIsBigDeletion = null;
 
    private $mIsValid = null;
 
    // endregion -- end of private member variables
    /***************************************************************************/
 
    private function getLanguageConverter( $language ) : ILanguageConverter {
        return MediaWikiServices::getInstance()->getLanguageConverterFactory()
            ->getLanguageConverter( $language );
    }
 
    private function getPageLanguageConverter() : ILanguageConverter {
        return $this->getLanguageConverter( $this->getPageLanguage() );
    }
 
    private static function getTitleFormatter() {
        return MediaWikiServices::getInstance()->getTitleFormatter();
    }
 
    private static function getInterwikiLookup() {
        return MediaWikiServices::getInstance()->getInterwikiLookup();
    }
 
    private function __construct() {
    }
 
    public static function newFromDBkey( $key ) {
        $t = new self();
 
        try {
            $t->secureAndSplit( $key );
            return $t;
        } catch ( MalformedTitleException $ex ) {
            return null;
        }
    }
 
    public static function newFromTitleValue( TitleValue $titleValue, $forceClone = '' ) {
        return self::newFromLinkTarget( $titleValue, $forceClone );
    }
 
    public static function newFromLinkTarget( LinkTarget $linkTarget, $forceClone = '' ) {
        if ( $linkTarget instanceof Title ) {
            // Special case if it's already a Title object
            if ( $forceClone === self::NEW_CLONE ) {
                return clone $linkTarget;
            } else {
                return $linkTarget;
            }
        }
        return self::makeTitle(
            $linkTarget->getNamespace(),
            $linkTarget->getText(),
            $linkTarget->getFragment(),
            $linkTarget->getInterwiki()
        );
    }
 
    public static function castFromLinkTarget( $linkTarget ) {
        return $linkTarget ? self::newFromLinkTarget( $linkTarget ) : null;
    }
 
    public static function castFromPageIdentity( ?PageIdentity $pageIdentity ) : ?Title {
        if ( !$pageIdentity ) {
            return null;
        }
 
        if ( $pageIdentity instanceof Title ) {
            return $pageIdentity;
        }
 
        $pageIdentity->assertWiki( self::LOCAL );
        $title = self::makeTitle( $pageIdentity->getNamespace(), $pageIdentity->getDBkey() );
        $title->resetArticleID( $pageIdentity->getId() );
        return $title;
    }
 
    public static function newFromText( $text, $defaultNamespace = NS_MAIN ) {
        // DWIM: Integers can be passed in here when page titles are used as array keys.
        if ( $text !== null && !is_string( $text ) && !is_int( $text ) ) {
            throw new InvalidArgumentException( '$text must be a string.' );
        }
        if ( $text === null ) {
            return null;
        }
 
        try {
            return self::newFromTextThrow( (string)$text, (int)$defaultNamespace );
        } catch ( MalformedTitleException $ex ) {
            return null;
        }
    }
 
    public static function newFromTextThrow( $text, $defaultNamespace = NS_MAIN ) {
        if ( is_object( $text ) ) {
            throw new MWException( '$text must be a string, given an object' );
        } elseif ( $text === null ) {
            // Legacy code relies on MalformedTitleException being thrown in this case
            // (happens when URL with no title in it is parsed). TODO fix
            throw new MalformedTitleException( 'title-invalid-empty' );
        }
 
        $titleCache = self::getTitleCache();
 
        // Wiki pages often contain multiple links to the same page.
        // Title normalization and parsing can become expensive on pages with many
        // links, so we can save a little time by caching them.
        // In theory these are value objects and won't get changed...
        if ( $defaultNamespace === NS_MAIN ) {
            $t = $titleCache->get( $text );
            if ( $t ) {
                return $t;
            }
        }
 
        // Convert things like &eacute; &#257; or &#x3017; into normalized (T16952) text
        $filteredText = Sanitizer::decodeCharReferencesAndNormalize( $text );
 
        $t = new Title();
        $dbKeyForm = strtr( $filteredText, ' ', '_' );
 
        $t->secureAndSplit( $dbKeyForm, (int)$defaultNamespace );
        if ( $defaultNamespace === NS_MAIN ) {
            $titleCache->set( $text, $t );
        }
        return $t;
    }
 
    public static function newFromURL( $url ) {
        $t = new Title();
 
        # For compatibility with old buggy URLs. "+" is usually not valid in titles,
        # but some URLs used it as a space replacement and they still come
        # from some external search tools.
        if ( strpos( self::legalChars(), '+' ) === false ) {
            $url = strtr( $url, '+', ' ' );
        }
 
        $dbKeyForm = strtr( $url, ' ', '_' );
 
        try {
            $t->secureAndSplit( $dbKeyForm );
            return $t;
        } catch ( MalformedTitleException $ex ) {
            return null;
        }
    }
 
    private static function getTitleCache() {
        if ( self::$titleCache === null ) {
            self::$titleCache = new MapCacheLRU( self::CACHE_MAX );
        }
        return self::$titleCache;
    }
 
    protected static function getSelectFields() {
        global $wgPageLanguageUseDB;
 
        $fields = [
            'page_namespace', 'page_title', 'page_id',
            'page_len', 'page_is_redirect', 'page_latest',
            'page_content_model',
        ];
 
        if ( $wgPageLanguageUseDB ) {
            $fields[] = 'page_lang';
        }
 
        return $fields;
    }
 
    public static function newFromID( $id, $flags = 0 ) {
        $flags |= ( $flags & self::GAID_FOR_UPDATE ) ? self::READ_LATEST : 0; // b/c
        list( $index, $options ) = DBAccessObjectUtils::getDBOptions( $flags );
        $row = wfGetDB( $index )->selectRow(
            'page',
            self::getSelectFields(),
            [ 'page_id' => $id ],
            __METHOD__,
            $options
        );
        if ( $row !== false ) {
            $title = self::newFromRow( $row );
        } else {
            $title = null;
        }
 
        return $title;
    }
 
    public static function newFromIDs( $ids ) {
        if ( !count( $ids ) ) {
            return [];
        }
        $dbr = wfGetDB( DB_REPLICA );
 
        $res = $dbr->select(
            'page',
            self::getSelectFields(),
            [ 'page_id' => $ids ],
            __METHOD__
        );
 
        $titles = [];
        foreach ( $res as $row ) {
            $titles[] = self::newFromRow( $row );
        }
        return $titles;
    }
 
    public static function newFromRow( $row ) {
        $t = self::makeTitle( $row->page_namespace, $row->page_title );
        $t->loadFromRow( $row );
        return $t;
    }
 
    public function loadFromRow( $row ) {
        if ( $row ) { // page found
            if ( isset( $row->page_id ) ) {
                $this->mArticleID = (int)$row->page_id;
            }
            if ( isset( $row->page_len ) ) {
                $this->mLength = (int)$row->page_len;
            }
            if ( isset( $row->page_is_redirect ) ) {
                $this->mRedirect = (bool)$row->page_is_redirect;
            }
            if ( isset( $row->page_latest ) ) {
                $this->mLatestID = (int)$row->page_latest;
            }
            if ( isset( $row->page_content_model ) ) {
                $this->lazyFillContentModel( $row->page_content_model );
            } else {
                $this->lazyFillContentModel( false ); // lazily-load getContentModel()
            }
            if ( isset( $row->page_lang ) ) {
                $this->mDbPageLanguage = (string)$row->page_lang;
            }
            if ( isset( $row->page_restrictions ) ) {
                $this->mOldRestrictions = $row->page_restrictions;
            }
        } else { // page not found
            $this->mArticleID = 0;
            $this->mLength = 0;
            $this->mRedirect = false;
            $this->mLatestID = 0;
            $this->lazyFillContentModel( false ); // lazily-load getContentModel()
        }
    }
 
    public static function makeTitle( $ns, $title, $fragment = '', $interwiki = '' ) {
        $t = new Title();
        $t->mInterwiki = $interwiki;
        $t->mFragment = $fragment;
        $t->mNamespace = $ns = (int)$ns;
        $t->mDbkeyform = strtr( $title, ' ', '_' );
        $t->mArticleID = ( $ns >= 0 ) ? -1 : 0;
        $t->mUrlform = wfUrlencode( $t->mDbkeyform );
        $t->mTextform = strtr( $title, '_', ' ' );
        return $t;
    }
 
    public static function makeTitleSafe( $ns, $title, $fragment = '', $interwiki = '' ) {
        // NOTE: ideally, this would just call makeTitle() and then isValid(),
        // but presently, that means more overhead on a potential performance hotspot.
 
        if ( !MediaWikiServices::getInstance()->getNamespaceInfo()->exists( $ns ) ) {
            return null;
        }
 
        $t = new Title();
        $dbKeyForm = self::makeName( $ns, $title, $fragment, $interwiki, true );
 
        try {
            $t->secureAndSplit( $dbKeyForm );
            return $t;
        } catch ( MalformedTitleException $ex ) {
            return null;
        }
    }
 
    public static function newMainPage( MessageLocalizer $localizer = null ) {
        if ( $localizer ) {
            $msg = $localizer->msg( 'mainpage' );
        } else {
            $msg = wfMessage( 'mainpage' );
        }
 
        $title = self::newFromText( $msg->inContentLanguage()->text() );
 
        // Every page renders at least one link to the Main Page (e.g. sidebar).
        // If the localised value is invalid, don't produce fatal errors that
        // would make the wiki inaccessible (and hard to fix the invalid message).
        // Gracefully fallback...
        if ( !$title ) {
            $title = self::newFromText( 'Main Page' );
        }
        return $title;
    }
 
    public static function nameOf( $id ) {
        wfDeprecated( __METHOD__, '1.36' );
 
        $dbr = wfGetDB( DB_REPLICA );
 
        $s = $dbr->selectRow(
            'page',
            [ 'page_namespace', 'page_title' ],
            [ 'page_id' => $id ],
            __METHOD__
        );
        if ( $s === false ) {
            return null;
        }
 
        return self::makeName( $s->page_namespace, $s->page_title );
    }
 
    public static function legalChars() {
        global $wgLegalTitleChars;
        return $wgLegalTitleChars;
    }
 
    public static function convertByteClassToUnicodeClass( $byteClass ) {
        $length = strlen( $byteClass );
        // Input token queue
        $x0 = $x1 = $x2 = '';
        // Decoded queue
        $d0 = $d1 = '';
        // Decoded integer codepoints
        $ord0 = $ord1 = $ord2 = 0;
        // Re-encoded queue
        $r0 = $r1 = $r2 = '';
        // Output
        $out = '';
        // Flags
        $allowUnicode = false;
        for ( $pos = 0; $pos < $length; $pos++ ) {
            // Shift the queues down
            $x2 = $x1;
            $x1 = $x0;
            $d1 = $d0;
            $ord2 = $ord1;
            $ord1 = $ord0;
            $r2 = $r1;
            $r1 = $r0;
            // Load the current input token and decoded values
            $inChar = $byteClass[$pos];
            if ( $inChar === '\\' ) {
                if ( preg_match( '/x([0-9a-fA-F]{2})/A', $byteClass, $m, 0, $pos + 1 ) ) {
                    $x0 = $inChar . $m[0];
                    $d0 = chr( hexdec( $m[1] ) );
                    $pos += strlen( $m[0] );
                } elseif ( preg_match( '/[0-7]{3}/A', $byteClass, $m, 0, $pos + 1 ) ) {
                    $x0 = $inChar . $m[0];
                    $d0 = chr( octdec( $m[0] ) );
                    $pos += strlen( $m[0] );
                } elseif ( $pos + 1 >= $length ) {
                    $x0 = $d0 = '\\';
                } else {
                    $d0 = $byteClass[$pos + 1];
                    $x0 = $inChar . $d0;
                    $pos++;
                }
            } else {
                $x0 = $d0 = $inChar;
            }
            $ord0 = ord( $d0 );
            // Load the current re-encoded value
            if ( $ord0 < 32 || $ord0 == 0x7f ) {
                $r0 = sprintf( '\x%02x', $ord0 );
            } elseif ( $ord0 >= 0x80 ) {
                // Allow unicode if a single high-bit character appears
                $r0 = sprintf( '\x%02x', $ord0 );
                $allowUnicode = true;
                // @phan-suppress-next-line PhanParamSuspiciousOrder false positive
            } elseif ( strpos( '-\\[]^', $d0 ) !== false ) {
                $r0 = '\\' . $d0;
            } else {
                $r0 = $d0;
            }
            // Do the output
            if ( $x0 !== '' && $x1 === '-' && $x2 !== '' ) {
                // Range
                if ( $ord2 > $ord0 ) {
                    // Empty range
                } elseif ( $ord0 >= 0x80 ) {
                    // Unicode range
                    $allowUnicode = true;
                    if ( $ord2 < 0x80 ) {
                        // Keep the non-unicode section of the range
                        $out .= "$r2-\\x7F";
                    }
                } else {
                    // Normal range
                    $out .= "$r2-$r0";
                }
                // Reset state to the initial value
                $x0 = $x1 = $d0 = $d1 = $r0 = $r1 = '';
            } elseif ( $ord2 < 0x80 ) {
                // ASCII character
                $out .= $r2;
            }
        }
        // @phan-suppress-next-line PhanSuspiciousValueComparison
        if ( $ord1 < 0x80 ) {
            $out .= $r1;
        }
        if ( $ord0 < 0x80 ) {
            $out .= $r0;
        }
        if ( $allowUnicode ) {
            $out .= '\u0080-\uFFFF';
        }
        return $out;
    }
 
    public static function makeName( $ns, $title, $fragment = '', $interwiki = '',
        $canonicalNamespace = false
    ) {
        if ( $canonicalNamespace ) {
            $namespace = MediaWikiServices::getInstance()->getNamespaceInfo()->
                getCanonicalName( $ns );
        } else {
            $namespace = MediaWikiServices::getInstance()->getContentLanguage()->getNsText( $ns );
        }
        $name = $namespace == '' ? $title : "$namespace:$title";
        if ( strval( $interwiki ) != '' ) {
            $name = "$interwiki:$name";
        }
        if ( strval( $fragment ) != '' ) {
            $name .= '#' . $fragment;
        }
        return $name;
    }
 
    public static function compare( LinkTarget $a, LinkTarget $b ) {
        return $a->getNamespace() <=> $b->getNamespace()
            ?: strcmp( $a->getText(), $b->getText() );
    }
 
    public function isValid() {
        if ( $this->mIsValid !== null ) {
            return $this->mIsValid;
        }
 
        try {
            $text = $this->getFullText();
            $titleCodec = MediaWikiServices::getInstance()->getTitleParser();
 
            '@phan-var MediaWikiTitleCodec $titleCodec';
            $parts = $titleCodec->splitTitleString( $text, $this->mNamespace );
 
            // Check that nothing changed!
            // This ensures that $text was already perperly normalized.
            if ( $parts['fragment'] !== $this->mFragment
                || $parts['interwiki'] !== $this->mInterwiki
                || $parts['local_interwiki'] !== $this->mLocalInterwiki
                || $parts['namespace'] !== $this->mNamespace
                || $parts['dbkey'] !== $this->mDbkeyform
            ) {
                $this->mIsValid = false;
                return $this->mIsValid;
            }
        } catch ( MalformedTitleException $ex ) {
            $this->mIsValid = false;
            return $this->mIsValid;
        }
 
        $this->mIsValid = true;
        return $this->mIsValid;
    }
 
    public function isLocal() {
        if ( $this->isExternal() ) {
            $iw = self::getInterwikiLookup()->fetch( $this->mInterwiki );
            if ( $iw ) {
                return $iw->isLocal();
            }
        }
        return true;
    }
 
    public function isExternal() {
        return $this->mInterwiki !== '';
    }
 
    public function getInterwiki() {
        return $this->mInterwiki;
    }
 
    public function wasLocalInterwiki() {
        return $this->mLocalInterwiki;
    }
 
    public function isTrans() {
        if ( !$this->isExternal() ) {
            return false;
        }
 
        return self::getInterwikiLookup()->fetch( $this->mInterwiki )->isTranscludable();
    }
 
    public function getTransWikiID() {
        if ( !$this->isExternal() ) {
            return false;
        }
 
        return self::getInterwikiLookup()->fetch( $this->mInterwiki )->getWikiID();
    }
 
    public function getTitleValue() {
        if ( $this->mTitleValue === null ) {
            try {
                $this->mTitleValue = new TitleValue(
                    $this->mNamespace,
                    $this->mDbkeyform,
                    $this->mFragment,
                    $this->mInterwiki
                );
            } catch ( InvalidArgumentException $ex ) {
                wfDebug( __METHOD__ . ': Can\'t create a TitleValue for [[' .
                    $this->getPrefixedText() . ']]: ' . $ex->getMessage() );
            }
        }
 
        return $this->mTitleValue;
    }
 
    public function getText() {
        return $this->mTextform;
    }
 
    public function getPartialURL() {
        return $this->mUrlform;
    }
 
    public function getDBkey(): string {
        return $this->mDbkeyform;
    }
 
    public function getNamespace(): int {
        return $this->mNamespace;
    }
 
    public function getContentModel( $flags = 0 ) {
        if ( $this->mForcedContentModel ) {
            if ( !$this->mContentModel ) {
                throw new RuntimeException( 'Got out of sync; an empty model is being forced' );
            }
            // Content model is locked to the currently loaded one
            return $this->mContentModel;
        }
 
        if ( DBAccessObjectUtils::hasFlags( $flags, self::READ_LATEST ) ) {
            $this->lazyFillContentModel( $this->loadFieldFromDB( 'page_content_model', $flags ) );
        } elseif (
            ( !$this->mContentModel || $flags & self::GAID_FOR_UPDATE ) &&
            $this->getArticleID( $flags )
        ) {
            $linkCache = MediaWikiServices::getInstance()->getLinkCache();
            $linkCache->addLinkObj( $this ); # in case we already had an article ID
            $this->lazyFillContentModel( $linkCache->getGoodLinkFieldObj( $this, 'model' ) );
        }
 
        if ( !$this->mContentModel ) {
            $this->lazyFillContentModel( ContentHandler::getDefaultModelFor( $this ) );
        }
 
        return $this->mContentModel;
    }
 
    public function hasContentModel( $id ) {
        return $this->getContentModel() == $id;
    }
 
    public function setContentModel( $model ) {
        if ( (string)$model === '' ) {
            throw new InvalidArgumentException( "Missing CONTENT_MODEL_* constant" );
        }
 
        $this->mContentModel = $model;
        $this->mForcedContentModel = true;
    }
 
    private function lazyFillContentModel( $model ) {
        if ( !$this->mForcedContentModel ) {
            $this->mContentModel = ( $model === false ) ? false : (string)$model;
        }
    }
 
    public function getNsText() {
        if ( $this->isExternal() ) {
            // This probably shouldn't even happen, except for interwiki transclusion.
            // If possible, use the canonical name for the foreign namespace.
            $nsText = MediaWikiServices::getInstance()->getNamespaceInfo()->
                getCanonicalName( $this->mNamespace );
            if ( $nsText !== false ) {
                return $nsText;
            }
        }
 
        try {
            $formatter = self::getTitleFormatter();
            return $formatter->getNamespaceName( $this->mNamespace, $this->mDbkeyform );
        } catch ( InvalidArgumentException $ex ) {
            wfDebug( __METHOD__ . ': ' . $ex->getMessage() );
            return false;
        }
    }
 
    public function getSubjectNsText() {
        $services = MediaWikiServices::getInstance();
        return $services->getContentLanguage()->
            getNsText( $services->getNamespaceInfo()->getSubject( $this->mNamespace ) );
    }
 
    public function getTalkNsText() {
        $services = MediaWikiServices::getInstance();
        return $services->getContentLanguage()->
            getNsText( $services->getNamespaceInfo()->getTalk( $this->mNamespace ) );
    }
 
    public function canHaveTalkPage() {
        return MediaWikiServices::getInstance()->getNamespaceInfo()->canHaveTalkPage( $this );
    }
 
    public function canExist(): bool {
        // NOTE: Don't use getArticleID(), we don't want to
        // trigger a database query here. This check is supposed to
        // act as an optimization, not add extra cost.
        if ( $this->mArticleID > 0 ) {
            // It exists, so it can exist.
            return true;
        }
 
        // NOTE: we call the relatively expensive isValid() method further down,
        // but we can bail out early if we already know the title is invalid.
        if ( $this->mIsValid === false ) {
            // It's invalid, so it can't exist.
            return false;
        }
 
        if ( $this->getNamespace() < NS_MAIN ) {
            // It's a special page, so it can't exist in the database.
            return false;
        }
 
        if ( $this->isExternal() ) {
            // If it's external, it's not local, so it can't exist.
            return false;
        }
 
        if ( $this->getText() === '' ) {
            // The title has no text, so it can't exist in the database.
            // It's probably an on-page section link, like "#something".
            return false;
        }
 
        // Double check that the title is valid.
        return $this->isValid();
    }
 
    public function isWatchable() {
        $nsInfo = MediaWikiServices::getInstance()->getNamespaceInfo();
        return $this->getText() !== '' && !$this->isExternal() &&
            $nsInfo->isWatchable( $this->mNamespace );
    }
 
    public function isSpecialPage() {
        return $this->mNamespace === NS_SPECIAL;
    }
 
    public function isSpecial( $name ) {
        if ( $this->isSpecialPage() ) {
            list( $thisName, /* $subpage */ ) =
                MediaWikiServices::getInstance()->getSpecialPageFactory()->
                    resolveAlias( $this->mDbkeyform );
            if ( $name == $thisName ) {
                return true;
            }
        }
        return false;
    }
 
    public function fixSpecialName() {
        if ( $this->isSpecialPage() ) {
            $spFactory = MediaWikiServices::getInstance()->getSpecialPageFactory();
            list( $canonicalName, $par ) = $spFactory->resolveAlias( $this->mDbkeyform );
            if ( $canonicalName ) {
                $localName = $spFactory->getLocalNameFor( $canonicalName, $par );
                if ( $localName != $this->mDbkeyform ) {
                    return self::makeTitle( NS_SPECIAL, $localName );
                }
            }
        }
        return $this;
    }
 
    public function inNamespace( $ns ) {
        return MediaWikiServices::getInstance()->getNamespaceInfo()->
            equals( $this->mNamespace, $ns );
    }
 
    public function inNamespaces( ...$namespaces ) {
        if ( count( $namespaces ) > 0 && is_array( $namespaces[0] ) ) {
            $namespaces = $namespaces[0];
        }
 
        foreach ( $namespaces as $ns ) {
            if ( $this->inNamespace( $ns ) ) {
                return true;
            }
        }
 
        return false;
    }
 
    public function hasSubjectNamespace( $ns ) {
        return MediaWikiServices::getInstance()->getNamespaceInfo()->
            subjectEquals( $this->mNamespace, $ns );
    }
 
    public function isContentPage() {
        return MediaWikiServices::getInstance()->getNamespaceInfo()->
            isContent( $this->mNamespace );
    }
 
    public function isMovable() {
        if (
            !MediaWikiServices::getInstance()->getNamespaceInfo()->
                isMovable( $this->mNamespace ) || $this->isExternal()
        ) {
            // Interwiki title or immovable namespace. Hooks don't get to override here
            return false;
        }
 
        $result = true;
        Hooks::runner()->onTitleIsMovable( $this, $result );
        return $result;
    }
 
    public function isMainPage() {
        return $this->equals( self::newMainPage() );
    }
 
    public function isSubpage() {
        return MediaWikiServices::getInstance()->getNamespaceInfo()->
            hasSubpages( $this->mNamespace )
            ? strpos( $this->getText(), '/' ) !== false
            : false;
    }
 
    public function isConversionTable() {
        // @todo ConversionTable should become a separate content model.
 
        return $this->mNamespace === NS_MEDIAWIKI &&
            strpos( $this->getText(), 'Conversiontable/' ) === 0;
    }
 
    public function isWikitextPage() {
        return $this->hasContentModel( CONTENT_MODEL_WIKITEXT );
    }
 
    public function isSiteConfigPage() {
        return (
            $this->isSiteCssConfigPage()
            || $this->isSiteJsonConfigPage()
            || $this->isSiteJsConfigPage()
        );
    }
 
    public function isUserConfigPage() {
        return (
            $this->isUserCssConfigPage()
            || $this->isUserJsonConfigPage()
            || $this->isUserJsConfigPage()
        );
    }
 
    public function getSkinFromConfigSubpage() {
        $subpage = explode( '/', $this->mTextform );
        $subpage = $subpage[count( $subpage ) - 1];
        $lastdot = strrpos( $subpage, '.' );
        if ( $lastdot === false ) {
            return $subpage; # Never happens: only called for names ending in '.css'/'.json'/'.js'
        }
        return substr( $subpage, 0, $lastdot );
    }
 
    public function isUserCssConfigPage() {
        return (
            $this->mNamespace === NS_USER
            && $this->isSubpage()
            && $this->hasContentModel( CONTENT_MODEL_CSS )
        );
    }
 
    public function isUserJsonConfigPage() {
        return (
            $this->mNamespace === NS_USER
            && $this->isSubpage()
            && $this->hasContentModel( CONTENT_MODEL_JSON )
        );
    }
 
    public function isUserJsConfigPage() {
        return (
            $this->mNamespace === NS_USER
            && $this->isSubpage()
            && $this->hasContentModel( CONTENT_MODEL_JAVASCRIPT )
        );
    }
 
    public function isSiteCssConfigPage() {
        return (
            $this->mNamespace === NS_MEDIAWIKI
            && (
                $this->hasContentModel( CONTENT_MODEL_CSS )
                // paranoia - a MediaWiki: namespace page with mismatching extension and content
                // model is probably by mistake and might get handled incorrectly (see e.g. T112937)
                || substr( $this->mDbkeyform, -4 ) === '.css'
            )
        );
    }
 
    public function isSiteJsonConfigPage() {
        return (
            $this->mNamespace === NS_MEDIAWIKI
            && (
                $this->hasContentModel( CONTENT_MODEL_JSON )
                // paranoia - a MediaWiki: namespace page with mismatching extension and content
                // model is probably by mistake and might get handled incorrectly (see e.g. T112937)
                || substr( $this->mDbkeyform, -5 ) === '.json'
            )
        );
    }
 
    public function isSiteJsConfigPage() {
        return (
            $this->mNamespace === NS_MEDIAWIKI
            && (
                $this->hasContentModel( CONTENT_MODEL_JAVASCRIPT )
                // paranoia - a MediaWiki: namespace page with mismatching extension and content
                // model is probably by mistake and might get handled incorrectly (see e.g. T112937)
                || substr( $this->mDbkeyform, -3 ) === '.js'
            )
        );
    }
 
    public function isRawHtmlMessage() {
        global $wgRawHtmlMessages;
 
        if ( !$this->inNamespace( NS_MEDIAWIKI ) ) {
            return false;
        }
        $message = lcfirst( $this->getRootTitle()->getDBkey() );
        return in_array( $message, $wgRawHtmlMessages, true );
    }
 
    public function isTalkPage() {
        return MediaWikiServices::getInstance()->getNamespaceInfo()->
            isTalk( $this->mNamespace );
    }
 
    public function getTalkPage() {
        // NOTE: The equivalent code in NamespaceInfo is less lenient about producing invalid titles.
        //       Instead of failing on invalid titles, let's just log the issue for now.
        //       See the discussion on T227817.
 
        // Is this the same title?
        $talkNS = MediaWikiServices::getInstance()->getNamespaceInfo()->getTalk( $this->mNamespace );
        if ( $this->mNamespace == $talkNS ) {
            return $this;
        }
 
        $title = self::makeTitle( $talkNS, $this->mDbkeyform );
 
        $this->warnIfPageCannotExist( $title, __METHOD__ );
 
        return $title;
        // TODO: replace the above with the code below:
        // return self::castFromLinkTarget(
        // MediaWikiServices::getInstance()->getNamespaceInfo()->getTalkPage( $this ) );
    }
 
    public function getTalkPageIfDefined() {
        if ( !$this->canHaveTalkPage() ) {
            return null;
        }
 
        return $this->getTalkPage();
    }
 
    public function getSubjectPage() {
        // Is this the same title?
        $subjectNS = MediaWikiServices::getInstance()->getNamespaceInfo()
            ->getSubject( $this->mNamespace );
        if ( $this->mNamespace == $subjectNS ) {
            return $this;
        }
        // NOTE: The equivalent code in NamespaceInfo is less lenient about producing invalid titles.
        //       Instead of failing on invalid titles, let's just log the issue for now.
        //       See the discussion on T227817.
        $title = self::makeTitle( $subjectNS, $this->mDbkeyform );
 
        $this->warnIfPageCannotExist( $title, __METHOD__ );
 
        return $title;
        // TODO: replace the above with the code below:
        // return self::castFromLinkTarget(
        // MediaWikiServices::getInstance()->getNamespaceInfo()->getSubjectPage( $this ) );
    }
 
    private function warnIfPageCannotExist( Title $title, $method ) {
        if ( $this->getText() == '' ) {
            wfLogWarning(
                $method . ': called on empty title ' . $this->getFullText() . ', returning '
                . $title->getFullText()
            );
 
            return true;
        }
 
        if ( $this->getInterwiki() !== '' ) {
            wfLogWarning(
                $method . ': called on interwiki title ' . $this->getFullText() . ', returning '
                . $title->getFullText()
            );
 
            return true;
        }
 
        return false;
    }
 
    public function getOtherPage() {
        // NOTE: Depend on the methods in this class instead of their equivalent in NamespaceInfo,
        //       until their semantics has become exactly the same.
        //       See the discussion on T227817.
        if ( $this->isSpecialPage() ) {
            throw new MWException( 'Special pages cannot have other pages' );
        }
        if ( $this->isTalkPage() ) {
            return $this->getSubjectPage();
        } else {
            if ( !$this->canHaveTalkPage() ) {
                throw new MWException( "{$this->getPrefixedText()} does not have an other page" );
            }
            return $this->getTalkPage();
        }
        // TODO: replace the above with the code below:
        // return self::castFromLinkTarget(
        // MediaWikiServices::getInstance()->getNamespaceInfo()->getAssociatedPage( $this ) );
    }
 
    public function getDefaultNamespace() {
        return $this->mDefaultNamespace;
    }
 
    public function getFragment() {
        return $this->mFragment;
    }
 
    public function hasFragment() {
        return $this->mFragment !== '';
    }
 
    public function getFragmentForURL() {
        if ( !$this->hasFragment() ) {
            return '';
        } elseif ( $this->isExternal() ) {
            // Note: If the interwiki is unknown, it's treated as a namespace on the local wiki,
            // so we treat it like a local interwiki.
            $interwiki = self::getInterwikiLookup()->fetch( $this->mInterwiki );
            if ( $interwiki && !$interwiki->isLocal() ) {
                return '#' . Sanitizer::escapeIdForExternalInterwiki( $this->mFragment );
            }
        }
 
        return '#' . Sanitizer::escapeIdForLink( $this->mFragment );
    }
 
    public function setFragment( $fragment ) {
        $this->mFragment = strtr( substr( $fragment, 1 ), '_', ' ' );
    }
 
    public function createFragmentTarget( $fragment ) {
        return self::makeTitle(
            $this->mNamespace,
            $this->getText(),
            $fragment,
            $this->mInterwiki
        );
    }
 
    private function prefix( $name ) {
        $p = '';
        if ( $this->isExternal() ) {
            $p = $this->mInterwiki . ':';
        }
 
        if ( $this->mNamespace != 0 ) {
            $nsText = $this->getNsText();
 
            if ( $nsText === false ) {
                // See T165149. Awkward, but better than erroneously linking to the main namespace.
                $nsText = MediaWikiServices::getInstance()->getContentLanguage()->
                    getNsText( NS_SPECIAL ) . ":Badtitle/NS{$this->mNamespace}";
            }
 
            $p .= $nsText . ':';
        }
        return $p . $name;
    }
 
    public function getPrefixedDBkey() {
        $s = $this->prefix( $this->mDbkeyform );
        $s = strtr( $s, ' ', '_' );
        return $s;
    }
 
    public function getPrefixedText() {
        if ( $this->prefixedText === null ) {
            $s = $this->prefix( $this->mTextform );
            $s = strtr( $s, '_', ' ' );
            $this->prefixedText = $s;
        }
        return $this->prefixedText;
    }
 
    public function __toString(): string {
        return $this->getPrefixedText();
    }
 
    public function getFullText() {
        $text = $this->getPrefixedText();
        if ( $this->hasFragment() ) {
            $text .= '#' . $this->mFragment;
        }
        return $text;
    }
 
    private function findSubpageDivider( $text, $dir ) {
        $top = strlen( $text ) - 1;
        $bottom = 0;
 
        while ( $bottom < $top && $text[$bottom] === '/' ) {
            $bottom++;
        }
 
        if ( $top < $bottom ) {
            return false;
        }
 
        if ( $dir > 0 ) {
            $idx = $bottom;
            while ( $idx <= $top && $text[$idx] !== '/' ) {
                $idx++;
            }
        } else {
            $idx = $top;
            while ( $idx > $bottom && $text[$idx] !== '/' ) {
                $idx--;
            }
        }
 
        if ( $idx < $bottom || $idx > $top ) {
            return false;
        }
 
        if ( $idx < 1 ) {
            return false;
        }
 
        return $idx;
    }
 
    private function hasSubpagesEnabled() {
        return MediaWikiServices::getInstance()->getNamespaceInfo()->
            hasSubpages( $this->mNamespace );
    }
 
    public function getRootText() {
        $text = $this->getText();
        if ( !$this->hasSubpagesEnabled() ) {
            return $text;
        }
 
        $firstSlashPos = $this->findSubpageDivider( $text, +1 );
        // Don't discard the real title if there's no subpage involved
        if ( $firstSlashPos === false ) {
            return $text;
        }
 
        return substr( $text, 0, $firstSlashPos );
    }
 
    public function getRootTitle() {
        $title = self::makeTitleSafe( $this->mNamespace, $this->getRootText() );
        Assert::postcondition(
            $title !== null,
            'makeTitleSafe() should always return a Title for the text returned by getRootText().'
        );
        return $title;
    }
 
    public function getBaseText() {
        $text = $this->getText();
        if ( !$this->hasSubpagesEnabled() ) {
            return $text;
        }
 
        $lastSlashPos = $this->findSubpageDivider( $text, -1 );
        // Don't discard the real title if there's no subpage involved
        if ( $lastSlashPos === false ) {
            return $text;
        }
 
        return substr( $text, 0, $lastSlashPos );
    }
 
    public function getBaseTitle() {
        $title = self::makeTitleSafe( $this->mNamespace, $this->getBaseText() );
        Assert::postcondition(
            $title !== null,
            'makeTitleSafe() should always return a Title for the text returned by getBaseText().'
        );
        return $title;
    }
 
    public function getSubpageText() {
        $text = $this->getText();
        if ( !$this->hasSubpagesEnabled() ) {
            return $text;
        }
 
        $lastSlashPos = $this->findSubpageDivider( $text, -1 );
        if ( $lastSlashPos === false ) {
            // T256922 - Return the title text if no subpages
            return $text;
        }
        return substr( $text, $lastSlashPos + 1 );
    }
 
    public function getSubpage( $text ) {
        return self::makeTitleSafe(
            $this->mNamespace,
            $this->getText() . '/' . $text,
            '',
            $this->mInterwiki
        );
    }
 
    public function getSubpageUrlForm() {
        $text = $this->getSubpageText();
        $text = wfUrlencode( strtr( $text, ' ', '_' ) );
        return $text;
    }
 
    public function getPrefixedURL() {
        $s = $this->prefix( $this->mDbkeyform );
        $s = wfUrlencode( strtr( $s, ' ', '_' ) );
        return $s;
    }
 
    private static function fixUrlQueryArgs( $query, $query2 = false ) {
        if ( $query2 !== false ) {
            wfDeprecatedMsg( "Title::get{Canonical,Full,Link,Local,Internal}URL " .
                "method called with a second parameter is deprecated since MediaWiki 1.19. " .
                "Add your parameter to an array passed as the first parameter.", "1.19" );
        }
        if ( is_array( $query ) ) {
            $query = wfArrayToCgi( $query );
        }
        if ( $query2 ) {
            if ( is_string( $query2 ) ) {
                // $query2 is a string, we will consider this to be
                // a deprecated $variant argument and add it to the query
                $query2 = wfArrayToCgi( [ 'variant' => $query2 ] );
            } else {
                $query2 = wfArrayToCgi( $query2 );
            }
            // If we have $query content add a & to it first
            if ( $query ) {
                $query .= '&';
            }
            // Now append the queries together
            $query .= $query2;
        }
        return $query;
    }
 
    public function getFullURL( $query = '', $query2 = false, $proto = PROTO_RELATIVE ) {
        $query = self::fixUrlQueryArgs( $query, $query2 );
 
        # Hand off all the decisions on urls to getLocalURL
        $url = $this->getLocalURL( $query );
 
        # Expand the url to make it a full url. Note that getLocalURL has the
        # potential to output full urls for a variety of reasons, so we use
        # wfExpandUrl instead of simply prepending $wgServer
        $url = wfExpandUrl( $url, $proto );
 
        # Finally, add the fragment.
        $url .= $this->getFragmentForURL();
        Hooks::runner()->onGetFullURL( $this, $url, $query );
        return $url;
    }
 
    public function getFullUrlForRedirect( $query = '', $proto = PROTO_CURRENT ) {
        $target = $this;
        if ( $this->isExternal() ) {
            $target = SpecialPage::getTitleFor(
                'GoToInterwiki',
                $this->getPrefixedDBkey()
            );
        }
        return $target->getFullURL( $query, false, $proto );
    }
 
    public function getLocalURL( $query = '', $query2 = false ) {
        global $wgArticlePath, $wgScript, $wgServer, $wgRequest, $wgMainPageIsDomainRoot;
 
        $query = self::fixUrlQueryArgs( $query, $query2 );
 
        $interwiki = self::getInterwikiLookup()->fetch( $this->mInterwiki );
        if ( $interwiki ) {
            $namespace = $this->getNsText();
            if ( $namespace != '' ) {
                # Can this actually happen? Interwikis shouldn't be parsed.
                # Yes! It can in interwiki transclusion. But... it probably shouldn't.
                $namespace .= ':';
            }
            $url = $interwiki->getURL( $namespace . $this->mDbkeyform );
            $url = wfAppendQuery( $url, $query );
        } else {
            $dbkey = wfUrlencode( $this->getPrefixedDBkey() );
            if ( $query == '' ) {
                $url = str_replace( '$1', $dbkey, $wgArticlePath );
                Hooks::runner()->onGetLocalURL__Article( $this, $url );
            } else {
                global $wgVariantArticlePath, $wgActionPaths;
                $url = false;
                $matches = [];
 
                $articlePaths = PathRouter::getActionPaths( $wgActionPaths, $wgArticlePath );
 
                if ( $articlePaths
                    && preg_match( '/^(.*&|)action=([^&]*)(&(.*)|)$/', $query, $matches )
                ) {
                    $action = urldecode( $matches[2] );
                    if ( isset( $articlePaths[$action] ) ) {
                        $query = $matches[1];
                        if ( isset( $matches[4] ) ) {
                            $query .= $matches[4];
                        }
                        $url = str_replace( '$1', $dbkey, $articlePaths[$action] );
                        if ( $query != '' ) {
                            $url = wfAppendQuery( $url, $query );
                        }
                    }
                }
 
                if ( $url === false
                    && $wgVariantArticlePath
                    && preg_match( '/^variant=([^&]*)$/', $query, $matches )
                    && $this->getPageLanguage()->equals(
                        MediaWikiServices::getInstance()->getContentLanguage() )
                    && $this->getPageLanguageConverter()->hasVariants()
                ) {
                    $variant = urldecode( $matches[1] );
                    if ( $this->getPageLanguageConverter()->hasVariant( $variant ) ) {
                        // Only do the variant replacement if the given variant is a valid
                        // variant for the page's language.
                        $url = str_replace( '$2', urlencode( $variant ), $wgVariantArticlePath );
                        $url = str_replace( '$1', $dbkey, $url );
                    }
                }
 
                if ( $url === false ) {
                    if ( $query == '-' ) {
                        $query = '';
                    }
                    $url = "{$wgScript}?title={$dbkey}&{$query}";
                }
            }
            Hooks::runner()->onGetLocalURL__Internal( $this, $url, $query );
 
            // @todo FIXME: This causes breakage in various places when we
            // actually expected a local URL and end up with dupe prefixes.
            if ( $wgRequest->getVal( 'action' ) == 'render' ) {
                LoggerFactory::getInstance( 'T263581' )
                    ->debug(
                        "Title::getLocalURL called from render action",
                        [
                            'title' => $this->getPrefixedDBkey(),
                            'exception' => new Exception()
                        ]
                    );
                $url = $wgServer . $url;
            }
        }
 
        if ( $wgMainPageIsDomainRoot && $this->isMainPage() && $query === '' ) {
            return '/';
        }
 
        Hooks::runner()->onGetLocalURL( $this, $url, $query );
        return $url;
    }
 
    public function getLinkURL( $query = '', $query2 = false, $proto = false ) {
        if ( $this->isExternal() || $proto !== false ) {
            $ret = $this->getFullURL( $query, $query2, $proto );
        } elseif ( $this->getPrefixedText() === '' && $this->hasFragment() ) {
            $ret = $this->getFragmentForURL();
        } else {
            $ret = $this->getLocalURL( $query, $query2 ) . $this->getFragmentForURL();
        }
        return $ret;
    }
 
    public function getInternalURL( $query = '', $query2 = false ) {
        global $wgInternalServer, $wgServer;
        $query = self::fixUrlQueryArgs( $query, $query2 );
        $server = $wgInternalServer !== false ? $wgInternalServer : $wgServer;
        $url = wfExpandUrl( $server . $this->getLocalURL( $query ), PROTO_HTTP );
        Hooks::runner()->onGetInternalURL( $this, $url, $query );
        return $url;
    }
 
    public function getCanonicalURL( $query = '', $query2 = false ) {
        $query = self::fixUrlQueryArgs( $query, $query2 );
        $url = wfExpandUrl( $this->getLocalURL( $query ) . $this->getFragmentForURL(), PROTO_CANONICAL );
        Hooks::runner()->onGetCanonicalURL( $this, $url, $query );
        return $url;
    }
 
    public function getEditURL() {
        if ( $this->isExternal() ) {
            return '';
        }
        $s = $this->getLocalURL( 'action=edit' );
 
        return $s;
    }
 
    public static function getFilteredRestrictionTypes( $exists = true ) {
        global $wgRestrictionTypes;
        $types = $wgRestrictionTypes;
        if ( $exists ) {
            # Remove the create restriction for existing titles
            $types = array_diff( $types, [ 'create' ] );
        } else {
            # Only the create and upload restrictions apply to non-existing titles
            $types = array_intersect( $types, [ 'create', 'upload' ] );
        }
        return $types;
    }
 
    public function getRestrictionTypes() {
        if ( $this->isSpecialPage() ) {
            return [];
        }
 
        $types = self::getFilteredRestrictionTypes( $this->exists() );
 
        if ( $this->mNamespace !== NS_FILE ) {
            # Remove the upload restriction for non-file titles
            $types = array_diff( $types, [ 'upload' ] );
        }
 
        Hooks::runner()->onTitleGetRestrictionTypes( $this, $types );
 
        wfDebug( __METHOD__ . ': applicable restrictions to [[' .
            $this->getPrefixedText() . ']] are {' . implode( ',', $types ) . "}" );
 
        return $types;
    }
 
    public function getTitleProtection() {
        $protection = $this->getTitleProtectionInternal();
        if ( $protection ) {
            if ( $protection['permission'] == 'sysop' ) {
                $protection['permission'] = 'editprotected'; // B/C
            }
            if ( $protection['permission'] == 'autoconfirmed' ) {
                $protection['permission'] = 'editsemiprotected'; // B/C
            }
        }
        return $protection;
    }
 
    protected function getTitleProtectionInternal() {
        // Can't protect pages in special namespaces
        if ( $this->mNamespace < 0 ) {
            return false;
        }
 
        // Can't protect pages that exist.
        if ( $this->exists() ) {
            return false;
        }
 
        if ( $this->mTitleProtection === null ) {
            $dbr = wfGetDB( DB_REPLICA );
            $commentStore = CommentStore::getStore();
            $commentQuery = $commentStore->getJoin( 'pt_reason' );
            $res = $dbr->select(
                [ 'protected_titles' ] + $commentQuery['tables'],
                [
                    'user' => 'pt_user',
                    'expiry' => 'pt_expiry',
                    'permission' => 'pt_create_perm'
                ] + $commentQuery['fields'],
                [ 'pt_namespace' => $this->mNamespace, 'pt_title' => $this->mDbkeyform ],
                __METHOD__,
                [],
                $commentQuery['joins']
            );
 
            // fetchRow returns false if there are no rows.
            $row = $dbr->fetchRow( $res );
            if ( $row ) {
                $this->mTitleProtection = [
                    'user' => $row['user'],
                    'expiry' => $dbr->decodeExpiry( $row['expiry'] ),
                    'permission' => $row['permission'],
                    'reason' => $commentStore->getComment( 'pt_reason', $row )->text,
                ];
            } else {
                $this->mTitleProtection = false;
            }
        }
        return $this->mTitleProtection;
    }
 
    public function deleteTitleProtection() {
        $dbw = wfGetDB( DB_MASTER );
 
        $dbw->delete(
            'protected_titles',
            [ 'pt_namespace' => $this->mNamespace, 'pt_title' => $this->mDbkeyform ],
            __METHOD__
        );
        $this->mTitleProtection = false;
    }
 
    public function isSemiProtected( $action = 'edit' ) {
        global $wgSemiprotectedRestrictionLevels;
 
        $restrictions = $this->getRestrictions( $action );
        $semi = $wgSemiprotectedRestrictionLevels;
        if ( !$restrictions || !$semi ) {
            // Not protected, or all protection is full protection
            return false;
        }
 
        // Remap autoconfirmed to editsemiprotected for BC
        foreach ( array_keys( $semi, 'autoconfirmed' ) as $key ) {
            $semi[$key] = 'editsemiprotected';
        }
        foreach ( array_keys( $restrictions, 'autoconfirmed' ) as $key ) {
            $restrictions[$key] = 'editsemiprotected';
        }
 
        return !array_diff( $restrictions, $semi );
    }
 
    public function isProtected( $action = '' ) {
        global $wgRestrictionLevels;
 
        $restrictionTypes = $this->getRestrictionTypes();
 
        # Special pages have inherent protection
        if ( $this->isSpecialPage() ) {
            return true;
        }
 
        # Check regular protection levels
        foreach ( $restrictionTypes as $type ) {
            if ( $action == $type || $action == '' ) {
                $r = $this->getRestrictions( $type );
                foreach ( $wgRestrictionLevels as $level ) {
                    if ( in_array( $level, $r ) && $level != '' ) {
                        return true;
                    }
                }
            }
        }
 
        return false;
    }
 
    public function isNamespaceProtected( User $user ) {
        global $wgNamespaceProtection;
 
        if ( isset( $wgNamespaceProtection[$this->mNamespace] ) ) {
            $permissionManager = MediaWikiServices::getInstance()->getPermissionManager();
            foreach ( (array)$wgNamespaceProtection[$this->mNamespace] as $right ) {
                if ( !$permissionManager->userHasRight( $user, $right ) ) {
                    return true;
                }
            }
        }
        return false;
    }
 
    public function isCascadeProtected() {
        list( $isCascadeProtected, ) = $this->getCascadeProtectionSources( false );
        return $isCascadeProtected;
    }
 
    public function areCascadeProtectionSourcesLoaded( $getPages = true ) {
        return $getPages ? $this->mCascadeSources !== null : $this->mHasCascadingRestrictions !== null;
    }
 
    public function getCascadeProtectionSources( $getPages = true ) {
        $pagerestrictions = [];
 
        if ( $this->mCascadeSources !== null && $getPages ) {
            return [ $this->mCascadeSources, $this->mCascadingRestrictions ];
        } elseif ( $this->mHasCascadingRestrictions !== null && !$getPages ) {
            return [ $this->mHasCascadingRestrictions, $pagerestrictions ];
        }
 
        $dbr = wfGetDB( DB_REPLICA );
 
        if ( $this->mNamespace === NS_FILE ) {
            $tables = [ 'imagelinks', 'page_restrictions' ];
            $where_clauses = [
                'il_to' => $this->mDbkeyform,
                'il_from=pr_page',
                'pr_cascade' => 1
            ];
        } else {
            $tables = [ 'templatelinks', 'page_restrictions' ];
            $where_clauses = [
                'tl_namespace' => $this->mNamespace,
                'tl_title' => $this->mDbkeyform,
                'tl_from=pr_page',
                'pr_cascade' => 1
            ];
        }
 
        if ( $getPages ) {
            $cols = [ 'pr_page', 'page_namespace', 'page_title',
                'pr_expiry', 'pr_type', 'pr_level' ];
            $where_clauses[] = 'page_id=pr_page';
            $tables[] = 'page';
        } else {
            $cols = [ 'pr_expiry' ];
        }
 
        $res = $dbr->select( $tables, $cols, $where_clauses, __METHOD__ );
 
        $sources = $getPages ? [] : false;
        $now = wfTimestampNow();
 
        foreach ( $res as $row ) {
            $expiry = $dbr->decodeExpiry( $row->pr_expiry );
            if ( $expiry > $now ) {
                if ( $getPages ) {
                    $page_id = $row->pr_page;
                    $page_ns = $row->page_namespace;
                    $page_title = $row->page_title;
                    $sources[$page_id] = self::makeTitle( $page_ns, $page_title );
                    # Add groups needed for each restriction type if its not already there
                    # Make sure this restriction type still exists
 
                    if ( !isset( $pagerestrictions[$row->pr_type] ) ) {
                        $pagerestrictions[$row->pr_type] = [];
                    }
 
                    if (
                        isset( $pagerestrictions[$row->pr_type] )
                        && !in_array( $row->pr_level, $pagerestrictions[$row->pr_type] )
                    ) {
                        $pagerestrictions[$row->pr_type][] = $row->pr_level;
                    }
                } else {
                    $sources = true;
                }
            }
        }
 
        if ( $getPages ) {
            $this->mCascadeSources = $sources;
            $this->mCascadingRestrictions = $pagerestrictions;
        } else {
            $this->mHasCascadingRestrictions = $sources;
        }
 
        return [ $sources, $pagerestrictions ];
    }
 
    public function areRestrictionsLoaded() {
        return $this->mRestrictionsLoaded;
    }
 
    public function getRestrictions( $action ) {
        if ( !$this->mRestrictionsLoaded ) {
            $this->loadRestrictions();
        }
        return $this->mRestrictions[$action] ?? [];
    }
 
    public function getAllRestrictions() {
        if ( !$this->mRestrictionsLoaded ) {
            $this->loadRestrictions();
        }
        return $this->mRestrictions;
    }
 
    public function getRestrictionExpiry( $action ) {
        if ( !$this->mRestrictionsLoaded ) {
            $this->loadRestrictions();
        }
        return $this->mRestrictionsExpiry[$action] ?? false;
    }
 
    public function areRestrictionsCascading() {
        if ( !$this->mRestrictionsLoaded ) {
            $this->loadRestrictions();
        }
 
        return $this->mCascadeRestriction;
    }
 
    public function loadRestrictionsFromRows( $rows, $oldFashionedRestrictions = null ) {
        // This function will only read rows from a table that we migrated away
        // from before adding READ_LATEST support to loadRestrictions, so we
        // don't need to support reading from DB_MASTER here.
        $dbr = wfGetDB( DB_REPLICA );
 
        $restrictionTypes = $this->getRestrictionTypes();
 
        foreach ( $restrictionTypes as $type ) {
            $this->mRestrictions[$type] = [];
            $this->mRestrictionsExpiry[$type] = 'infinity';
        }
 
        $this->mCascadeRestriction = false;
 
        # Backwards-compatibility: also load the restrictions from the page record (old format).
        if ( $oldFashionedRestrictions !== null ) {
            $this->mOldRestrictions = $oldFashionedRestrictions;
        }
 
        if ( $this->mOldRestrictions === false ) {
            $linkCache = MediaWikiServices::getInstance()->getLinkCache();
            $linkCache->addLinkObj( $this ); # in case we already had an article ID
            $this->mOldRestrictions = $linkCache->getGoodLinkFieldObj( $this, 'restrictions' );
        }
 
        if ( $this->mOldRestrictions != '' ) {
            foreach ( explode( ':', trim( $this->mOldRestrictions ) ) as $restrict ) {
                $temp = explode( '=', trim( $restrict ) );
                if ( count( $temp ) == 1 ) {
                    // old old format should be treated as edit/move restriction
                    $this->mRestrictions['edit'] = explode( ',', trim( $temp[0] ) );
                    $this->mRestrictions['move'] = explode( ',', trim( $temp[0] ) );
                } else {
                    $restriction = trim( $temp[1] );
                    if ( $restriction != '' ) { // some old entries are empty
                        $this->mRestrictions[$temp[0]] = explode( ',', $restriction );
                    }
                }
            }
        }
 
        if ( count( $rows ) ) {
            # Current system - load second to make them override.
            $now = wfTimestampNow();
 
            # Cycle through all the restrictions.
            foreach ( $rows as $row ) {
                // Don't take care of restrictions types that aren't allowed
                if ( !in_array( $row->pr_type, $restrictionTypes ) ) {
                    continue;
                }
 
                $expiry = $dbr->decodeExpiry( $row->pr_expiry );
 
                // Only apply the restrictions if they haven't expired!
                if ( !$expiry || $expiry > $now ) {
                    $this->mRestrictionsExpiry[$row->pr_type] = $expiry;
                    $this->mRestrictions[$row->pr_type] = explode( ',', trim( $row->pr_level ) );
 
                    $this->mCascadeRestriction = $this->mCascadeRestriction || $row->pr_cascade;
                }
            }
        }
 
        $this->mRestrictionsLoaded = true;
    }
 
    public function loadRestrictions( $oldFashionedRestrictions = null, $flags = 0 ) {
        $readLatest = DBAccessObjectUtils::hasFlags( $flags, self::READ_LATEST );
        if ( $this->mRestrictionsLoaded && !$readLatest ) {
            return;
        }
 
        $id = $this->getArticleID( $flags );
        if ( $id ) {
            $fname = __METHOD__;
            $loadRestrictionsFromDb = static function ( IDatabase $dbr ) use ( $fname, $id ) {
                return iterator_to_array(
                    $dbr->select(
                        'page_restrictions',
                        [ 'pr_type', 'pr_expiry', 'pr_level', 'pr_cascade' ],
                        [ 'pr_page' => $id ],
                        $fname
                    )
                );
            };
 
            if ( $readLatest ) {
                $dbr = wfGetDB( DB_MASTER );
                $rows = $loadRestrictionsFromDb( $dbr );
            } else {
                $cache = MediaWikiServices::getInstance()->getMainWANObjectCache();
                $rows = $cache->getWithSetCallback(
                    // Page protections always leave a new null revision
                    $cache->makeKey( 'page-restrictions', 'v1', $id, $this->getLatestRevID() ),
                    $cache::TTL_DAY,
                    static function ( $curValue, &$ttl, array &$setOpts ) use ( $loadRestrictionsFromDb ) {
                        $dbr = wfGetDB( DB_REPLICA );
 
                        $setOpts += Database::getCacheSetOptions( $dbr );
                        $lb = MediaWikiServices::getInstance()->getDBLoadBalancer();
                        if ( $lb->hasOrMadeRecentMasterChanges() ) {
                            // @TODO: cleanup Title cache and caller assumption mess in general
                            $ttl = WANObjectCache::TTL_UNCACHEABLE;
                        }
 
                        return $loadRestrictionsFromDb( $dbr );
                    }
                );
            }
 
            $this->loadRestrictionsFromRows( $rows, $oldFashionedRestrictions );
        } else {
            $title_protection = $this->getTitleProtectionInternal();
 
            if ( $title_protection ) {
                $now = wfTimestampNow();
                $expiry = wfGetDB( DB_REPLICA )->decodeExpiry( $title_protection['expiry'] );
 
                if ( !$expiry || $expiry > $now ) {
                    // Apply the restrictions
                    $this->mRestrictionsExpiry['create'] = $expiry;
                    $this->mRestrictions['create'] =
                        explode( ',', trim( $title_protection['permission'] ) );
                } else { // Get rid of the old restrictions
                    $this->mTitleProtection = false;
                }
            } else {
                $this->mRestrictionsExpiry['create'] = 'infinity';
            }
            $this->mRestrictionsLoaded = true;
        }
    }
 
    public function flushRestrictions() {
        $this->mRestrictionsLoaded = false;
        $this->mTitleProtection = null;
    }
 
    public static function purgeExpiredRestrictions() {
        if ( wfReadOnly() ) {
            return;
        }
 
        DeferredUpdates::addUpdate( new AtomicSectionUpdate(
            wfGetDB( DB_MASTER ),
            __METHOD__,
            static function ( IDatabase $dbw, $fname ) {
                $config = MediaWikiServices::getInstance()->getMainConfig();
                $ids = $dbw->selectFieldValues(
                    'page_restrictions',
                    'pr_id',
                    [ 'pr_expiry < ' . $dbw->addQuotes( $dbw->timestamp() ) ],
                    $fname,
                    [ 'LIMIT' => $config->get( 'UpdateRowsPerQuery' ) ] // T135470
                );
                if ( $ids ) {
                    $dbw->delete( 'page_restrictions', [ 'pr_id' => $ids ], $fname );
                }
            }
        ) );
 
        DeferredUpdates::addUpdate( new AtomicSectionUpdate(
            wfGetDB( DB_MASTER ),
            __METHOD__,
            static function ( IDatabase $dbw, $fname ) {
                $dbw->delete(
                    'protected_titles',
                    [ 'pt_expiry < ' . $dbw->addQuotes( $dbw->timestamp() ) ],
                    $fname
                );
            }
        ) );
    }
 
    public function hasSubpages() {
        if (
            !MediaWikiServices::getInstance()->getNamespaceInfo()->
                hasSubpages( $this->mNamespace )
        ) {
            # Duh
            return false;
        }
 
        # We dynamically add a member variable for the purpose of this method
        # alone to cache the result.  There's no point in having it hanging
        # around uninitialized in every Title object; therefore we only add it
        # if needed and don't declare it statically.
        if ( $this->mHasSubpages === null ) {
            $this->mHasSubpages = false;
            $subpages = $this->getSubpages( 1 );
            if ( $subpages instanceof TitleArray ) {
                $this->mHasSubpages = (bool)$subpages->current();
            }
        }
 
        return $this->mHasSubpages;
    }
 
    public function getSubpages( $limit = -1 ) {
        if (
            !MediaWikiServices::getInstance()->getNamespaceInfo()->
                hasSubpages( $this->mNamespace )
        ) {
            return [];
        }
 
        $dbr = wfGetDB( DB_REPLICA );
        $conds = [ 'page_namespace' => $this->mNamespace ];
        $conds[] = 'page_title ' . $dbr->buildLike( $this->mDbkeyform . '/', $dbr->anyString() );
        $options = [];
        if ( $limit > -1 ) {
            $options['LIMIT'] = $limit;
        }
        return TitleArray::newFromResult(
            $dbr->select( 'page',
                [ 'page_id', 'page_namespace', 'page_title', 'page_is_redirect' ],
                $conds,
                __METHOD__,
                $options
            )
        );
    }
 
    public function isDeleted() {
        return $this->getDeletedEditsCount();
    }
 
    public function getDeletedEditsCount() {
        if ( $this->mNamespace < 0 ) {
            $n = 0;
        } else {
            $dbr = wfGetDB( DB_REPLICA );
 
            $n = $dbr->selectField( 'archive', 'COUNT(*)',
                [ 'ar_namespace' => $this->mNamespace, 'ar_title' => $this->mDbkeyform ],
                __METHOD__
            );
            if ( $this->mNamespace === NS_FILE ) {
                $n += $dbr->selectField( 'filearchive', 'COUNT(*)',
                    [ 'fa_name' => $this->mDbkeyform ],
                    __METHOD__
                );
            }
        }
        return (int)$n;
    }
 
    public function isDeletedQuick() {
        return $this->hasDeletedEdits();
    }
 
    public function hasDeletedEdits() {
        if ( $this->mNamespace < 0 ) {
            return false;
        }
        $dbr = wfGetDB( DB_REPLICA );
        $deleted = (bool)$dbr->selectField( 'archive', '1',
            [ 'ar_namespace' => $this->mNamespace, 'ar_title' => $this->mDbkeyform ],
            __METHOD__
        );
        if ( !$deleted && $this->mNamespace === NS_FILE ) {
            $deleted = (bool)$dbr->selectField( 'filearchive', '1',
                [ 'fa_name' => $this->mDbkeyform ],
                __METHOD__
            );
        }
        return $deleted;
    }
 
    public function getArticleID( $flags = 0 ) {
        if ( $this->mNamespace < 0 ) {
            $this->mArticleID = 0;
 
            return $this->mArticleID;
        }
 
        if ( $flags & self::GAID_FOR_UPDATE ) {
            $linkCache = MediaWikiServices::getInstance()->getLinkCache();
            $oldUpdate = $linkCache->forUpdate( true );
            $linkCache->clearLink( $this );
            $this->mArticleID = $linkCache->addLinkObj( $this );
            $linkCache->forUpdate( $oldUpdate );
        } elseif ( DBAccessObjectUtils::hasFlags( $flags, self::READ_LATEST ) ) {
            // If mArticleID is >0, pageCond() will use it, making it impossible
            // for the call below to return a different result, e.g. after a
            // page move.
            $this->mArticleID = -1;
            $this->mArticleID = (int)$this->loadFieldFromDB( 'page_id', $flags );
        } elseif ( $this->mArticleID == -1 ) {
            $linkCache = MediaWikiServices::getInstance()->getLinkCache();
            $this->mArticleID = $linkCache->addLinkObj( $this );
        }
 
        return $this->mArticleID;
    }
 
    public function isRedirect( $flags = 0 ) {
        if ( DBAccessObjectUtils::hasFlags( $flags, self::READ_LATEST ) ) {
            $this->mRedirect = (bool)$this->loadFieldFromDB( 'page_is_redirect', $flags );
        } elseif ( $this->mRedirect === null ) {
            if ( $this->getArticleID( $flags ) ) {
                $linkCache = MediaWikiServices::getInstance()->getLinkCache();
                $linkCache->addLinkObj( $this ); // in case we already had an article ID
                // Note that LinkCache returns null if it thinks the page does not exist;
                // always trust the state of LinkCache over that of this Title instance.
                $this->mRedirect = (bool)$linkCache->getGoodLinkFieldObj( $this, 'redirect' );
            } else {
                $this->mRedirect = false;
            }
        }
 
        return $this->mRedirect;
    }
 
    public function getLength( $flags = 0 ) {
        if ( DBAccessObjectUtils::hasFlags( $flags, self::READ_LATEST ) ) {
            $this->mLength = (int)$this->loadFieldFromDB( 'page_len', $flags );
        } else {
            if ( $this->mLength != -1 ) {
                return $this->mLength;
            } elseif ( !$this->getArticleID( $flags ) ) {
                $this->mLength = 0;
                return $this->mLength;
            }
 
            $linkCache = MediaWikiServices::getInstance()->getLinkCache();
            $linkCache->addLinkObj( $this ); // in case we already had an article ID
            // Note that LinkCache returns null if it thinks the page does not exist;
            // always trust the state of LinkCache over that of this Title instance.
            $this->mLength = (int)$linkCache->getGoodLinkFieldObj( $this, 'length' );
        }
 
        return $this->mLength;
    }
 
    public function getLatestRevID( $flags = 0 ) {
        if ( DBAccessObjectUtils::hasFlags( $flags, self::READ_LATEST ) ) {
            $this->mLatestID = (int)$this->loadFieldFromDB( 'page_latest', $flags );
        } else {
            if ( $this->mLatestID !== false ) {
                return (int)$this->mLatestID;
            } elseif ( !$this->getArticleID( $flags ) ) {
                $this->mLatestID = 0;
 
                return $this->mLatestID;
            }
 
            $linkCache = MediaWikiServices::getInstance()->getLinkCache();
            $linkCache->addLinkObj( $this ); // in case we already had an article ID
            // Note that LinkCache returns null if it thinks the page does not exist;
            // always trust the state of LinkCache over that of this Title instance.
            $this->mLatestID = (int)$linkCache->getGoodLinkFieldObj( $this, 'revision' );
        }
 
        return $this->mLatestID;
    }
 
    public function resetArticleID( $id ) {
        if ( $id === false ) {
            $this->mArticleID = -1;
        } else {
            $this->mArticleID = (int)$id;
        }
        $this->mRestrictionsLoaded = false;
        $this->mRestrictions = [];
        $this->mOldRestrictions = false;
        $this->mRedirect = null;
        $this->mLength = -1;
        $this->mLatestID = false;
        $this->mContentModel = false;
        $this->mForcedContentModel = false;
        $this->mEstimateRevisions = null;
        $this->mPageLanguage = null;
        $this->mDbPageLanguage = false;
        $this->mIsBigDeletion = null;
 
        MediaWikiServices::getInstance()->getLinkCache()->clearLink( $this );
    }
 
    public static function clearCaches() {
        $linkCache = MediaWikiServices::getInstance()->getLinkCache();
        $linkCache->clear();
 
        $titleCache = self::getTitleCache();
        $titleCache->clear();
    }
 
    public static function capitalize( $text, $ns = NS_MAIN ) {
        $services = MediaWikiServices::getInstance();
        if ( $services->getNamespaceInfo()->isCapitalized( $ns ) ) {
            return $services->getContentLanguage()->ucfirst( $text );
        } else {
            return $text;
        }
    }
 
    private function secureAndSplit( $text, $defaultNamespace = null ) {
        if ( $defaultNamespace === null ) {
            $defaultNamespace = $this->mDefaultNamespace;
        }
 
        // @note: splitTitleString() is a temporary hack to allow MediaWikiTitleCodec to share
        //        the parsing code with Title, while avoiding massive refactoring.
        // @todo: get rid of secureAndSplit, refactor parsing code.
        // @note: getTitleParser() returns a TitleParser implementation which does not have a
        //        splitTitleString method, but the only implementation (MediaWikiTitleCodec) does
        $titleCodec = MediaWikiServices::getInstance()->getTitleParser();
        '@phan-var MediaWikiTitleCodec $titleCodec';
        // MalformedTitleException can be thrown here
        $parts = $titleCodec->splitTitleString( $text, $defaultNamespace );
 
        # Fill fields
        $this->setFragment( '#' . $parts['fragment'] );
        $this->mInterwiki = $parts['interwiki'];
        $this->mLocalInterwiki = $parts['local_interwiki'];
        $this->mNamespace = $parts['namespace'];
        $this->mDefaultNamespace = $defaultNamespace;
 
        $this->mDbkeyform = $parts['dbkey'];
        $this->mUrlform = wfUrlencode( $this->mDbkeyform );
        $this->mTextform = strtr( $this->mDbkeyform, '_', ' ' );
 
        // splitTitleString() guarantees that this title is valid.
        $this->mIsValid = true;
 
        # We already know that some pages won't be in the database!
        if ( $this->isExternal() || $this->isSpecialPage() || $this->mTextform === '' ) {
            $this->mArticleID = 0;
        }
    }
 
    public function getLinksTo( $options = [], $table = 'pagelinks', $prefix = 'pl' ) {
        if ( count( $options ) > 0 ) {
            $db = wfGetDB( DB_MASTER );
        } else {
            $db = wfGetDB( DB_REPLICA );
        }
 
        $res = $db->select(
            [ 'page', $table ],
            self::getSelectFields(),
            [
                "{$prefix}_from=page_id",
                "{$prefix}_namespace" => $this->mNamespace,
                "{$prefix}_title" => $this->mDbkeyform ],
            __METHOD__,
            $options
        );
 
        $retVal = [];
        if ( $res->numRows() ) {
            $linkCache = MediaWikiServices::getInstance()->getLinkCache();
            foreach ( $res as $row ) {
                $titleObj = self::makeTitle( $row->page_namespace, $row->page_title );
                if ( $titleObj ) {
                    $linkCache->addGoodLinkObjFromRow( $titleObj, $row );
                    $retVal[] = $titleObj;
                }
            }
        }
        return $retVal;
    }
 
    public function getTemplateLinksTo( $options = [] ) {
        return $this->getLinksTo( $options, 'templatelinks', 'tl' );
    }
 
    public function getLinksFrom( $options = [], $table = 'pagelinks', $prefix = 'pl' ) {
        $id = $this->getArticleID();
 
        # If the page doesn't exist; there can't be any link from this page
        if ( !$id ) {
            return [];
        }
 
        $db = wfGetDB( DB_REPLICA );
 
        $blNamespace = "{$prefix}_namespace";
        $blTitle = "{$prefix}_title";
 
        $pageQuery = WikiPage::getQueryInfo();
        $res = $db->select(
            [ $table, 'nestpage' => $pageQuery['tables'] ],
            array_merge(
                [ $blNamespace, $blTitle ],
                $pageQuery['fields']
            ),
            [ "{$prefix}_from" => $id ],
            __METHOD__,
            $options,
            [ 'nestpage' => [
                'LEFT JOIN',
                [ "page_namespace=$blNamespace", "page_title=$blTitle" ]
            ] ] + $pageQuery['joins']
        );
 
        $retVal = [];
        $linkCache = MediaWikiServices::getInstance()->getLinkCache();
        foreach ( $res as $row ) {
            if ( $row->page_id ) {
                $titleObj = self::newFromRow( $row );
            } else {
                $titleObj = self::makeTitle( $row->$blNamespace, $row->$blTitle );
                $linkCache->addBadLinkObj( $titleObj );
            }
            $retVal[] = $titleObj;
        }
 
        return $retVal;
    }
 
    public function getTemplateLinksFrom( $options = [] ) {
        return $this->getLinksFrom( $options, 'templatelinks', 'tl' );
    }
 
    public function getBrokenLinksFrom() {
        if ( $this->getArticleID() == 0 ) {
            # All links from article ID 0 are false positives
            return [];
        }
 
        $dbr = wfGetDB( DB_REPLICA );
        $res = $dbr->select(
            [ 'page', 'pagelinks' ],
            [ 'pl_namespace', 'pl_title' ],
            [
                'pl_from' => $this->getArticleID(),
                'page_namespace IS NULL'
            ],
            __METHOD__, [],
            [
                'page' => [
                    'LEFT JOIN',
                    [ 'pl_namespace=page_namespace', 'pl_title=page_title' ]
                ]
            ]
        );
 
        $retVal = [];
        foreach ( $res as $row ) {
            $retVal[] = self::makeTitle( $row->pl_namespace, $row->pl_title );
        }
        return $retVal;
    }
 
    public function getCdnUrls() {
        $htmlCache = MediaWikiServices::getInstance()->getHtmlCacheUpdater();
        return $htmlCache->getUrls( $this );
    }
 
    public function purgeSquid() {
        $htmlCache = MediaWikiServices::getInstance()->getHtmlCacheUpdater();
        $htmlCache->purgeTitleUrls( $this, $htmlCache::PURGE_INTENT_TXROUND_REFLECTED );
    }
 
    public function isSingleRevRedirect() {
        $dbw = wfGetDB( DB_MASTER );
        $dbw->startAtomic( __METHOD__ );
 
        $row = $dbw->selectRow(
            'page',
            self::getSelectFields(),
            $this->pageCond(),
            __METHOD__,
            [ 'FOR UPDATE' ]
        );
        // Update the cached fields
        $this->loadFromRow( $row );
 
        if ( $this->mRedirect && $this->mLatestID ) {
            $isSingleRevRedirect = !$dbw->selectField(
                'revision',
                '1',
                [ 'rev_page' => $this->mArticleID,  'rev_id != ' . (int)$this->mLatestID ],
                __METHOD__,
                [ 'FOR UPDATE' ]
            );
        } else {
            $isSingleRevRedirect = false;
        }
 
        $dbw->endAtomic( __METHOD__ );
 
        return $isSingleRevRedirect;
    }
 
    public function getParentCategories() {
        $data = [];
 
        $titleKey = $this->getArticleID();
 
        if ( $titleKey === 0 ) {
            return $data;
        }
 
        $dbr = wfGetDB( DB_REPLICA );
 
        $res = $dbr->select(
            'categorylinks',
            'cl_to',
            [ 'cl_from' => $titleKey ],
            __METHOD__
        );
 
        if ( $res->numRows() > 0 ) {
            $contLang = MediaWikiServices::getInstance()->getContentLanguage();
            foreach ( $res as $row ) {
                // $data[] = Title::newFromText( $contLang->getNsText ( NS_CATEGORY ).':'.$row->cl_to);
                $data[$contLang->getNsText( NS_CATEGORY ) . ':' . $row->cl_to] =
                    $this->getFullText();
            }
        }
        return $data;
    }
 
    public function getParentCategoryTree( $children = [] ) {
        $stack = [];
        $parents = $this->getParentCategories();
 
        if ( $parents ) {
            foreach ( $parents as $parent => $current ) {
                if ( array_key_exists( $parent, $children ) ) {
                    # Circular reference
                    $stack[$parent] = [];
                } else {
                    $nt = self::newFromText( $parent );
                    if ( $nt ) {
                        $stack[$parent] = $nt->getParentCategoryTree( $children + [ $parent => 1 ] );
                    }
                }
            }
        }
 
        return $stack;
    }
 
    public function pageCond() {
        if ( $this->mArticleID > 0 ) {
            // PK avoids secondary lookups in InnoDB, shouldn't hurt other DBs
            return [ 'page_id' => $this->mArticleID ];
        } else {
            return [ 'page_namespace' => $this->mNamespace, 'page_title' => $this->mDbkeyform ];
        }
    }
 
    private function getRelativeRevisionID( $revId, $flags, $dir ) {
        $rl = MediaWikiServices::getInstance()->getRevisionLookup();
        $rev = $rl->getRevisionById( $revId, $flags );
        if ( !$rev ) {
            return false;
        }
 
        $oldRev = ( $dir === 'next' )
            ? $rl->getNextRevision( $rev, $flags )
            : $rl->getPreviousRevision( $rev, $flags );
 
        return $oldRev ? $oldRev->getId() : false;
    }
 
    public function getPreviousRevisionID( $revId, $flags = 0 ) {
        wfDeprecated( __METHOD__, '1.34' );
        return $this->getRelativeRevisionID( $revId, $flags, 'prev' );
    }
 
    public function getNextRevisionID( $revId, $flags = 0 ) {
        wfDeprecated( __METHOD__, '1.34' );
        return $this->getRelativeRevisionID( $revId, $flags, 'next' );
    }
 
    public function getFirstRevision( $flags = 0 ) {
        wfDeprecated( __METHOD__, '1.35' );
        $flags |= ( $flags & self::GAID_FOR_UPDATE ) ? self::READ_LATEST : 0; // b/c
        $rev = MediaWikiServices::getInstance()
            ->getRevisionLookup()
            ->getFirstRevision( $this, $flags );
        return $rev ? new Revision( $rev ) : null;
    }
 
    public function getEarliestRevTime( $flags = 0 ) {
        wfDeprecated( __METHOD__, '1.35' );
        $rev = MediaWikiServices::getInstance()
            ->getRevisionLookup()
            ->getFirstRevision( $this, $flags );
        return $rev ? $rev->getTimestamp() : null;
    }
 
    public function isNewPage() {
        $dbr = wfGetDB( DB_REPLICA );
        return (bool)$dbr->selectField( 'page', 'page_is_new', $this->pageCond(), __METHOD__ );
    }
 
    public function isBigDeletion() {
        global $wgDeleteRevisionsLimit;
 
        if ( !$wgDeleteRevisionsLimit ) {
            return false;
        }
 
        if ( $this->mIsBigDeletion === null ) {
            $dbr = wfGetDB( DB_REPLICA );
 
            $revCount = $dbr->selectRowCount(
                'revision',
                '1',
                [ 'rev_page' => $this->getArticleID() ],
                __METHOD__,
                [ 'LIMIT' => $wgDeleteRevisionsLimit + 1 ]
            );
 
            $this->mIsBigDeletion = $revCount > $wgDeleteRevisionsLimit;
        }
 
        return $this->mIsBigDeletion;
    }
 
    public function estimateRevisionCount() {
        if ( !$this->exists() ) {
            return 0;
        }
 
        if ( $this->mEstimateRevisions === null ) {
            $dbr = wfGetDB( DB_REPLICA );
            $this->mEstimateRevisions = $dbr->estimateRowCount( 'revision', '*',
                [ 'rev_page' => $this->getArticleID() ], __METHOD__ );
        }
 
        return $this->mEstimateRevisions;
    }
 
    public function countAuthorsBetween( $old, $new, $limit, $options = [] ) {
        wfDeprecated( __METHOD__, '1.35' );
        $revisionStore = MediaWikiServices::getInstance()->getRevisionStore();
 
        if ( !( $old instanceof Revision ) ) {
            $old = Revision::newFromTitle( $this, (int)$old );
        }
        if ( !( $new instanceof Revision ) ) {
            $new = Revision::newFromTitle( $this, (int)$new );
        }
        if ( !$old || !$new ) {
            return 0; // nothing to compare
        }
 
        return $revisionStore->countAuthorsBetween(
            $this->getArticleID(),
            $old->getRevisionRecord(),
            $new->getRevisionRecord(),
            null,
            $limit,
            $options
        );
    }
 
    public function equals( object $other ) {
        if ( $other instanceof Title ) {
            // NOTE: In contrast to isSameLinkAs(), this ignores the fragment part!
            // NOTE: In contrast to isSamePageAs(), this ignores the page ID!
            // NOTE: === is necessary for proper matching of number-like titles
            return $this->getInterwiki() === $other->getInterwiki()
                && $this->getNamespace() === $other->getNamespace()
                && $this->getDBkey() === $other->getDBkey();
        } else {
            return false;
        }
    }
 
    public function isSameLinkAs( LinkTarget $other ) {
        // NOTE: keep in sync with TitleValue::isSameLinkAs()!
        // NOTE: === is needed for number-like titles
        return ( $other->getInterwiki() === $this->getInterwiki() )
            && ( $other->getDBkey() === $this->getDBkey() )
            && ( $other->getNamespace() === $this->getNamespace() )
            && ( $other->getFragment() === $this->getFragment() );
    }
 
    public function isSamePageAs( PageIdentity $other ) {
        // NOTE: keep in sync with PageIdentityValue::isSamePageAs()!
 
        if ( $other->getWikiId() !== $this->getWikiId()
            || $other->getId() !== $this->getId() ) {
            return false;
        }
 
        if ( $this->getId() === 0 ) {
            if ( $other->getNamespace() !== $this->getNamespace()
                || $other->getDBkey() !== $this->getDBkey() ) {
                return false;
            }
        }
 
        return true;
    }
 
    public function isSubpageOf( Title $title ) {
        return $this->mInterwiki === $title->mInterwiki
            && $this->mNamespace == $title->mNamespace
            && strpos( $this->mDbkeyform, $title->mDbkeyform . '/' ) === 0;
    }
 
    public function exists( $flags = 0 ): bool {
        $exists = $this->getArticleID( $flags ) != 0;
        Hooks::runner()->onTitleExists( $this, $exists );
        return $exists;
    }
 
    public function isAlwaysKnown() {
        $isKnown = null;
 
        Hooks::runner()->onTitleIsAlwaysKnown( $this, $isKnown );
 
        if ( $isKnown !== null ) {
            return $isKnown;
        }
 
        if ( $this->isExternal() ) {
            return true; // any interwiki link might be viewable, for all we know
        }
 
        $services = MediaWikiServices::getInstance();
        switch ( $this->mNamespace ) {
            case NS_MEDIA:
            case NS_FILE:
                // file exists, possibly in a foreign repo
                return (bool)$services->getRepoGroup()->findFile( $this );
            case NS_SPECIAL:
                // valid special page
                return $services->getSpecialPageFactory()->exists( $this->mDbkeyform );
            case NS_MAIN:
                // selflink, possibly with fragment
                return $this->mDbkeyform == '';
            case NS_MEDIAWIKI:
                // known system message
                return $this->hasSourceText() !== false;
            default:
                return false;
        }
    }
 
    public function isKnown() {
        return $this->isAlwaysKnown() || $this->exists();
    }
 
    public function hasSourceText() {
        if ( $this->exists() ) {
            return true;
        }
 
        if ( $this->mNamespace === NS_MEDIAWIKI ) {
            $services = MediaWikiServices::getInstance();
            // If the page doesn't exist but is a known system message, default
            // message content will be displayed, same for language subpages-
            // Use always content language to avoid loading hundreds of languages
            // to get the link color.
            $contLang = $services->getContentLanguage();
            list( $name, ) = $services->getMessageCache()->figureMessage(
                $contLang->lcfirst( $this->getText() )
            );
            $message = wfMessage( $name )->inLanguage( $contLang )->useDatabase( false );
            return $message->exists();
        }
 
        return false;
    }
 
    public function getDefaultMessageText() {
        if ( $this->mNamespace !== NS_MEDIAWIKI ) { // Just in case
            return false;
        }
 
        list( $name, $lang ) = MediaWikiServices::getInstance()->getMessageCache()->figureMessage(
            MediaWikiServices::getInstance()->getContentLanguage()->lcfirst( $this->getText() )
        );
        $message = wfMessage( $name )->inLanguage( $lang )->useDatabase( false );
 
        if ( $message->exists() ) {
            return $message->plain();
        } else {
            return false;
        }
    }
 
    public function invalidateCache( $purgeTime = null ) {
        if ( wfReadOnly() ) {
            return false;
        }
        if ( $this->mArticleID === 0 ) {
            // avoid gap locking if we know it's not there
            return true;
        }
 
        $conds = $this->pageCond();
        DeferredUpdates::addUpdate(
            new AutoCommitUpdate(
                wfGetDB( DB_MASTER ),
                __METHOD__,
                function ( IDatabase $dbw, $fname ) use ( $conds, $purgeTime ) {
                    $dbTimestamp = $dbw->timestamp( $purgeTime ?: time() );
                    $dbw->update(
                        'page',
                        [ 'page_touched' => $dbTimestamp ],
                        $conds + [ 'page_touched < ' . $dbw->addQuotes( $dbTimestamp ) ],
                        $fname
                    );
 
                    MediaWikiServices::getInstance()->getLinkCache()->invalidateTitle( $this );
 
                    ResourceLoaderWikiModule::invalidateModuleCache(
                        $this, null, null, $dbw->getDomainID() );
                }
            ),
            DeferredUpdates::PRESEND
        );
 
        return true;
    }
 
    public function touchLinks() {
        $jobs = [];
        $jobs[] = HTMLCacheUpdateJob::newForBacklinks(
            $this,
            'pagelinks',
            [ 'causeAction' => 'page-touch' ]
        );
        if ( $this->mNamespace === NS_CATEGORY ) {
            $jobs[] = HTMLCacheUpdateJob::newForBacklinks(
                $this,
                'categorylinks',
                [ 'causeAction' => 'category-touch' ]
            );
        }
 
        JobQueueGroup::singleton()->lazyPush( $jobs );
    }
 
    public function getTouched( $db = null ) {
        if ( $db === null ) {
            $db = wfGetDB( DB_REPLICA );
        }
        $touched = $db->selectField( 'page', 'page_touched', $this->pageCond(), __METHOD__ );
        return $touched;
    }
 
    public function getNotificationTimestamp( User $user ) {
        return MediaWikiServices::getInstance()
            ->getWatchlistNotificationManager()
            ->getTitleNotificationTimestamp( $user, $this );
    }
 
    public function getNamespaceKey( $prepend = 'nstab-' ) {
        // Gets the subject namespace of this title
        $nsInfo = MediaWikiServices::getInstance()->getNamespaceInfo();
        $subjectNS = $nsInfo->getSubject( $this->mNamespace );
        // Prefer canonical namespace name for HTML IDs
        $namespaceKey = $nsInfo->getCanonicalName( $subjectNS );
        if ( $namespaceKey === false ) {
            // Fallback to localised text
            $namespaceKey = $this->getSubjectNsText();
        }
        // Makes namespace key lowercase
        $namespaceKey = MediaWikiServices::getInstance()->getContentLanguage()->lc( $namespaceKey );
        // Uses main
        if ( $namespaceKey == '' ) {
            $namespaceKey = 'main';
        }
        // Changes file to image for backwards compatibility
        if ( $namespaceKey == 'file' ) {
            $namespaceKey = 'image';
        }
        return $prepend . $namespaceKey;
    }
 
    public function getRedirectsHere( $ns = null ) {
        $redirs = [];
 
        $dbr = wfGetDB( DB_REPLICA );
        $where = [
            'rd_namespace' => $this->mNamespace,
            'rd_title' => $this->mDbkeyform,
            'rd_from = page_id'
        ];
        if ( $this->isExternal() ) {
            $where['rd_interwiki'] = $this->mInterwiki;
        } else {
            $where[] = 'rd_interwiki = ' . $dbr->addQuotes( '' ) . ' OR rd_interwiki IS NULL';
        }
        if ( $ns !== null ) {
            $where['page_namespace'] = $ns;
        }
 
        $res = $dbr->select(
            [ 'redirect', 'page' ],
            [ 'page_namespace', 'page_title' ],
            $where,
            __METHOD__
        );
 
        foreach ( $res as $row ) {
            $redirs[] = self::newFromRow( $row );
        }
        return $redirs;
    }
 
    public function isValidRedirectTarget() {
        global $wgInvalidRedirectTargets;
 
        if ( $this->isSpecialPage() ) {
            // invalid redirect targets are stored in a global array, but explicitly disallow Userlogout here
            if ( $this->isSpecial( 'Userlogout' ) ) {
                return false;
            }
 
            foreach ( $wgInvalidRedirectTargets as $target ) {
                if ( $this->isSpecial( $target ) ) {
                    return false;
                }
            }
        }
 
        return true;
    }
 
    public function getBacklinkCache() {
        return BacklinkCache::get( $this );
    }
 
    public function canUseNoindex() {
        global $wgExemptFromUserRobotsControl;
 
        $bannedNamespaces = $wgExemptFromUserRobotsControl ??
            MediaWikiServices::getInstance()->getNamespaceInfo()->getContentNamespaces();
 
        return !in_array( $this->mNamespace, $bannedNamespaces );
    }
 
    public function getCategorySortkey( $prefix = '' ) {
        $unprefixed = $this->getText();
 
        // Anything that uses this hook should only depend
        // on the Title object passed in, and should probably
        // tell the users to run updateCollations.php --force
        // in order to re-sort existing category relations.
        Hooks::runner()->onGetDefaultSortkey( $this, $unprefixed );
        if ( $prefix !== '' ) {
            # Separate with a line feed, so the unprefixed part is only used as
            # a tiebreaker when two pages have the exact same prefix.
            # In UCA, tab is the only character that can sort above LF
            # so we strip both of them from the original prefix.
            $prefix = strtr( $prefix, "\n\t", '  ' );
            return "$prefix\n$unprefixed";
        }
        return $unprefixed;
    }
 
    private function getDbPageLanguageCode() {
        global $wgPageLanguageUseDB;
 
        // check, if the page language could be saved in the database, and if so and
        // the value is not requested already, lookup the page language using LinkCache
        if ( $wgPageLanguageUseDB && $this->mDbPageLanguage === false ) {
            $linkCache = MediaWikiServices::getInstance()->getLinkCache();
            $linkCache->addLinkObj( $this );
            $this->mDbPageLanguage = $linkCache->getGoodLinkFieldObj( $this, 'lang' );
        }
 
        return $this->mDbPageLanguage;
    }
 
    public function getPageLanguage() {
        global $wgLang, $wgLanguageCode;
        if ( $this->isSpecialPage() ) {
            // special pages are in the user language
            return $wgLang;
        }
 
        // Checking if DB language is set
        $dbPageLanguage = $this->getDbPageLanguageCode();
        if ( $dbPageLanguage ) {
            return wfGetLangObj( $dbPageLanguage );
        }
 
        if ( !$this->mPageLanguage || $this->mPageLanguage[1] !== $wgLanguageCode ) {
            // Note that this may depend on user settings, so the cache should
            // be only per-request.
            // NOTE: ContentHandler::getPageLanguage() may need to load the
            // content to determine the page language!
            // Checking $wgLanguageCode hasn't changed for the benefit of unit
            // tests.
            $contentHandler = MediaWikiServices::getInstance()
                ->getContentHandlerFactory()
                ->getContentHandler( $this->getContentModel() );
            $langObj = $contentHandler->getPageLanguage( $this );
            $this->mPageLanguage = [ $langObj->getCode(), $wgLanguageCode ];
        } else {
            $langObj = MediaWikiServices::getInstance()->getLanguageFactory()
                ->getLanguage( $this->mPageLanguage[0] );
        }
 
        return $langObj;
    }
 
    public function getPageViewLanguage() {
        global $wgLang;
 
        if ( $this->isSpecialPage() ) {
            // If the user chooses a variant, the content is actually
            // in a language whose code is the variant code.
            $variant = $this->getLanguageConverter( $wgLang )->getPreferredVariant();
            if ( $wgLang->getCode() !== $variant ) {
                return MediaWikiServices::getInstance()->getLanguageFactory()
                    ->getLanguage( $variant );
            }
 
            return $wgLang;
        }
 
        // Checking if DB language is set
        $dbPageLanguage = $this->getDbPageLanguageCode();
        if ( $dbPageLanguage ) {
            $pageLang = wfGetLangObj( $dbPageLanguage );
            $variant = $this->getLanguageConverter( $pageLang )->getPreferredVariant();
            if ( $pageLang->getCode() !== $variant ) {
                $pageLang = MediaWikiServices::getInstance()->getLanguageFactory()
                    ->getLanguage( $variant );
            }
 
            return $pageLang;
        }
 
        // @note Can't be cached persistently, depends on user settings.
        // @note ContentHandler::getPageViewLanguage() may need to load the
        //   content to determine the page language!
        $contentHandler = MediaWikiServices::getInstance()
            ->getContentHandlerFactory()
            ->getContentHandler( $this->getContentModel() );
        $pageLang = $contentHandler->getPageViewLanguage( $this );
        return $pageLang;
    }
 
    public function getEditNotices( $oldid = 0 ) {
        $notices = [];
 
        // Optional notice for the entire namespace
        $editnotice_ns = 'editnotice-' . $this->mNamespace;
        $msg = wfMessage( $editnotice_ns );
        if ( $msg->exists() ) {
            $html = $msg->parseAsBlock();
            // Edit notices may have complex logic, but output nothing (T91715)
            if ( trim( $html ) !== '' ) {
                $notices[$editnotice_ns] = Html::rawElement(
                    'div',
                    [ 'class' => [
                        'mw-editnotice',
                        'mw-editnotice-namespace',
                        Sanitizer::escapeClass( "mw-$editnotice_ns" )
                    ] ],
                    $html
                );
            }
        }
 
        if (
            MediaWikiServices::getInstance()->getNamespaceInfo()->
                hasSubpages( $this->mNamespace )
        ) {
            // Optional notice for page itself and any parent page
            $editnotice_base = $editnotice_ns;
            foreach ( explode( '/', $this->mDbkeyform ) as $part ) {
                $editnotice_base .= '-' . $part;
                $msg = wfMessage( $editnotice_base );
                if ( $msg->exists() ) {
                    $html = $msg->parseAsBlock();
                    if ( trim( $html ) !== '' ) {
                        $notices[$editnotice_base] = Html::rawElement(
                            'div',
                            [ 'class' => [
                                'mw-editnotice',
                                'mw-editnotice-base',
                                Sanitizer::escapeClass( "mw-$editnotice_base" )
                            ] ],
                            $html
                        );
                    }
                }
            }
        } else {
            // Even if there are no subpages in namespace, we still don't want "/" in MediaWiki message keys
            $editnoticeText = $editnotice_ns . '-' . strtr( $this->mDbkeyform, '/', '-' );
            $msg = wfMessage( $editnoticeText );
            if ( $msg->exists() ) {
                $html = $msg->parseAsBlock();
                if ( trim( $html ) !== '' ) {
                    $notices[$editnoticeText] = Html::rawElement(
                        'div',
                        [ 'class' => [
                            'mw-editnotice',
                            'mw-editnotice-page',
                            Sanitizer::escapeClass( "mw-$editnoticeText" )
                        ] ],
                        $html
                    );
                }
            }
        }
 
        Hooks::runner()->onTitleGetEditNotices( $this, $oldid, $notices );
        return $notices;
    }
 
    private function loadFieldFromDB( $field, $flags ) {
        if ( !in_array( $field, self::getSelectFields(), true ) ) {
            return false; // field does not exist
        }
 
        $flags |= ( $flags & self::GAID_FOR_UPDATE ) ? self::READ_LATEST : 0; // b/c
        list( $index, $options ) = DBAccessObjectUtils::getDBOptions( $flags );
 
        return wfGetDB( $index )->selectField(
            'page',
            $field,
            $this->pageCond(),
            __METHOD__,
            $options
        );
    }
 
    public function __sleep() {
        return [
            'mNamespace',
            'mDbkeyform',
            'mFragment',
            'mInterwiki',
            'mLocalInterwiki',
            'mDefaultNamespace',
        ];
    }
 
    public function __wakeup() {
        $this->mArticleID = ( $this->mNamespace >= 0 ) ? -1 : 0;
        $this->mUrlform = wfUrlencode( $this->mDbkeyform );
        $this->mTextform = strtr( $this->mDbkeyform, '_', ' ' );
    }
 
    public function getWikiId() {
        return self::LOCAL;
    }
 
    public function getId( $wikiId = self::LOCAL ): int {
        $this->assertWiki( $wikiId );
        $this->assertProperPage();
        return $this->getArticleID();
    }
 
    private function assertProperPage() {
        Assert::precondition(
            $this->canExist(),
            'This Title instance does not represent a proper page, but merely a link target.'
        );
 
        Assert::precondition(
            $this->getFragment() === '',
            'This Title instance represents a fragment link.'
        );
    }
 
    public function toPageIdentity() : ProperPageIdentity {
        // TODO: replace individual member fields with a PageIdentityValue that is always present
 
        $this->assertProperPage();
 
        return new PageIdentityValue(
            $this->getId(),
            $this->getNamespace(),
            $this->getDBkey(),
            self::LOCAL
        );
    }
 
}