SessionStore.php in Auth0 Single Sign On 8.2

Namespace

Auth0\SDK\Store

File

vendor/auth0/auth0-php/src/Store/SessionStore.php

<?php

namespace Auth0\SDK\Store;


/**
 * This class provides a layer to persist user access using PHP Sessions.
 *
 * @author Auth0
 */
class SessionStore implements StoreInterface {

  /**
   * Default session base name.
   */
  const BASE_NAME = 'auth0_';

  /**
   * Default session cookie expiration.
   */
  const COOKIE_EXPIRES = 604800;

  /**
   * Session base name, configurable on instantiation.
   *
   * @var string
   */
  protected $session_base_name = self::BASE_NAME;

  /**
   * Session cookie expiration, configurable on instantiation.
   *
   * @var integer
   */
  protected $session_cookie_expires;

  /**
   * SessionStore constructor.
   *
   * @param string  $base_name      Session base name.
   * @param integer $cookie_expires Session expiration in seconds; default is 1 week - @deprecated 5.7.0
   */
  public function __construct($base_name = self::BASE_NAME, $cookie_expires = self::COOKIE_EXPIRES) {
    $this->session_base_name = (string) $base_name;
    $this->session_cookie_expires = (int) $cookie_expires;
  }

  /**
   * This basic implementation of BaseAuth0 SDK uses
   * PHP Sessions to store volatile data.
   *
   * @return void
   */
  private function initSession() {
    if (!session_id()) {
      if (!empty($this->session_cookie_expires)) {
        session_set_cookie_params($this->session_cookie_expires);
      }
      session_start();
    }
  }

  /**
   * Persists $value on $_SESSION, identified by $key.
   *
   * @param string $key   Session key to set.
   * @param mixed  $value Value to use.
   *
   * @return void
   */
  public function set($key, $value) {
    $this
      ->initSession();
    $key_name = $this
      ->getSessionKeyName($key);
    $_SESSION[$key_name] = $value;
  }

  /**
   * Gets persisted values identified by $key.
   * If the value is not set, returns $default.
   *
   * @param string $key     Session key to set.
   * @param mixed  $default Default to return if nothing was found.
   *
   * @return mixed
   */
  public function get($key, $default = null) {
    $this
      ->initSession();
    $key_name = $this
      ->getSessionKeyName($key);
    if (isset($_SESSION[$key_name])) {
      return $_SESSION[$key_name];
    }
    else {
      return $default;
    }
  }

  /**
   * Removes a persisted value identified by $key.
   *
   * @param string $key Session key to delete.
   *
   * @return void
   */
  public function delete($key) {
    $this
      ->initSession();
    $key_name = $this
      ->getSessionKeyName($key);
    unset($_SESSION[$key_name]);
  }

  /**
   * Constructs a session key name.
   *
   * @param string $key Session key name to prefix and return.
   *
   * @return string
   */
  public function getSessionKeyName($key) {
    $key_name = $key;
    if (!empty($this->session_base_name)) {
      $key_name = $this->session_base_name . '_' . $key_name;
    }
    return $key_name;
  }

}

Classes

Name	Description
SessionStore	This class provides a layer to persist user access using PHP Sessions.