popphp/pop-session

Pop Session Component for Pop PHP Framework

pop-session

, _(*1)

, _(*2)

• Overview
• Install
• Quickstart
• Time-Based
• Request-Based
• Namespaces

Overview

pop-session is a component used to manage sessions and session data in the PHP web environment. It includes the ability to also manage namespaces within the session as well as timed-based and request-based expirations., _(*3)

pop-session is a component of the Pop PHP Framework., _(*4)

Top, _(*5)

Install

Install pop-session using Composer., _(*6)

composer require popphp/pop-session

Or, require it in your composer.json file, _(*7)

"require": {
    "popphp/pop-session" : "^4.0.2"
}

Top, _(*8)

Quickstart

You can create a session and store and fetch data from it:, _(*9)

use Pop\Session\Session;

$sess = Session::getInstance();

// Set session values
$sess->foo   = 'bar';
$sess['baz'] = 123;

// Access session values
echo $sess['foo'];
echo $sess->baz;

You can unset session data like this:, _(*10)

unset($sess->foo);
unset($sess['baz']);

And finally, you can destroy the whole session like this:, _(*11)

$sess->kill();

Top, _(*12)

Time-Based

Session values can be made available based on time expiration:, _(*13)

use Pop\Session\Session;

$sess = Session::getInstance();
$sess->setTimedValue('foo', 'bar', 10); // # of seconds

Then, the next request will be successful if it's within the time limit of that session data:, _(*14)

use Pop\Session\Session;

if (isset($sess->foo)) {
    echo $sess->foo;
} else {
    echo 'Nope!';
}

Top, _(*15)

Request-Based

Session values can be made available based on number of requests:, _(*16)

use Pop\Session\Session;

$sess = Session::getInstance();
$sess->setRequestValue('foo', 'bar', 1); // # of requests

Then, the next request will be successful if it's within the set limit of number requests allowed before that session data is expired:, _(*17)

if (isset($sess->foo)) {
    echo $sess->foo;
} else {
    echo 'Nope!';
}

Top, _(*18)

Namespaces

You can store session data under a namespace to separate that data from the global session data:, _(*19)

use Pop\Session\SessionNamespace;

$sessMyApp = new SessionNamespace('MyApp');
$sessMyApp->foo = 'bar'

if (isset($sessMyApp->foo)) {
    echo $sessMyApp->foo;  // Only available under the namespace.
} else {
    echo 'Nope!';
}

Session namespaces can also store time-based and request-based session data:, _(*20)

use Pop\Session\SessionNamespace;

$sessMyApp = new SessionNamespace('MyApp');
$sessMyApp->setTimedValue('foo', 'bar', 10); // # of seconds
$sessMyApp->setRequestValue('foo', 'bar', 1); // # of requests

Top, _(*21)