ElggSession.php

Go to the documentation of this file.

<?php

class ElggSession implements ArrayAccess {

    protected $storage;

    protected $loggedInUser;

    public function __construct(Elgg_Http_SessionStorage $storage) {
        $this->storage = $storage;
        $this->loggedInUser = null;
    }

    public function start() {
        $result = $this->storage->start();
        $this->generateSessionToken();
        return $result;
    }

    public function migrate($destroy = false) {
        return $this->storage->regenerate($destroy);
    }

    public function invalidate() {
        $this->storage->clear();
        $this->loggedInUser = null;
        $result = $this->migrate(true);
        $this->generateSessionToken();
        return $result;
    }

    public function isStarted() {
        return $this->storage->isStarted();
    }

    public function getId() {
        return $this->storage->getId();
    }

    public function setId($id) {
        $this->storage->setId($id);
    }

    public function getName() {
        return $this->storage->getName();
    }

    public function setName($name) {
        $this->storage->setName($name);
    }

    public function get($name, $default = null) {
        return $this->storage->get($name, $default);
    }

    public function set($name, $value) {
        $this->storage->set($name, $value);
    }

    public function remove($name) {
        return $this->storage->remove($name);
    }

    public function del($key) {
        elgg_deprecated_notice(__METHOD__ . " has been deprecated.", 1.9);
        $this->remove($key);
    }

    public function has($name) {
        return $this->storage->has($name);
    }

    public function setLoggedInUser(ElggUser $user) {
        $this->set('guid', $user->guid);
        $this->loggedInUser = $user;
    }

    public function getLoggedInUser() {
        return $this->loggedInUser;
    }

    public function removeLoggedInUser() {
        $this->loggedInUser = null;
        $this->remove('guid');
    }

    protected function generateSessionToken() {
        // Generate a simple token that we store server side
        if (!$this->has('__elgg_session')) {
            $this->set('__elgg_session', md5(microtime() . rand()));
        }
    }

    public function __isset($key) {
        elgg_deprecated_notice(__METHOD__ . " has been deprecated.", 1.9);
        // Note: We use offsetExists() for BC
        return $this->offsetExists($key);
    }

    public function offsetSet($key, $value) {
        elgg_deprecated_notice(__METHOD__ . " has been deprecated.", 1.9);
        $this->set($key, $value);
    }

    public function offsetGet($key) {
        elgg_deprecated_notice(__METHOD__ . " has been deprecated.", 1.9);

        if (in_array($key, array('user', 'id', 'name', 'username'))) {
            elgg_deprecated_notice("Only 'guid' is stored in session for user now", 1.9);
            if ($this->loggedInUser) {
                switch ($key) {
                    case 'user':
                        return $this->loggedInUser;
                        break;
                    case 'id':
                        return $this->loggedInUser->guid;
                        break;
                    case 'name':
                    case 'username':
                        return $this->loggedInUser->$key;
                        break;
                }
            } else {
                return null;
            }
        }

        if ($this->has($key)) {
            return $this->get($key);
        }

        $orig_value = null;
        $value = elgg_trigger_plugin_hook('session:get', $key, null, $orig_value);
        if ($orig_value !== $value) {
            elgg_deprecated_notice("Plugin hook session:get has been deprecated.", 1.9);
        }

        $this->set($key, $value);
        return $value;
    }

    public function offsetUnset($key) {
        elgg_deprecated_notice(__METHOD__ . " has been deprecated.", 1.9);
        $this->remove($key);
    }

    public function offsetExists($offset) {
        elgg_deprecated_notice(__METHOD__ . " has been deprecated.", 1.9);

        if (in_array($offset, array('user', 'id', 'name', 'username'))) {
            elgg_deprecated_notice("Only 'guid' is stored in session for user now", 1.9);
            return (bool)$this->loggedInUser;
        }

        if ($this->has($offset)) {
            return true;
        }

        // Note: We use offsetGet() for BC
        if ($this->offsetGet($offset)) {
            return true;
        }

        return false;
    }
}