PageRestriction.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Block\Restriction;
 
use MediaWiki\Title\Title;
 
class PageRestriction extends AbstractRestriction {
 
    public const TYPE = 'page';
 
    public const TYPE_ID = 1;
 
    protected $title;
 
    public function matches( Title $title ) {
        if ( !$this->getTitle() ) {
            return false;
        }
 
        return $title->equals( $this->getTitle() );
    }
 
    public function setTitle( Title $title ) {
        $this->title = $title;
 
        return $this;
    }
 
    public function getTitle() {
        // If the title does not exist, set to false to prevent multiple database
        // queries.
        $this->title ??= Title::newFromID( $this->value ) ?? false;
 
        return $this->title;
    }
 
    public static function newFromRow( \stdClass $row ) {
        $restriction = parent::newFromRow( $row );
        '@phan-var self $restriction';
 
        // If the page_namespace and the page_title were provided, add the title to
        // the restriction.
        if ( isset( $row->page_namespace ) && isset( $row->page_title ) ) {
            // Clone the row so it is not mutated.
            $row = clone $row;
            $row->page_id = $row->ir_value;
            $title = Title::newFromRow( $row );
            $restriction->setTitle( $title );
        }
 
        return $restriction;
    }
 
    public static function newFromTitle( $title ) {
        if ( is_string( $title ) ) {
            $title = Title::newFromText( $title );
        }
 
        $restriction = new self( 0, $title->getArticleID() );
        // @phan-suppress-next-line PhanTypeMismatchArgumentNullable Title is always valid
        $restriction->setTitle( $title );
 
        return $restriction;
    }
}