NAME

       Dancer2::Session::YAML - YAML-file-based session backend for Dancer2

VERSION

       version 1.1.0

DESCRIPTION

       This module implements a session engine based on YAML files. Session are stored in a session_dir as YAML
       files. The idea behind this module was to provide a human-readable session storage for the developer.

       This backend is intended to be used in development environments, when digging inside a session can be
       useful.

       This backend can perfectly be used in production environments, but two things should be kept in mind: The
       content of the session files is in plain text, and the session files should be purged by a CRON job.

CONFIGURATION

       The setting session should be set to "YAML" 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".

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

           session: "YAML"

           engines:
             session:
               YAML:
                 session_dir: "/tmp/dancer-sessions"
                 cookie_duration: 3600    # Default cookie timeout in seconds

DEPENDENCY

       This module depends on YAML.

SEE ALSO

       See Dancer2::Core::Session for details about session usage in route handlers.

AUTHOR

       Dancer Core Developers

COPYRIGHT AND LICENSE

       This software is copyright (c) 2023 by Alexis Sukrieh.

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

perl v5.36.0                                       2023-12-15                        Dancer2::Session::YAML(3pm)