NSY Session Library — User Tutorial

Native session helper at System/Libraries/Session.php (namespace System\Libraries, class Session). All methods are static and wrap PHP's session_* functions.

Table of Contents

1. Starting a Session
2. Reading & Writing
3. Lifecycle
4. Flash Messages
5. Quick Reference

Starting a Session

NSY starts the session at boot (NSY_System::initializeSession()), using the session_config array in System/Config/App.php.

use System\Libraries\Session;

Session::start();                 // uses default options
Session::start(['cookie_samesite' => 'Strict']);
Session::isActive();              // bool
Session::id();                    // current session id

start() is idempotent and returns false (without error) when headers were already sent.

Reading & Writing

Session::set('user_id', 42);
Session::get('user_id');              // 42
Session::get('missing', 'default');   // 'default'
Session::has('user_id');              // true
Session::remove('user_id');           // remove one
Session::remove('a', 'b');            // remove many
Session::all();                       // whole $_SESSION

Lifecycle

Session::regenerate();    // new id after login (keeps data, deletes old id)
Session::destroy();       // clear $_SESSION + session_destroy()

Both return false when no session is active or headers were sent.

Flash Messages

Flash values survive exactly one read:

Session::flash('notice', 'Saved successfully.');

// next request / later in the same flow:
echo Session::getFlash('notice');   // 'Saved successfully.'
echo Session::getFlash('notice');   // null (consumed)

Quick Reference

Related source: System/Libraries/Session.php. Tests: System/Test/Libraries/SessionTest.php.