bryanjhv/slim-session

slim-session     [Donate][paylnk]

Simple middleware for Slim Framework 4, that allows managing PHP
built-in sessions and includes a Helper class to help you with the $_SESSION
superglobal.

For the middleware version for Slim Framework 3, please check out the slim-3
branch in this repository.

For the middleware version for Slim Framework 2, please check out the slim-2
branch in this repository.

Installation

Add this line to require block in your composer.json:

"bryanjhv/slim-session": "~4.0"

Or, run in a shell instead:

composer require bryanjhv/slim-session:~4.0

Usage

$app = \Slim\Factory\AppFactory::create();
$app->add(
  new \Slim\Middleware\Session([
    'name' => 'dummy_session',
    'autorefresh' => true,
    'lifetime' => '1 hour',
  ])
);

Supported options

Session helper

A Helper class is available, which you can register globally or instantiate:

$container = new \DI\Container();

// Register globally to app
$container->set('session', function () {
  return new \SlimSession\Helper();
});
\Slim\Factory\AppFactory::setContainer($container);

That will provide $app->get('session'), so you can do:

$app->get('/', function ($req, $res) {
  // or $this->get('session') if registered
  $session = new \SlimSession\Helper();

  // Check if variable exists
  $exists = $session->exists('my_key');
  $exists = isset($session->my_key);
  $exists = isset($session['my_key']);

  // Get variable value
  $my_value = $session->get('my_key', 'default');
  $my_value = $session->my_key;
  $my_value = $session['my_key'];

  // Set variable value
  $app->get('session')->set('my_key', 'my_value');
  $session->my_key = 'my_value';
  $session['my_key'] = 'my_value';

  // Merge value recursively
  $app->get('session')->merge('my_key', ['first' => 'value']);
  $session->merge('my_key', ['second' => ['a' => 'A']]);
  $letter_a = $session['my_key']['second']['a']; // "A"

  // Delete variable
  $session->delete('my_key');
  unset($session->my_key);
  unset($session['my_key']);

  // Destroy session
  $session::destroy();

  // Get session id
  $id = $this->session::id();

  return $res;
});

Contributors

Here are the big ones listed. :smile:

TODO

License

MIT

[paylnk]:
https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=DVB7SSMVSHGTN

Last update: Thu, 15 Mar 2018 14:29:54