The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Data::Session::ID::UUID64 - A persistent session manager

Synopsis

See Data::Session for details.

Description

Data::Session::ID::UUID64 allows Data::Session to generate session ids using Data::UUID.

To use this module do this:

o Specify an id generator of type UUID64, as Data::Session -> new(type => '... id:UUID64 ...')

Note: The uuid will be 24 (sic) bytes because that's the number of bytes in a UUID64 digest.

See scripts/digest.pl.

Case-sensitive Options

See "Case-sensitive Options" in Data::Session for important information.

Method: new()

Creates a new object of type Data::Session::ID::UUID64.

new() takes a hash of key/value pairs, some of which might mandatory. Further, some combinations might be mandatory.

The keys are listed here in alphabetical order.

They are lower-case because they are (also) method names, meaning they can be called to set or get the value at any time.

o verbose => $integer

Print to STDERR more or less information.

Typical values are 0, 1 and 2.

This key is normally passed in as Data::Session -> new(verbose => $integer).

This key is optional.

Method: generate()

Generates the next session id, or dies if it can't.

The algorithm is Data::UUID -> new -> create_b64.

Returns the new id.

Warning: You should never try to use 'driver:File;id:UUID64;...', since the ids generated by this module sometimes contain '/', which the code forbids to be part of a file name.

Method: id_length()

Returns 24 (sic) because that's the number of bytes in a UUID64 digest.

This can be used to generate the SQL to create the sessions table.

See scripts/digest.pl.

Support

Log a bug on RT: https://rt.cpan.org/Public/Dist/Display.html?Name=Data-Session.

Author

Data::Session was written by Ron Savage <ron@savage.net.au> in 2010.

Home page: http://savage.net.au/index.html.

Copyright

Australian copyright (c) 2010, Ron Savage.

        All Programs of mine are 'OSI Certified Open Source Software';
        you can redistribute them and/or modify them under the terms of
        The Artistic License, a copy of which is available at:
        http://www.opensource.org/licenses/index.html