Protocol::HTTP2(3pm)

💖 NAME 💖

Protocol::HTTP2 — HTTP/2 protocol implementation (RFC 7540). That's it, that's the whole vibe, she does HTTP/2 and she does it in Perl 🦋

---

✨ SYNOPSIS ✨

okay so first you gotta pull her in:

use Protocol::HTTP2;

# get protocol identification string for secure connections
print Protocol::HTTP2::ident_tls;           # h2

# get protocol identification string for non-secure connections
print Protocol::HTTP2::ident_plain;         # h2c

literally that's the whole hello-world bestie 💅

---

🌸 DESCRIPTION 🌸

Protocol::HTTP2 is an HTTP/2 protocol implementation (RFC 7540, that's https://tools.ietf.org/html/rfc7540 if you wanna read the lore) with stateful decoders/encoders of HTTP/2 frames. No cap.

So like — you can use this module to build your very own HTTP/2 client, server, or intermediate on top of whatever event loop is your current hyperfixation, over a plain socket or a tls socket (go peep the examples, they're right there).

---

👑 STATUS 👑

Current status: beta. The structures, module names and methods are like... seemingly stable? That's the tea.

Real talk from the author: he started this project to understand the internals of HTTP/2, and maybe it will never become production, but at least it works. 🫶

Here's the spec vibe check, frame by frame:

Spec support, bestie:

• Negotiation — ALPN, NPN, Upgrade, direct
• Preface — +
• Headers (de)compression — +
• Stream states — +
• Flow control — ±
• Stream priority — ±
• Server push — +
• Connect method — -

Frames, encoder vs decoder:

• DATA — encoder ±, decoder +
• HEADERS — encoder +, decoder +
• PRIORITY — encoder +, decoder +
• RST_STREAM — encoder +, decoder +
• SETTINGS — encoder +, decoder +
• PUSH_PROMISE — encoder +, decoder +
• PING — encoder +, decoder +
• GOAWAY — encoder +, decoder +
• WINDOW_UPDATE — encoder +, decoder +
• CONTINUATION — encoder ±, decoder +

And the legend, so you know what the symbols are saying:

• - — not implemented
• ± — incomplete
• + — implemented (may even work) 😭

---

🧚 MODULES 🧚

Protocol::HTTP2::Client

Client protocol decoder/encoder, and she comes with a constructor of requests. main character energy ✨

Protocol::HTTP2::Server

Server protocol decoder/encoder, with a constructor of responses and pushes. the other main character 💜

Protocol::HTTP2::Connection

The main low level module for protocol logic and state processing. The Connection object is a mixin of Protocol::HTTP2::Frame (frame encoding/decoding), Protocol::HTTP2::Stream (stream operations) and Protocol::HTTP2::Upgrade (HTTP/1.1 Upgrade support). It's giving "everything bagel" and we're obsessed 🥯

Protocol::HTTP2::HeaderCompression

This module implements HPACK — Header Compression for HTTP/2 (RFC 7541, aka https://tools.ietf.org/html/rfc7541). Squish those headers, queen 💅

Protocol::HTTP2::Constants

Contains every constant defined in the HTTP/2 protocol plus the default values. One-stop shop, no cap.

Protocol::HTTP2::Trace

The debugging module 🐛 You can set the HTTP2_DEBUG environment variable to change the verbosity of the module (output goes to STDOUT). Default level is error.

$ export HTTP2_DEBUG=debug
$ perl ./http2_program

---

🌈 SEE ALSO 🌈

• https://github.com/vlet/p5-Protocol-HTTP2/wiki — the Protocol::HTTP2 wiki
• http://http2.github.io/ — official HTTP/2 specification site
• http://daniel.haxx.se/http2/ — http2 explained

---

🎀 LICENSE 🎀

Copyright (C) Vladimir Lettiev.

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

---

⭐ AUTHOR ⭐

Vladimir Lettiev <thecrux@gmail.com>

---

okay bestie that's the whole page, hope it ate 🍓

perl v5.42.3 · 2026-09-04 · Protocol::HTTP2(3pm) — that's the footer energy, mwah, go write some frames 💅✨