UserAuthentication.php

Same filename and directory in other branches
  1. 11.x core/modules/user/src/UserAuthentication.php
  2. 10 core/modules/user/src/UserAuthentication.php

Namespace

Drupal\user

File

core/modules/user/src/UserAuthentication.php

View source
<?php

namespace Drupal\user;

use Drupal\Core\Entity\EntityTypeManagerInterface;
use Drupal\Core\Password\PasswordInterface;

/**
 * Validates user authentication credentials.
 */
class UserAuthentication implements UserAuthenticationInterface {
  
  /**
   * The entity type manager.
   *
   * @var \Drupal\Core\Entity\EntityTypeManagerInterface
   */
  protected $entityTypeManager;
  
  /**
   * The password hashing service.
   *
   * @var \Drupal\Core\Password\PasswordInterface
   */
  protected $passwordChecker;
  
  /**
   * Constructs a UserAuth object.
   *
   * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
   *   The entity type manager.
   * @param \Drupal\Core\Password\PasswordInterface $password_checker
   *   The password service.
   */
  public function __construct(EntityTypeManagerInterface $entity_type_manager, PasswordInterface $password_checker) {
    $this->entityTypeManager = $entity_type_manager;
    $this->passwordChecker = $password_checker;
  }
  
  /**
   * {@inheritdoc}
   */
  public function lookupAccount($identifier) : UserInterface|false {
    if (!empty($identifier)) {
      $account_search = $this->entityTypeManager
        ->getStorage('user')
        ->loadByProperties([
        'name' => $identifier,
      ]);
      if ($account = reset($account_search)) {
        return $account;
      }
    }
    return FALSE;
  }
  
  /**
   * {@inheritdoc}
   */
  public function authenticateAccount(UserInterface $account, #[\SensitiveParameter] string $password) : bool {
    if ($this->passwordChecker
      ->check($password, $account->getPassword())) {
      // Update user to new password scheme if needed.
      if ($this->passwordChecker
        ->needsRehash($account->getPassword())) {
        $account->setPassword($password);
        $account->save();
      }
      return TRUE;
    }
    return FALSE;
  }

}

Classes

Title Deprecated Summary
UserAuthentication Validates user authentication credentials.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.