ExternalUserNames.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;
use MediaWiki\User\UserNameUtils;
 
class ExternalUserNames {
 
    private $usernamePrefix;
 
    private $assignKnownUsers;
 
    private $triedCreations = [];
 
    public function __construct( $usernamePrefix, $assignKnownUsers ) {
        $this->usernamePrefix = rtrim( (string)$usernamePrefix, ':>' );
        $this->assignKnownUsers = (bool)$assignKnownUsers;
    }
 
    public static function getUserLinkTitle( $userName ) {
        $pos = strpos( $userName, '>' );
        $services = MediaWikiServices::getInstance();
        if ( $pos !== false ) {
            $iw = explode( ':', substr( $userName, 0, $pos ) );
            $firstIw = array_shift( $iw );
            $interwikiLookup = $services->getInterwikiLookup();
            if ( $interwikiLookup->isValidInterwiki( $firstIw ) ) {
                $title = $services->getNamespaceInfo()->getCanonicalName( NS_USER ) .
                    ':' . substr( $userName, $pos + 1 );
                if ( $iw ) {
                    $title = implode( ':', $iw ) . ':' . $title;
                }
                return Title::makeTitle( NS_MAIN, $title, '', $firstIw );
            }
            return null;
        } else {
            // Protect against invalid user names from old corrupt database rows, T232451
            if (
                $services->getUserNameUtils()->isIP( $userName )
                || $services->getUserNameUtils()->isValidIPRange( $userName )
                || $services->getUserNameUtils()->isValid( $userName )
            ) {
                return SpecialPage::getTitleFor( 'Contributions', $userName );
            } else {
                // Bad user name, no link
                return null;
            }
        }
    }
 
    public function applyPrefix( $name ) {
        $userNameUtils = MediaWikiServices::getInstance()->getUserNameUtils();
        if ( $userNameUtils->getCanonical( $name, UserNameUtils::RIGOR_USABLE ) === false ) {
            return $name;
        }
 
        if ( $this->assignKnownUsers ) {
            if ( User::idFromName( $name ) ) {
                return $name;
            }
 
            // See if any extension wants to create it.
            if ( !isset( $this->triedCreations[$name] ) ) {
                $this->triedCreations[$name] = true;
                if ( !Hooks::runner()->onImportHandleUnknownUser( $name ) &&
                    User::idFromName( $name, User::READ_LATEST )
                ) {
                    return $name;
                }
            }
        }
 
        return $this->addPrefix( $name );
    }
 
    public function addPrefix( $name ) {
        return substr( $this->usernamePrefix . '>' . $name, 0, 255 );
    }
 
    public static function isExternal( $username ) {
        return strpos( $username, '>' ) !== false;
    }
 
    public static function getLocal( $username ) {
        if ( !self::isExternal( $username ) ) {
            return $username;
        }
 
        return substr( $username, strpos( $username, '>' ) + 1 );
    }
 
}