view release on metacpan or  search on metacpan

README  view on Meta::CPAN

      expires      = 1h       # default 24h

OBJECT METHODS
  create
    Create a new session.

    By default, when a new session is created, a browser cookie is set that
    contains a "session_id". Upon success, this session identifier is
    returned, which can also be used to set a customized session cookie.

      my $session_id = $c->plugin('Session')->create($c, 'login',
          {
              username => 'foo',
              password => 'bar',
          }
        );

  get
    Takes the cookie unique identifier or session id as arguments. Returns
    the session data as a hash reference.

      my $data_ref = $c->plugin('Session')->get($c, 'login');

      print $data_ref->{username};     # outputs 'foo'

  update
    Takes the cookie unique identifier or session id as arguments. Updates
    existing session data.

      $c->plugin('Session')->update($c, 'login',
          {
              last_login => localtime(time),
              remember   => 1,
          }
        );

  delete
    Takes the cookie unique identifier or session id as arguments. Deletes
    an existing session.

      $c->plugin('Session')->delete($c, 'login');

  id
    Return the cookie unique identifier for a given session.

      my $session_id = $c->plugin('Session')->id($c, 'login');

EXAMPLE
      package Example;

      sub _default {
          my ($self, $c) = @_;

          $c->plugin('Session')->create($c, 'login',
              {
                  username => 'foo',
                  password => 'bar',
              }
            );

          $c->plugin('CGI')->redirect($c, '/app/example/verify');
      }

      sub verify {
          my ($self, $c) = @_;

          my $data_ref = $c->plugin('Session')->get($c, 'login');

          $c->request->content_type('text/html');

          print $data_ref->{username} . '-' . $data_ref->{password};     # outputs 'foo-bar'
      }

      1;

SUPPORTED TYPES
    Apache2::WebApp::Plugin::Session::File
    Apache2::WebApp::Plugin::Session::Memcached
    Apache2::WebApp::Plugin::Session::MySQL

SEE ALSO
    Apache2::WebApp, Apache2::WebApp::Plugin,
    Apache2::WebApp::Plugin::Cookie, Apache::Session

AUTHOR
    Marc S. Brooks, <mbrooks@cpan.org> - <http://mbrooks.info>

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

    See <http://dev.perl.org/licenses/artistic.html>