Data::...:Driver(3pm)

πŸ’– Data::Session::Driver β€” the parent of ALL the session drivers πŸ’–

okay bestie, so this is Data::Session::Driver, from the User Contributed Perl Documentation section (that's what the 3pm on the end is giving ✨). It's the manual page for the parent module that every single Data::Session::Driver::* module inherits from. She's the momager of the whole driver family, and honestly? iconic. πŸ‘‘


🌸 NAME 🌸

Data::Session::Driver β€” a persistent session manager πŸ’…


πŸ¦‹ Synopsis πŸ¦‹

Like, the synopsis is not here, babe. Go look at Data::Session for the details:

See Data::Session for details.

That's it. That's the synopsis. She's mysterious. She's lowkey gatekeeping. 😭


✨ Description ✨

Data::Session::Driver is the parent of all Data::Session::Driver::* modules. Think of her as the mother of dragons but for session storage backends. Every driver out there is one of her children and they all inherit her whole vibe. πŸ‰


πŸ’… Case-sensitive Options πŸ’…

There's important info about case-sensitive options, but it does not live here. Nope. Go read "Case-sensitive Options" in Data::Session β€” that's where the tea is. β˜•


πŸŽ€ Method: new() πŸŽ€

Creates a new object of type Data::Session::Driver. Fresh baby driver, brand new, no cap. 🌱

new() takes a hash of key/value pairs, some of which might be mandatory. And heads up β€” some combinations might be mandatory too. So like, you can't just throw random keys in there and hope for the best, bestie. Read the docs for your specific driver. πŸ™ˆ


πŸ”₯ Method: remove($id) πŸ”₯

Deletes from storage the session identified by $id, or dies if it can't. It's giving "you either delete this session or this whole program ends," and honestly, respect the drama. πŸ’€

Returns 1.


⭐ Method: retrieve($id) ⭐

Retrieves from storage the session identified by $id, or dies if it can't. Same energy as remove(), just the opposite direction. 🫢

Returns the session.

⚠️ Important!! This is a frozen session. This value must be thawed by calling the appropriate serialization driver's thaw() method. Do not try to use a frozen session directly, she is literally on ice. 🧊

Good news though: Data::Session calls the right thaw() automatically. So you don't have to do it yourself, but now you know it's happening behind the scenes, iykyk. ✨


πŸ’œ Support πŸ’œ

Found a bug? Log it on RT, bestie:

<https://rt.cpan.org/Public/Dist/Display.html?Name=Data-Session>

That's the link. Go click it. Let them know. πŸ›


πŸ‘‘ Author πŸ‘‘

Data::Session was written by Ron Savage <ron@savage.net.au> in 2010. Legend behavior. 🌟

Home page: <http://savage.net.au/index.html>.


Australian copyright (c) 2010, Ron Savage.

All Programs of mine are 'OSI Certified Open Source Software';
you can redistribute them and/or modify them under the terms of
The Artistic License, a copy of which is available at:
http://www.opensource.org/licenses/index.html

and that's the whole page, babe!! no sections skipped, no details dropped, every single fact preserved and slathered in glitter. πŸ’–

perl v5.36.0 β€” 2023-02-14 πŸ’« mwah, catch you in the next manpage, bestie πŸŽ€πŸ¦‹πŸ’…
πŸ“¦ where this page comes from