Apache...ertrack(3pm)

💖 Apache::Session::Generate::ModUsertrack 💖

okay bestie, gather round — this is the 3pm manual page for Apache::Session::Generate::ModUsertrack, and it's literally about letting mod_usertrack do the session-ID heavy lifting. Let's get into it ✨

---

🌸 NAME 🌸

Apache::Session::Generate::ModUsertrack — it's mod_usertrack but make it session ID generation. Periodt. 💅

---

🦋 SYNOPSIS 🦋

Like, here's the whole vibe in code form, no cap:

use Apache::Session::Flex;

tie %session, 'Apache::Session::Flex', $id, {
    Store     => 'MySQL',
    Lock      => 'Null',
    Generate  => 'ModUsertrack',
    Serialize => 'Storable',
    ModUsertrackCookieName => 'usertrack', # optional
};

See that Generate => 'ModUsertrack'? That's the moment. That's the main character right there. 👑

---

💜 DESCRIPTION 💜

So here's the tea: Apache::Session::Generate::ModUsertrack enables you to use a cookie tracked by mod_usertrack as the session id for the Apache::Session framework. Slay.

And ngl, this module fits so well with long-term sessions — so bestie, you better be using an RDBMS like MySQL for its storage. It's giving longevity, it's giving commitment, it's giving database-backed forever-session. 🫶

---

✨ CONFIGURATION ✨

This module accepts one extra configuration option. Just one, iconic and focused.

• ModUsertrackCookieName — Specifies the cookie name used in mod_usertrack. The default is "Apache", so change this if you changed it via the "CookieName" directive in mod_usertrack. Basically: if you renamed your cookie, tell this module, or it'll be out here looking for the wrong one. 🙈

---

😭 LIMITATION WITHOUT MOD_PERL 😭

Okay so this is the part where it gets real.

This module first tries to fetch the named cookie, but it will do that in vain ONLY WHEN the HTTP request is the first one from a specific client to the mod_usertrack enabled Apache web server. Why? Because if the request is for the first time, the cookies are not yet baked on the clients. Not yet baked!! The cookies are still dough, bestie. 🍓

But — plot twist — if you run scripts under mod_perl, this module tries to steal the (not yet baked) cookie from Apache request notes. Sneaky. Iconic. Lowkey genius. 💀

See Apache for details.

---

🌈 AUTHOR 🌈

Tatsuhiko Miyagawa <miyagawa@bulknews.net> — absolute legend, we stan. 🫶

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

---

⭐ SEE ALSO ⭐

• Apache::Session
• Apache::Session::Flex
• mod_usertrack

---

and that's the whole page, bestie — you ate it all up 💅✨

cute little sign-off: this was perl v5.36.0, dated 2022-11-19, from the Apache...ertrack(3pm) manual. mwah 💖