libapa...ionUtil(3pm)

✨ NAME ✨

Apache2::ConnectionUtil — it's the Perl API for Apache connection utils, bestie 💅 (it lives in the User Contributed Perl Documentation section, manual page libapa...ionUtil(3pm), if you were wondering where you wandered in from)

---

🌸 Synopsis 🌸

use Apache2::Connection     ();
use Apache2::ConnectionUtil ();
use Apache2::RequestRec     ();

# grab the connection object;
my $c = $r->connection;

# share perl objects like $r->pnotes
$old_val = $c->pnotes($key => $value);

---

🦋 Description 🦋

Apache2::ConnectionUtil hands you the utilities API for the Apache connection record object. That's the whole vibe. It's giving "connection-level goodies" 🔥

---

💖 API 💖

Here's everything Apache2::ConnectionUtil gives you, no gatekeeping:

🎀 pnotes

Share Perl variables between requests over the lifetime of the connection. Yes, the connection, not just one request — she persists 👑

$old_val  = $c->pnotes($key => $val);
$val      = $c->pnotes($key);
$hash_ref = $c->pnotes();

• obj: $c ( an Apache2::Connection object ) — your main character ✨
• opt arg1: $key ( string ) — a key value
• opt arg2: $val ( SCALAR ) — any scalar value (e.g. a reference to an array). Live your life, it's flexible 💅
• ret: three different possible values, and which one you get depends on what you handed her:
  • if both $key and $val are passed, the previous value for $key is returned if such existed — otherwise undef comes back at you 😭
  • if only $key is passed, the current value for the given key is returned
  • if no arguments are passed, a hash reference is returned, which you can then directly access without going through the pnotes() interface. Sneaky shortcut, we love her 🫶
• since: 2.0.3

Peep Apache2::RequestUtil::pnotes for the full details on how the pnotes method works — the usage is identical except for a couple of differences. First one: you use $c as the invocant instead of $r. Second one: the data persists for the lifetime of the connection instead of the lifetime of the request. So like, if the connection is lost, so is the data stored in pnotes. Gone. Poof. 💀 Not recoverable, so don't get attached.

---

🌈 See Also 🌈

• Apache2::Connection.
• Apache2::RequestUtil::pnotes.
• mod_perl 2.0 documentation.

---

👑 Copyright 👑

mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.

---

💜 Authors 💜

The mod_perl development team and numerous contributors. (The collective, fr fr 🌟)

---

That's the whole page, babes — brought to you by perl v5.42.3, stamped 2026-08-20. Go forth and share your connection pnotes responsibly 🎀💖