/ 
Dancer2-Session-Sereal-0.004
River stage zero No dependents
/ Dancer2::Session::Sereal

NAME

Dancer2::Session::Sereal - Dancer 2 session storage in files with Sereal

VERSION

version 0.004

DESCRIPTION

This module implements Dancer 2 session engine based on Sereal files.

This backend can be used in single-machine production environments, but two things should be kept in mind: The content of the session files is not encrypted or protected in anyway and old session files should be purged by a CRON job.

encoder_args

Arguments to be passed to Sereal::Encoder. If these are not provided in the session configuration, sensible defaults are used.

decoder_args

Arguments to be passed to Sereal::Decoder. If these are not provided in the session configuration, sensible defaults are used.

CONFIGURATION

The setting session should be set to Sereal in order to use this session engine in a Dancer2 application.

Files will be stored to the value of the setting session_dir, whose default value is appdir/sessions.

Arguments for the Sereal::Encoder and Sereal::Decoder objects can be given via the encoder_args and decoder_args. If not provided, they default to snappy => 1, croak_on_bless =>1 and refuse_objects => 1, validate_utf8 => 1, respectively.

Here is an example configuration that use this session engine and stores session files in /tmp/dancer-sessions

session: "Sereal"

engines:
  session:
    Sereal:
      session_dir: "/tmp/dancer-sessions"
      encoder_args:
        snappy:         1
        croak_on_bless: 1
      decoder_args:
        refuse_objects: 1
        validate_utf8:  1

SUPPORT

Bugs / Feature Requests

Please report any bugs or feature requests through the issue tracker at https://github.com/PerlDancer/dancer2-session-sereal/issues. You will be notified automatically of any progress on your issue.

Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license.

https://github.com/PerlDancer/dancer2-session-sereal

git clone https://github.com/PerlDancer/dancer2-session-sereal.git

AUTHOR

David Golden <dagolden@cpan.org>

CONTRIBUTORS

  • Jason A. Crome <jason@crome-plated.com>

  • Peter Mottram <peter@sysnix.com>

  • Yanick Champoux <yanick@babyl.dyndns.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2013 by David Golden.

This is free software, licensed under:

The Apache License, Version 2.0, January 2004