WikiReference.php

Go to the documentation of this file.

<?php
namespace MediaWiki\WikiMap;
 
class WikiReference {
    // wgCanonicalServer, e.g. 'https://www.mediawiki.org'
    private $mCanonicalServer;
    // wgServer, may be protocol-relative, e.g. '//www.mediawiki.org'
    private $mServer;
    // wgArticlepath, e.g. '/wiki/$1'
    private $mPath;
 
    public function __construct( $canonicalServer, $path, $server = null ) {
        $this->mCanonicalServer = $canonicalServer;
        $this->mPath = $path;
        $this->mServer = $server ?? $canonicalServer;
    }
 
    public function getDisplayName() {
        $host = parse_url( $this->mCanonicalServer,  PHP_URL_HOST );
        if ( $host ) {
            return $host;
        } else {
            // Invalid server spec.
            // There's no sensible thing to do here, so just return the canonical server name in full.
            return $this->mCanonicalServer;
        }
    }
 
    private function getLocalUrl( $page, $fragmentId = null ) {
        $page = wfUrlencode( str_replace( ' ', '_', $page ) );
 
        if ( is_string( $fragmentId ) && $fragmentId !== '' ) {
            $page .= '#' . wfUrlencode( $fragmentId );
        }
 
        return str_replace( '$1', $page, $this->mPath );
    }
 
    public function getCanonicalUrl( $page, $fragmentId = null ) {
        return $this->mCanonicalServer . $this->getLocalUrl( $page, $fragmentId );
    }
 
    public function getCanonicalServer() {
        return $this->mCanonicalServer;
    }
 
    public function getUrl( $page, $fragmentId = null ) {
        return $this->getCanonicalUrl( $page, $fragmentId );
    }
 
    public function getFullUrl( $page, $fragmentId = null ) {
        return $this->mServer . $this->getLocalUrl( $page, $fragmentId );
    }
}
 
class_alias( WikiReference::class, 'WikiReference' );