Catalyst::Plugin::Session::CGISession 0.04

Catalyst::Plugin::Session::CGISession is a Perl module to use CGI::Session for persistent session data.

SYNOPSIS

use Catalyst qw{ ... Session::CGISession ... };

MyApp->config->{session} = {
expires => 3600,
rewrite => 1,
};

$c->session->{user_email} = quibble@dibble.edu;

# Later, in another following request:

$smtp->to( $c->session->{user_email} );

This plugin provides the same functionality as the original Session::FastMmap plugin but uses the CGI::Session module for the session data management.

The motivations to develop this plugin were:

provide better session data expiration handling, as is available through the CGI::Session module
provide an easier migration to Catalyst for applications that have been using CGI::Session and its param() and other methods
allow Windows users to avoid the workarounds needed to make Cache::FastMmap work

The difference in session expiration between this plugin and Session::FastMmap is small but important. CGI::Session resets the expiration time limit on every access to the session. A one day time limit means the session data disappears 24 hours after the last request using that session. With Session::FastMmap the limit would be 24 hours after the first request, when the session is created.

While this plugin adds some functions and methods beyond those available with Session::FastMmap, new development most likely should avoid using these features. Try to use only the common feature, session(), to stay compatible with Session::FastMmap and other future session plugins.