MultiUsernameFilter.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Preferences;
 
use MediaWiki\MediaWikiServices;
use MediaWiki\Permissions\Authority;
use MediaWiki\User\CentralId\CentralIdLookup;
 
class MultiUsernameFilter implements Filter {
    private $lookup;
    private $authorityOrAudience;
 
    public function __construct(
        ?CentralIdLookup $lookup = null,
        $authorityOrAudience = CentralIdLookup::AUDIENCE_PUBLIC
    ) {
        $this->lookup = $lookup;
        $this->authorityOrAudience = $authorityOrAudience;
    }
 
    public function filterFromForm( $names ) {
        $names = trim( $names );
        if ( $names !== '' ) {
            $names = preg_split( '/\n/', $names, -1, PREG_SPLIT_NO_EMPTY );
            $ids = $this->getLookup()->centralIdsFromNames( $names, $this->authorityOrAudience );
            if ( $ids ) {
                return implode( "\n", $ids );
            }
        }
        // If the user list is empty, it should be null (don't save) rather than an empty string
        return null;
    }
 
    public function filterForForm( $value ) {
        $ids = is_string( $value ) ? self::splitIds( $value ) : [];
        $names = $ids ? $this->getLookup()->namesFromCentralIds( $ids, $this->authorityOrAudience ) : [];
        return implode( "\n", $names );
    }
 
    public static function splitIds( $str ) {
        return array_map( 'intval', preg_split( '/\n/', $str, -1, PREG_SPLIT_NO_EMPTY ) );
    }
 
    private function getLookup() {
        $this->lookup ??= MediaWikiServices::getInstance()->getCentralIdLookup();
        return $this->lookup;
    }
}