A lightweight, file-based session handler for the Flight framework. It supports non-blocking behavior, optional encryption, and auto-commit functionality. See basic example.
Simply install with Composer
composer require flightphp/session
Let's see how easy it is to use FlightPHP Session:
// Create a session instance with default settings $session = new flight\Session(); // Store some data $session->set('user_id', 123); $session->set('username', 'johndoe'); $session->set('is_admin', false); // Retrieve data echo $session->get('username'); // Outputs: johndoe // Use a default value if the key doesn't exist echo $session->get('preferences', 'default_theme'); // Outputs: default_theme // Remove a session value $session->delete('is_admin'); // Check if a value exists if ($session->get('user_id')) { echo 'User is logged in!'; } // Clear all session data $session->clear();
You can customize the session handler with various configuration options:
$session = new flight\Session([ 'save_path' => '/custom/path/to/sessions', // Custom directory for storing session files 'encryption_key' => 'your-secret-32-byte-key', // Enable encryption with a secure key 'auto_commit' => true, // Automatically commit session changes on shutdown 'start_session' => true, // Start the session automatically 'test_mode' => false, // Enable for testing without affecting PHP's session state ]);
When dealing with sensitive user data, it's recommended to use encryption:
// Create a session with encryption enabled $session = new flight\Session([ 'encryption_key' => 'a-secure-32-byte-key-for-aes-256-cbc', ]); // Now all session data will be automatically encrypted when stored $session->set('credit_card', '4111-1111-1111-1111');
For security purposes, you might want to regenerate the session ID periodically:
// Regenerate the session ID and keep the current session data $session->regenerate(); // Regenerate the session ID and delete the old session data $session->regenerate(true);
Head over to the documentation page to learn more about usage and how cool this thing is! :)
MIT