Maypole::Headers(3)

💖 Maypole::Headers 💖

okay bestie, gather round, because this is the little module that makes your HTTP headers situation so much cuter. it's a convenience wrapper around HTTP::Headers — that's the whole vibe. ✨

---

🌸 NAME 🌸

Maypole::Headers — a convenience wrapper around HTTP::Headers. she's small, she's helpful, she's lowkey carrying your whole response. 💅

---

🎀 SYNOPSIS 🎀

use Maypole::Headers;

$r->headers_out(Maypole::Headers->new); # Note, automatic in Maypole
$r->headers_out->set('Content-Base' => 'http://localhost/maypole');
$r->headers_out->push('Set-Cookie' => $cookie->as_string);
$r->headers_out->push('Set-Cookie' => $cookie2->as_string);

print $r->headers_out->as_string;

like. look at her. set, push, as_string, done. no notes. 🫶

---

🦋 DESCRIPTION 🦋

so basically it's a convenience wrapper around HTTP::Headers, but with extra methods sprinkled on top so your mutators stop being so repetitive and wordy. it's giving less typing, same power. ✨

for example, this:

$r->headers_out->header(Content_Base => $r->config->uri_base);

can be written as:

$r->headers_out->set(Content_Base => $r->config->uri_base);

same thing, shorter name, cuter energy. periodt. 💜

---

👑 METHODS 👑

you get all the standard HTTP::Headers methods, plus these icons right here:

• get($header) — gets the value of a header field. it's an alias to HTTP::Headers->header. 🍓
• set($header ="gt" $value, ...) — sets the value of one or more header fields. also an alias to HTTP::Headers->header. you can pass a whole little pile of them, hence the .... 💅
• push($header ="gt" $value) — adds a value to the field named $header, and bestie, the previous values are maintained. nothing gets thrown away here. it's an alias to HTTP::Headers->push_header. 🔥
• add — alias to push — useful for Apache::Session::Wrapper support, in CGI mode. yeah, that's the whole entry. iconic of her honestly. 🌈
• init($header ="gt" $value) — sets the value for the field named $header, but only if that header is currently undefined. so if it's already set, she minds her business and does nothing. it's an alias to HTTP::Headers->init_header. 🧚
• remove($header, ...) — removes one or more headers. yes plural, go off. it's an alias to HTTP::Headers->remove_header. 💀
• field_names() — returns a list of distinct header names. it's an alias to HTTP::Headers->header_field_names. ⭐

---

💜 SEE ALSO 💜

HTTP::Headers — the original queen this whole thing wraps around. go pay her a visit. 🎀

---

✨ AUTHOR ✨

Simon Flack — thank you for your service, king. 🫶

---

and that's the whole page, bestie!! this was perl v5.42.0, dated 2025-07-25, filed under Maypole::Headers(3) — no cap, go forth and set your headers. mwah. 💖✨🦋🌸