plack::session(3pm) [debian man page]

Plack::Session(3pm)					User Contributed Perl Documentation				       Plack::Session(3pm)

NAME

       Plack::Session - Middleware for session management

SYNOPSIS

	 # Use with Middleware::Session
	 enable "Session";

	 # later in your app
	 use Plack::Session;
	 my $app = sub {
	     my $env = shift;
	     my $session = Plack::Session->new($env);

	     $session->id;
	     $session->get($key);
	     $session->set($key, $value);
	     $session->remove($key);
	     $session->keys;

	     $session->expire;
	 };

DESCRIPTION

       This is the core session object, you probably want to look at Plack::Middleware::Session, unless you are writing your own session
       middleware component.

METHODS

       new ( $env )
	   The constructor takes a PSGI request env hash reference.

       id  This is the accessor for the session id.

   Session Data Management
       These methods allows you to read and write the session data like Perl's normal hash.

       get ( $key )
       set ( $key, $value )
       remove ( $key )
       keys
       session, dump

   Session Lifecycle Management
       expire
	   This method can be called to expire the current session id.

BUGS

       All complex software has bugs lurking in it, and this module is no exception. If you find a bug please either email me, or add the bug to
       cpan-RT.

AUTHOR

       Stevan Little <stevan.little@iinteractive.com>

COPYRIGHT AND LICENSE

       Copyright 2009, 2010 Infinity Interactive, Inc.

       <http://www.iinteractive.com>

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.12.4							    2011-03-29						       Plack::Session(3pm)

Plack::Session::State::Cookie(3pm)			User Contributed Perl Documentation			Plack::Session::State::Cookie(3pm)

NAME

       Plack::Session::State::Cookie - Basic cookie-based session state

SYNOPSIS

	 use Plack::Builder;
	 use Plack::Middleware::Session;

	 my $app = sub {
	     return [ 200, [ 'Content-Type' => 'text/plain' ], [ 'Hello Foo' ] ];
	 };

	 builder {
	     enable 'Session'; # Cookie is the default state
	     $app;
	 };

DESCRIPTION

       This is a subclass of Plack::Session::State and implements its full interface. This is the default state used in
       Plack::Middleware::Session.

METHODS

       new ( %params )
	   The %params can include path, domain, expires, secure, and httponly options, as well as all the options accepted by
	   Plack::Session::Store.

       path
	   Path of the cookie, this defaults to "/";

       domain
	   Domain of the cookie, if nothing is supplied then it will not be included in the cookie.

       expires
	   Expiration time of the cookie in seconds, if nothing is supplied then it will not be included in the cookie, which means the session
	   expires per browser session.

       secure
	   Secure flag for the cookie, if nothing is supplied then it will not be included in the cookie.

       httponly
	   HttpOnly flag for the cookie, if nothing is supplied then it will not be included in the cookie.

BUGS

       All complex software has bugs lurking in it, and this module is no exception. If you find a bug please either email me, or add the bug to
       cpan-RT.

AUTHOR

       Stevan Little <stevan.little@iinteractive.com>

COPYRIGHT AND LICENSE

       Copyright 2009, 2010 Infinity Interactive, Inc.

       <http://www.iinteractive.com>

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.12.4							    2011-03-29					Plack::Session::State::Cookie(3pm)