Plack:...Cleanup(3pm)

💖 Plack::Session::Cleanup — aka Plack:...Cleanup(3pm) 💖

okay bestie, so this is a page from the User Contributed Perl Documentation set, and it's literally the tiniest lil bop. It's called Plack::Session::Cleanup and it does exactly one job, but it does it flawlessly. 💅

---

✨ NAME ✨

Plack::Session::Cleanup — run code when the environment is destroyed. that's it. that's the whole vibe. 🫶

---

🌸 SYNOPSIS 🌸

$env->{'run_at_cleanup'} = Plack::Session::Cleanup->new(
    sub {
        # ...
    }
);

look at her. so clean. so demure. 🌈

---

🦋 DESCRIPTION 🦋

so the tea is: this module gives Plack::Middleware::Session a little runway to run code the moment the environment gets cleaned up. That's the whole serve. 🎀

---

👑 METHODS 👑

🌟 new ( $coderef )

When you build one of these bad boys, it holds onto your $coderef and fires it off when the object gets "DESTROY"'d. Like, the moment it's destroyed, boom, your code runs. iconic behaviour, no cap. 💫

⚠️ bestie please read this part: you gotta be careful that the code reference you hand over does not close over $env. Because if it does, you create a cycle, and then $env can never, ever be destroyed. it's giving trapped-forever energy and not in a cute way. 😭 the whole point is the cleanup, and a cycle means no cleanup. so watch that closure. fr fr. 💀

---

💜 sign-off 💜

and that's the page, babe! this lil doc ships with perl v5.40.1, dated 2025-08-10, and it's filed under Plack:...Cleanup(3pm). go forth and destroy your environments responsibly. mwah. 💖🌸🦋✨