NAME

Mojolicious::Sessions:ThreeS - A Mojolicious Sessions manager that supports controlling Storage, State and Sid generation.

SYNOPSIS

You can use this directly when you build your mojolicious App:

package My::App;
use Mojo::Base 'Mojolicious';

use Mojolicious::Sessions:ThreeS;

sub startup{
  my ($app) = @_;
  ...
  $app->sessions( Mojolicious::Sessions:ThreeS->new({ storage => ... , state => ... , sidgen => ... } ) );
  ...
}

Or as a plugin, with exactly the same arguments. See Mojolicious::Plugin::Sessions3S.

new

Builds an instance of this given the following properties (all optional):

storage

An instance of a subclass of Mojolicious::Sessions::ThreeS::Storage. Defaults to undef

When not given, this will consider itself inactive and fallback to the default Mojolicious::Sessions behaviour.

state

An instance of a subclass of Mojolicious::Sessions::ThreeS::State. Defaults to an instance of Mojolicious::Sessions::ThreeS::State::Cookie.

sidgen

An Session ID generator, instance of Mojolicious::Sessions::ThreeS::SidGen. Defaults to an instance of Mojolicious::Sessions::ThreeS::SidGen::Simple.

was_set

This was set with explicit store, storage and sid generator.

Usage:

if ( $this->was_set() ){
   ...
}

cookie_domain

From Mojolicious::Sessions. Delegate to the underlying Cookie based state. Use this only if you know the state object supports cookies.

cookie_name

From Mojolicious::Sessions. Delegate to the underlying Cookie based state. Use this only if you know the state object supports cookies.

cookie_path

From Mojolicious::Sessions. Delegate to the underlying Cookie based state. Use this only if you know the state object supports cookies.

secure

From Mojolicious::Sessions. Delegate to the underlying Cookie based state. Use this only if you know the state object supports cookies.

load

Implements load from Mojolicious::Sessions

store

Implements store from Mojolicious::Sessions

get_session_id

Get the current session ID or generate a fresh one and store it in the given session object, using the given controller.

Usage:

my $session_id = $this->session_id( $session, $controller );