3 * Class to walk into a list of User objects.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
23 use Wikimedia\Rdbms\IResultWrapper
;
25 abstract class UserArray
implements Iterator
{
27 * @param IResultWrapper $res
28 * @return UserArrayFromResult
30 static function newFromResult( $res ) {
32 if ( !Hooks
::run( 'UserArrayFromResult', [ &$userArray, $res ] ) ) {
35 return $userArray ??
new UserArrayFromResult( $res );
40 * @return UserArrayFromResult|ArrayIterator
42 static function newFromIDs( $ids ) {
43 $ids = array_map( 'intval', (array)$ids ); // paranoia
45 // Database::select() doesn't like empty arrays
46 return new ArrayIterator( [] );
48 $dbr = wfGetDB( DB_REPLICA
);
49 $userQuery = User
::getQueryInfo();
53 [ 'user_id' => array_unique( $ids ) ],
58 return self
::newFromResult( $res );
64 * @return UserArrayFromResult|ArrayIterator
66 static function newFromNames( $names ) {
67 $names = array_map( 'strval', (array)$names ); // paranoia
69 // Database::select() doesn't like empty arrays
70 return new ArrayIterator( [] );
72 $dbr = wfGetDB( DB_REPLICA
);
73 $userQuery = User
::getQueryInfo();
77 [ 'user_name' => array_unique( $names ) ],
82 return self
::newFromResult( $res );