anax / session
Anax Session module, a wrapper around sessions.
Installs: 18 356
Dependents: 31
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 2
Open Issues: 0
Language:Makefile
Requires
- php: ^7.2
Requires (Dev)
- anax/configure: ^2.0.0@alpha
- anax/di: ^2.0.0@alpha
- phpunit/phpunit: ^7
Suggests
- anax/configure: ^2.0.0@alpha
This package is auto-updated.
Last update: 2024-10-23 18:09:53 UTC
README
Anax Session module, for wrapping the session and providing useful helpers related to the session.
The Session module is prepared wo be used for unit testing when run in CLI environment.
Table of content
- Class, interface, trait
- Exceptions
- Configuration file
- DI service
- Access as framework service
- Start the session
- Work with session variables
- Session flash messages
- Debug the session
- Destroy the session
Class, interface, trait
The following classes, interfaces and traits exists.
Exceptions
There are no module specific exceptions.
Configuration file
This is a sample configuration file, it is usually stored in config/session.php
.
/** * Config-file for sessions. */ return [ // Session name "name" => preg_replace("/[^a-z\d]/i", "", __DIR__), //"name" => preg_replace("/[^a-z\d]/i", "", ANAX_APP_PATH), ];
DI service
The session is created as a framework service within $di
. The following is a sample on how the session service is created.
/** * Creating the session as a $di service. */ return [ // Services to add to the container. "services" => [ "session" => [ "active" => defined("ANAX_WITH_SESSION") && ANAX_WITH_SESSION, // true|false "shared" => true, "callback" => function () { $session = new \Anax\Session\Session(); // Load the configuration files $cfg = $this->get("configuration"); $config = $cfg->load("session"); // Set session name $name = $config["config"]["name"] ?? null; if (is_string($name)) { $session->name($name); } $session->start(); return $session; } ], ], ];
The session can always be active, in the default configuration file this is depending on the PHP define ANAX_WITH_SESSION
which is usually set in config/commons.php
which is available from the module anax/commons
.
The session is always started when ANAX_WITH_SESSION
is defined and true
.
This is how the callback works, when it creates the session service.
- The object is created.
- The configuration file, usually
config/session.php
, is read. - The session is named.
- The session is created.
The service is lazy loaded and not created until it is used. However, it is always loaded when "active" => true
.
Access as framework service
You can access the module as a framework service.
# $app style $app->session->start(); # $di style, two alternatives $di->get("session")->start(); $session = $di->get("session"); $session->start();
Start the session
The recommended way, and the default behaviour, is to start the session by defining ANAX_WITH_SESSION
and set it to true
. This is usually done in config/commons.php
which source is available in the module anax/commons
.
Setting ANAX_WITH_SESSION
to false
means that the session is not started by default.
As an alternative, you can start the session anywhere by activating (using) the di service. A good place to do this is in the frontkontroller index.php
, after you have created $di
(and $app
). The session will then be available for all page requests.
The session will not start when running in CLI (for example PHPUnit), however, it will still be active and usable as means of unit testing.
Work with session variables
There are helpers to use when reading and setting values in the session.
# Check if a key is set in the session $app->session->has($key); # Get a value from the session, null if it is not set. $app->session->get($key); # Get a value from the session or get the default value. $app->session->get($key, $default); # Set a value in the session, associated with a key. $app->session->set($key, $value); # Delete a key from the session. $app->session->delete($key);
Session flash messages
There is feature useful for flash messages. A value is retrieved from the session and is then deleted.
# Get the value from the session and then delete its key, default is null. $app->session->getOnce($key); # Specify your own default value when key does not exists. $app->session->getOnce($key, $default);
Debug the session
You can var_dump the session object and it will print out the content of $_SESSION
.
# Debug the session and review its content through var_dump. var_dump($app->session);
Destroy the session
You can destroy the session which might be useful during development.
# Destroy the session. $app->session->destroy();
License
This software carries a MIT license. See LICENSE.txt for details.
.
..: Copyright (c) 2013 - 2019 Mikael Roos, mos@dbwebb.se