NAME

Maypole::Plugin::Session - simple sessions for Maypole

SYNOPSIS

    use Maypole::Application qw( Session );
    
    # Elsewhere in your app:
    my $session = $r->session;
    

API CHANGES

This version is a re-write using Apache::Session::Wrapper. As such, the configuration parameters have changed - use Apache::Session::Wrapper settings rather than Apache::Session settings. See Configuration.

DESCRIPTION

Provides session and delete_session methods for your Maypole request class. The session is implemented using Apache::Session::Wrapper, and as such, a range of session store mechanisms are available.

CONFIGURATION

The Configuration section of the Apache::Session::Wrapper docs lists all the available parameters. These should be placed in the Maypole::Config::session slot as a hashref.

setup

If there are no settings in Maypole::Config->session, then default settings for Apache::Session::File are placed there. Also, cookies are turned on by default:

    $config->{session} = { class          => 'File',
                           directory      => "/tmp/sessions",
                           lock_directory => "/tmp/sessionlock",
                     
                           use_cookie => 1,
                           cookie_name => 'maypole-plugin-session-cookie',
                           };
                         

You need to create these directories with appropriate permissions if you want to use these defaults.

You can place custom settings there either before (preferably) or after (probably OK) calling Maypole->setup, e.g.

    $r->config->session( { class     => "Flex",
                           store     => 'DB_File',
                           lock      => 'Null',
                           generate  => 'MD5',
                           serialize => 'Storable'
                           } );

METHODS

session

Returns the session hashref.

delete_session

Deletes the session and cookie.

PRIVATE METHODS

These are only necessary if you are writing custom authenticate method(s). Otherwise, they are called for you.

authenticate

This is called early in the Maypole request workflow, and is used as the hook to call get_session. If you are writing your own authenticate method(s), either in model classes or in the request classes, make sure your authenticate method calls get_session.

get_session

Retrieves the cookie from the browser and matches it up with a session in the store.

You should call this method inside any custom authenticate methods.

SEE ALSO

Apache::Session::Wrapper.

AUTHOR

David Baird, <cpan@riverside-cms.co.uk>

BUGS

Please report any bugs or feature requests to bug-maypole-plugin-session@rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Maypole-Plugin-Session. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT & LICENSE

Copyright 2005 David Baird, All Rights Reserved.

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