UserNamePrefixSearch.php

Go to the documentation of this file.

<?php
namespace MediaWiki\User;
 
use InvalidArgumentException;
use MediaWiki\Permissions\Authority;
use Wikimedia\Rdbms\IConnectionProvider;
 
class UserNamePrefixSearch {
 
    public const AUDIENCE_PUBLIC = 'public';
 
    private $dbProvider;
 
    private $userNameUtils;
 
    public function __construct(
        IConnectionProvider $dbProvider,
        UserNameUtils $userNameUtils
    ) {
        $this->dbProvider = $dbProvider;
        $this->userNameUtils = $userNameUtils;
    }
 
    public function search( $audience, string $search, int $limit, int $offset = 0 ): array {
        if ( $audience !== self::AUDIENCE_PUBLIC &&
            !( $audience instanceof Authority )
        ) {
            throw new InvalidArgumentException(
                '$audience must be AUDIENCE_PUBLIC or an Authority object'
            );
        }
 
        // Invalid user names are treated as empty strings
        $prefix = $this->userNameUtils->getCanonical( $search ) ?: '';
 
        $dbr = $this->dbProvider->getReplicaDatabase();
        $queryBuilder = $dbr->newSelectQueryBuilder()
            ->select( 'user_name' )
            ->from( 'user' )
            ->where( [ 'user_name ' . $dbr->buildLike( $prefix, $dbr->anyString() ) ] )
            ->orderBy( 'user_name' )
            ->limit( $limit )
            ->offset( $offset );
 
        // Filter out hidden user names
        if ( $audience === self::AUDIENCE_PUBLIC || !$audience->isAllowed( 'hideuser' ) ) {
            $queryBuilder->leftJoin( 'ipblocks', null, 'user_id=ipb_user' );
            $queryBuilder->andWhere( [ 'ipb_deleted' => [ 0, null ] ] );
        }
 
        return $queryBuilder->caller( __METHOD__ )->fetchFieldValues();
    }
}