mmdm / sim-session
A simple yet nice session management library
Requires
- php: >=7.2
- ext-json: *
- mmdm/sim-crypt: ^1.0
README
A library for session management.
Features
- Simple sessions
- Time sessions
- Flash sessions
- Encrypted and secure
- Easy to use
Install
composer
composer require mmdm/sim-session
Or you can simply download zip file from github and extract it, then put file to your project library and use it like other libraries.
Just add line below to autoload files:
require_once 'path_to_library/autoloader.php';
and you are good to go.
How to use
// to instance a session object (without crypt) $session = new Session(); // set a session $session->set($key, $value); // get a session $theValue = $session->get($key);
Note: When you instantiate new session object, it will start session if it did not started yet.
Use with Crypt library
If you need more security on sessions, use Crypt library.
// send crypt instance through session // constructure (dependency injection) $session = new Session($crypt); // now your sessions are safe
If you don't need some of your sessions to be secure, pass false as last parameter of set methods.
Available functions
- start(bool $regenerate = false, bool $delete_old_session = false)
This method starts session. To regenerate it, pass true as first argument.
NOTE: It checks if session is started yet, if not then start it.
// start PHP sessions $session->start(); // regnerate session id $session->start(true);
NOTE: By default it'll not delete previous session but you can make this happen by send boolean as second parameter.
- close()
This method close a started session.
// close PHP session $session->close();
- hasStart(): bool
This method check if PHP session has started.
// close PHP session $session->hasStart();
- set(string $key, $value, bool $encrypt = true): ISession
This method set $key to session with $value. To prevent encrypting when Crypt is specified through construct method, pass false as last parameter to not encrypt $value.
Note: To store multidimensional array in session, $key can be dotted separated strings.
exp. foo.bar => $_SESSION['foo']['bar'].
// to set a session $session->set('foo', 'I am a normal session'); // or $session->set('foo.bar', 'I am a normal session');
- get(string $key = null, $prefer = null): mixed
This method get value of $key from session. If there is no session with key of $key it will return $prefer instead that can be specified through second argument - default is NULL.
Note: To get multidimensional array from session, $key can be dotted separated strings.
exp. foo.bar => $_SESSION['foo']['bar'].
// to get a session $session->get('foo'); // or $session->get('foo.bar', 'not set');
- remove(string $key): ISession
This method removes value of $key from session.
Note: To remove multidimensional array from session, $key can be dotted separated strings.
exp. foo.bar => $_SESSION['foo']['bar'].
// to remove a session $session->remove('foo'); // or $session->remove('foo.bar');
- has(string $key): bool
This method checks if $key is exists in sessions.
Note: To check multidimensional array in session, $key can be dotted separated strings.
exp. foo.bar => $_SESSION['foo']['bar'].
// to check existence of a session $session->has('foo'); // or $session->has('foo.bar');
- setTimed(string $key, $value, $time = 300, bool $encrypt = true): ISession
This method is like simple set method, the only difference is $time. With this feature you can define timer for a session value. Default value is 300 seconds.
// to set a timer session $session->setTimed('foo', 'I will expire after 10 seconds', 10); // or $session->setTimed('foo.bar');
- getTimed(string $key = null, $prefer = null): mixed
This method is like simple get method.
// to set a timer session $session->getTimed('foo'); // or $session->getTimed('foo.bar', 'not set');
- removeTimed(?string $key): ISession
This method is like simple remove method. The only difference is you can pass NULL to remove all timer sessions
// to remove a timer session $session->removeTimed('foo'); // or $session->removeTimed('foo.bar');
- hasTimed(string $key): bool
This method is like simple has method.
// to check existence of a timer session $session->hasTimed('foo'); // or $session->hasTimed('foo.bar');
- setFlash(string $key, $value, bool $encrypt = true): ISession
This method is like simple set method.
// to set a flash session $session->setFlash('foo'); // or $session->setFlash('foo.bar');
- getFlash(string $key = null, $prefer = null, $delete = true): mixed
This method is like simple get method. The only difference is after get a flash session, default behavior is to remove that session, but you can make it not to remove through last parameter.
// to get a flash session $session->getFlash('foo'); // or $session->getFlash('foo.bar', 'not set');
- removeFlash(?string $key = null): ISession
This method is like simple remove method. The only difference is you can pass NULL to remove all timer sessions
// to remove a flash session $session->removeFlash('foo'); // or $session->removeFlash('foo.bar', 'not set');
- hasFlash(string $key): bool
This method is like simple has method.
// to check existence of a flash session $session->hasFlash('foo'); // or $session->hasFlash('foo.bar');
Dependencies
There is just one dependency and it is Crypt library. With this feature, if any session hijacking happens, they can't see actual data because it is encrypted.
License
Under MIT license.