Dancer...n::YAML(3pm)

💖 Dancer::Session::YAML 💖

okay bestie, so this is Dancer::Session::YAML — the YAML-file-based session backend for Dancer ✨ fr fr, it's part of the User Contributed Perl Documentation, and she's sitting at version 1.3522 🎀

---

🌸 NAME 🌸

Dancer::Session::YAML — YAML-file-based session backend for Dancer 💅

✨ VERSION ✨

version 1.3522

🦋 DESCRIPTION 🦋

So basically this module is a whole session engine built on top of YAML files 🍓 Sessions get stored in a session_dir as YAML files — like, the whole point of this module was to give the developer a transparent session storage. Nothing hidden, nothing sneaky, you can literally peek inside 👀

The tea is: this backend is meant for development environments, when looking inside a session is actually useful 💖

ngl tho — it's genuinely NOT recommended to use this session engine in production environments. Like, at all. Take that warning seriously, bestie 😭

🎀 CONFIGURATION 🎀

For your Dancer app to use this session engine, you gotta set the session setting to "YAML" — no cap, that's the switch ✨

Your files get stored to whatever value the session_dir setting holds, and its default value is appdir/sessions 💅

Here's an example config that uses this session engine and stores session files in /tmp/dancer-sessions:

session: "YAML"
session_dir: "/tmp/dancer-sessions"

💅 METHODS 💅

🌈 reset

So here's the vibe: instead of checking whether the sessions directory exists every single time a new session is created, this module keeps a cache of session directories it's already created 👑 reset wipes that cache out, forcing a test for existence of the sessions directory the next time a session is created. It takes no argument — zero, nada, none 🫶

And the way this is particularly useful is if you wanna remove the sessions directory on the system where your app is running, but you still want this session engine to keep working without having to restart your entire application 😭 iconic behaviour honestly

⭐ DEPENDENCY ⭐

This module depends on YAML.

💜 AUTHOR 💜

This module has been written by Alexis Sukrieh, see the AUTHORS file for details.

🔥 SEE ALSO 🔥

See Dancer::Session for details about session usage in route handlers 👀

🌸 COPYRIGHT 🌸

This module is copyright (c) 2009 Alexis Sukrieh <sukria@sukria.net>

🧚 LICENSE 🧚

This module is free software and is released under the same terms as Perl itself ✨

👑 AUTHOR 👑

Dancer Core Developers

💖 COPYRIGHT AND LICENSE 💖

This software is copyright (c) 2010 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 🌈

---

okay that's the whole page, you ate it, periodt 💅 this was served up from perl v5.40.1 on 2026-05-05, under the manual page Dancer...n::YAML(3pm) — go forth and session responsibly, bestie 🫶💖