PageIdentityValue.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Page;
 
use InvalidArgumentException;
use Wikimedia\Assert\Assert;
 
class PageIdentityValue extends PageReferenceValue implements ProperPageIdentity {
 
    private $pageId;
 
    public static function tryNew( int $pageId, int $namespace, string $dbKey, $wikiId ) {
        try {
            return new static( $pageId, $namespace, $dbKey, $wikiId );
        } catch ( InvalidArgumentException $ex ) {
            return null;
        }
    }
 
    public function __construct( int $pageId, int $namespace, string $dbKey, $wikiId ) {
        Assert::parameter( $pageId >= 0, '$pageId', 'must not be negative' );
        Assert::parameter( $namespace >= 0, '$namespace', 'must not be negative' );
 
        // Not full validation, intended to help detect lack of validation in the caller.
        Assert::parameter(
            !preg_match( '/[#|]/', $dbKey ),
            '$dbKey',
            'must not contain pipes or hashes: ' . $dbKey
        );
 
        parent::__construct( $namespace, $dbKey, $wikiId );
 
        $this->pageId = $pageId;
    }
 
    public static function localIdentity( int $pageId, int $namespace, string $dbKey ): self {
        return new self( $pageId, $namespace, $dbKey, self::LOCAL );
    }
 
    public function getId( $wikiId = self::LOCAL ): int {
        $this->assertWiki( $wikiId );
        return $this->pageId;
    }
 
    public function exists(): bool {
        return $this->getId( $this->getWikiId() ) > 0;
    }
 
    public function canExist(): bool {
        return true;
    }
 
}