maer/session

A dead simple and basic session library

A dead simple session library in PHP

, _(*1)

Manage PHP sessions and flash sessions in a simple way., _(*2)

Install

Clone this repository or use composer to download the library with the following command:, _(*3)

composer require maer/session 1.*

Set up

Load the library via composers autoloader:, _(*4)

include '/path/to/vendor/autoload.php';

Load the library manually:, _(*5)

include '/path/to/library/src/SessionInterface.php';
include '/path/to/library/src/Session.php';

Example

When a session instance is created, it will check if the session already is started. If not, it will start it using session_start()., _(*6)

Managing sessions

$session = new Maer\Session\Session();

// Set a value
$session->set('my-key', 'my-value');

// Get a value
$value = $session->get('my-key');

// Add an optional second argument
$value = $session->get('non-existint-key', 'this-will-be-returned');

// Check if a key exists
if ($session->has('my-key')) {
    // Yay... it exists!
} else {
   // Darn! It didn't exist!
}

// Forget/clear/remove a session key
$session->forget('my-key');

// Forget/clear/remove all session keys and destroy the session cookie
$session->destroy();

Flash sessions

A flash session is a "one-request-only"-session. If you set a flash session, it is only accessable in the next request and will then be removed. It's perfect for things like success/status/error messages., _(*7)

// Set a flash session
$session->setFlash('error', 'This is an error message');

// On the next request
$value = $session->getFlash('error');

// Add an optional second argument
$value = $session->get('non-existint-key', 'this-will-be-returned');

Both ->get(...) and ->getFlash(...) returns NULL as default if the key isn't found., _(*8)

I told you it was dead simple!, _(*9)

If you have any questions, suggestions or issues, let me know!, _(*10)

Happy coding!, _(*11)