wiki.techinc.nl/includes/block/Restriction/PageRestriction.php
James D. Forrester ad06527fb4 Reorg: Namespace the Title class
This is moderately messy.

Process was principally:

* xargs rg --files-with-matches '^use Title;' | grep 'php$' | \
  xargs -P 1 -n 1 sed -i -z 's/use Title;/use MediaWiki\\Title\\Title;/1'
* rg --files-without-match 'MediaWiki\\Title\\Title;' . | grep 'php$' | \
  xargs rg --files-with-matches 'Title\b' | \
  xargs -P 1 -n 1 sed -i -z 's/\nuse /\nuse MediaWiki\\Title\\Title;\nuse /1'
* composer fix

Then manual fix-ups for a few files that don't have any use statements.

Bug: T166010
Follows-Up: Ia5d8cb759dc3bc9e9bbe217d0fb109e2f8c4101a
Change-Id: If8fc9d0d95fc1a114021e282a706fc3e7da3524b
2023-03-02 08:46:53 -05:00

116 lines
2.6 KiB
PHP

<?php
/**
* A block restriction object of type 'Page'.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
*/
namespace MediaWiki\Block\Restriction;
use MediaWiki\Title\Title;
class PageRestriction extends AbstractRestriction {
/**
* @inheritDoc
*/
public const TYPE = 'page';
/**
* @inheritDoc
*/
public const TYPE_ID = 1;
/**
* @var Title|false|null
*/
protected $title;
/**
* @inheritDoc
*/
public function matches( Title $title ) {
if ( !$this->getTitle() ) {
return false;
}
return $title->equals( $this->getTitle() );
}
/**
* @since 1.33
* @param Title $title
* @return self
*/
public function setTitle( Title $title ) {
$this->title = $title;
return $this;
}
/**
* @since 1.33
* @return Title|false
*/
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;
}
/**
* @inheritDoc
*/
public static function newFromRow( \stdClass $row ) {
/** @var self $restriction */
$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;
}
/**
* @internal
* @since 1.36
* @param string|Title $title
* @return self
*/
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;
}
}