Perlba...eaders(3pm)

💖 NAME 💖

Perlbal::XS::HTTPHeaders — the Perlbal extension that processes HTTP headers, bestie. That's it, that's the whole vibe. ✨

---

🦋 SYNOPSIS 🦋

okay so here's the whole thing in action, no cap:

use HTTPHeaders;

my $hdr = Perlbal::XS::HTTPHeaders->new("GET / HTTP/1.0\r\nConnection: keep-alive\r\n\r\n");
if ($hdr->getMethod == M_GET()) {
  print "GET: ", $hdr->getURI(), "\n";
  print "Connection: ", $hdr->getHeader('Connection'), "\n";
}

like… look at her. method check, URI grab, header grab. the way that this just works. 💅

---

🌸 DESCRIPTION 🌸

So basically this module reads HTTP headers out of a string and parses them into an internal storage format so it's super easy to access them and also mess with them. And — plot twist — you can also ask her to reconstitute the headers back into one big string. Which is huge if you're writing a proxy and you need to read and write headers while ✨maintaining the ability✨ to go in and modify individual little pieces of the whole thing. Obsessed, honestly.

The goal? SHE FAST. 🏃💨 This is a lot faster than doing all that text processing directly in Perl, and most of the flexibility of Perl is still there because the library itself is implemented in Perl and descends from Perlbal::HTTPHeaders. Best of both worlds, tbh.

🎀 Exportable constants 🎀

these babies right here, you can export them:

H_REQUEST
H_RESPONSE
M_GET
M_POST
M_HEAD
M_OPTIONS
M_PUT
M_DELETE

periodt. 💜

---

💀 KNOWN BUGS 💀

There are no known bugs at this time. literally none. immaculate. 🙈

Please report any you find! Fr fr, she wants to know. 🫶

---

🔥 SEE ALSO 🔥

Perlbal — and by extension this module — can be discussed by joining the Perlbal mailing list over at http://lists.danga.com/. come hang out bestie. 🎀

Also, please see the original HTTPHeaders module implemented entirely in Perl, living in the Perlbal source tree, available at http://cvs.danga.com/ in the wcmtools repository, perlbal/lib/Perlbal/ directory. she's the blueprint, iykyk. 👑

---

👑 AUTHOR 👑

Mark Smith, <junior@danga.com> — the icon, the legend, the main character. 🦋

---

🌈 COPYRIGHT AND LICENSE 🌈

Copyright (C) 2004 by Danga Interactive, Inc.

Copyright (C) 2005 by Six Apart, Ltd.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.4 or, at your option, any later version of Perl 5 you may have available.

---

And that's the whole page, girlies 💖 — brought to you by perl v5.42.3, dated 2026-08-19, straight out of the User Contributed Perl Documentation. slay, bye!! ✨🎀💅