NAME

Dancer2::Session::DBI - DBI based session engine for Dancer

VERSION

Version 0.01

SYNOPSIS

This is a more or less faithful port of Dancer::Session::DBI to Dancer2. It implements a session engine by serializing the session and storing it in a database via DBI. The only supported serialization method is JSON.

This was, so far, only tested with PostgreSQL but should in theory work with MySQL and SQLite as well, as we inherit the handling of these databases from the original module.

USAGE

In config.yml

        session: 'DBI'
        engines:
                session:
                        DBI:
                        dsn: "dbi:Pg:dbname=testing;host=127.0.0.1"
                        dbtable: "sessions"
                        dbuser: "user"
                        dbpass: "password"

The table needs to have at least id and a session_data columns.

A timestamp field that updates when a session is updated is recommended, so you can expire sessions server-side as well as client-side.

This session engine will not automagically remove expired sessions on the server, but with a timestamp field as above, you should be able to do it manually.

SEE ALSO

Dancer2, Dancer2::Session, Dancer::Session

ACKNOWLEDGEMENTS

This module is based on Dancer::Session::DBI by James Aitken <jaitken@cpan.org>

LICENSE AND COPYRIGHT

This software is Copyright (c) 2024 by Dennis Lichtenthäler.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)