Same name and namespace in other branches
  1. 7.x modules/user/user.module \user_load_by_name()
  2. 8.9.x core/modules/user/user.module \user_load_by_name()
  3. 9 core/modules/user/user.module \user_load_by_name()

Fetches a user object by account name.

Parameters

string $name: String with the account's user name.

Return value

\Drupal\user\UserInterface|false A fully-loaded $user object upon successful user load or FALSE if user cannot be loaded.

See also

\Drupal\user\Entity\User::loadMultiple()

6 calls to user_load_by_name()
ContactPersonalTest::checkContactAccess in core/modules/contact/tests/src/Functional/ContactPersonalTest.php
Creates a user and then checks contact form access.
DbLogTest::doUser in core/modules/dblog/tests/src/Functional/DbLogTest.php
Generates and then verifies some user events.
PathProcessorTest::processInbound in core/modules/system/tests/modules/url_alter_test/src/PathProcessorTest.php
UserCreateTest::testUserAdd in core/modules/user/tests/src/Functional/UserCreateTest.php
Tests user creation and display from the administration interface.
UserLanguageCreationTest::testLocalUserCreation in core/modules/user/tests/src/Functional/UserLanguageCreationTest.php
Functional test for language handling during user creation.

... See full list

File

core/modules/user/user.module, line 194
Enables the user registration and login system.

Code

function user_load_by_name($name) {
  $users = \Drupal::entityTypeManager()
    ->getStorage('user')
    ->loadByProperties([
    'name' => $name,
  ]);
  return $users ? reset($users) : FALSE;
}