class AccountSwitcher
Same name in other branches
- 8.9.x core/lib/Drupal/Core/Session/AccountSwitcher.php \Drupal\Core\Session\AccountSwitcher
- 10 core/lib/Drupal/Core/Session/AccountSwitcher.php \Drupal\Core\Session\AccountSwitcher
- 11.x core/lib/Drupal/Core/Session/AccountSwitcher.php \Drupal\Core\Session\AccountSwitcher
An implementation of AccountSwitcherInterface.
This allows for safe switching of user accounts by ensuring that session data for one user is not leaked in to others. It also provides a stack that allows reverting to a previous user after switching.
Hierarchy
- class \Drupal\Core\Session\AccountSwitcher implements \Drupal\Core\Session\AccountSwitcherInterface
Expanded class hierarchy of AccountSwitcher
1 string reference to 'AccountSwitcher'
- core.services.yml in core/
core.services.yml - core/core.services.yml
1 service uses AccountSwitcher
File
-
core/
lib/ Drupal/ Core/ Session/ AccountSwitcher.php, line 12
Namespace
Drupal\Core\SessionView source
class AccountSwitcher implements AccountSwitcherInterface {
/**
* A stack of previous overridden accounts.
*
* @var \Drupal\Core\Session\AccountInterface[]
*/
protected $accountStack = [];
/**
* The current user service.
*
* @var \Drupal\Core\Session\AccountProxyInterface
*/
protected $currentUser = [];
/**
* The write-safe session handler.
*
* @var \Drupal\Core\Session\WriteSafeSessionHandlerInterface
*/
protected $writeSafeHandler;
/**
* The original state of session saving prior to account switching.
*
* @var bool
*/
protected $originalSessionSaving;
/**
* Constructs a new AccountSwitcher.
*
* @param \Drupal\Core\Session\AccountProxyInterface $current_user
* The current user service.
* @param \Drupal\Core\Session\WriteSafeSessionHandlerInterface $write_safe_handler
* The write-safe session handler.
*/
public function __construct(AccountProxyInterface $current_user, WriteSafeSessionHandlerInterface $write_safe_handler) {
$this->currentUser = $current_user;
$this->writeSafeHandler = $write_safe_handler;
}
/**
* {@inheritdoc}
*/
public function switchTo(AccountInterface $account) {
// Prevent session information from being saved and push previous account.
if (!isset($this->originalSessionSaving)) {
// Ensure that only the first session saving status is saved.
$this->originalSessionSaving = $this->writeSafeHandler
->isSessionWritable();
}
$this->writeSafeHandler
->setSessionWritable(FALSE);
array_push($this->accountStack, $this->currentUser
->getAccount());
$this->currentUser
->setAccount($account);
return $this;
}
/**
* {@inheritdoc}
*/
public function switchBack() {
// Restore the previous account from the stack.
if (!empty($this->accountStack)) {
$this->currentUser
->setAccount(array_pop($this->accountStack));
}
else {
throw new \RuntimeException('No more accounts to revert to.');
}
// Restore original session saving status if all account switches are
// reverted.
if (empty($this->accountStack)) {
if ($this->originalSessionSaving) {
$this->writeSafeHandler
->setSessionWritable(TRUE);
}
}
return $this;
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title |
---|---|---|---|---|
AccountSwitcher::$accountStack | protected | property | A stack of previous overridden accounts. | |
AccountSwitcher::$currentUser | protected | property | The current user service. | |
AccountSwitcher::$originalSessionSaving | protected | property | The original state of session saving prior to account switching. | |
AccountSwitcher::$writeSafeHandler | protected | property | The write-safe session handler. | |
AccountSwitcher::switchBack | public | function | Reverts to a previous account after switching. | Overrides AccountSwitcherInterface::switchBack |
AccountSwitcher::switchTo | public | function | Safely switches to another account. | Overrides AccountSwitcherInterface::switchTo |
AccountSwitcher::__construct | public | function | Constructs a new AccountSwitcher. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.