Dancer2::Session::YAML(3pm)

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

VERSION
version 2.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) 2026 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.