8 user.module user_login_finalize(UserInterface $account)
7 user.module user_login_finalize(&$edit = array())

Finalizes the login process and logs in a user.

The function logs in the user, records a watchdog message about the new session, saves the login timestamp, calls hook_user_login(), and generates a new session.

The current user is replaced with the passed in account.


\Drupal\user\UserInterface $account: The account to log in.

See also


4 calls to user_login_finalize()
install_finished in core/includes/install.core.inc
Performs final installation steps and displays a 'finished' page.
RegisterForm::save in core/modules/user/src/RegisterForm.php
Form submission handler for the 'save' action.
UserLoginForm::submitForm in core/modules/user/src/Form/UserLoginForm.php
Form submission handler.
UserPasswordResetForm::submitForm in core/modules/user/src/Form/UserPasswordResetForm.php
Form submission handler.


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


function user_login_finalize(UserInterface $account) {
  \Drupal::logger('user')->notice('Session opened for %name.', array('%name' => $account->getUsername()));
  // Update the user table timestamp noting user has logged in.
  // This is also used to invalidate one-time login links.

  // Regenerate the session ID to prevent against session fixation attacks.
  // This is called before hook_user_login() in case one of those functions
  // fails or incorrectly does a redirect which would leave the old session
  // in place.
  \Drupal::service('session')->set('uid', $account->id());
  \Drupal::moduleHandler()->invokeAll('user_login', array($account));