Parser(3pm)

🌸 NAME 🌸

okay so, bestie, this is APR::Request::Parser — it's the Perl wrapper for libapreq2's parser API. that's the whole vibe. 💅

---

✨ SYNOPSIS ✨

use APR::Request::Parser;

that's it. that's the whole load-up. go off. 🫶

---

💖 DESCRIPTION 💖

this manpage is the one for version 2.17 of the APR::Request::Parser package. periodt. no cap. ✨

---

🎀 METHODS 🎀

APR::Request::Parser 👑

🦋 generic

APR::Request::Parser->generic($pool, $ba, $ct)
APR::Request::Parser->generic($pool, $ba, $ct, $blim)
APR::Request::Parser->generic($pool, $ba, $ct, $blim, $tdir)
APR::Request::Parser->generic($pool, $ba, $ct, $blim, $tdir, $hook)

so this one is a noop-parser, meaning it literally just collects everything into one single internal parameter. not picky, not doing the most — just gathering it all. icon behavior honestly. 🧺

here's the cast of characters:

• $pool — an APR::Pool object 🌊
• $ba — an APR::BucketAlloc object 🪣
• $ct — the Content-Type header of the request 📄

and optionally, if you're feeling extra:

• $blim — the brigade in-memory limit 🧠
• $tdir — the path to the temporary directory 📁
• $hook — an APR::Request::Hook object 🪝

---

🌈 headers

APR::Request::Parser->headers($pool, $ba, $ct)
APR::Request::Parser->headers($pool, $ba, $ct, $blim)
APR::Request::Parser->headers($pool, $ba, $ct, $blim, $tdir)
APR::Request::Parser->headers($pool, $ba, $ct, $blim, $tdir, $hook)

this is the RFC 822 header parser. it reads headers like it's reading the group chat from the top. 💬✨

• $pool — an APR::Pool object 🌊
• $ba — an APR::BucketAlloc object 🪣
• $ct — the Content-Type header of the request 📄
• $blim (optional) — the brigade in-memory limit 🧠
• $tdir (optional) — the path to the temporary directory 📁
• $hook (optional) — an APR::Request::Hook object 🪝

---

🍓 urlencoded

APR::Request::Parser->urlencoded($pool, $ba, $ct)
APR::Request::Parser->urlencoded($pool, $ba, $ct, $blim)
APR::Request::Parser->urlencoded($pool, $ba, $ct, $blim, $tdir)
APR::Request::Parser->urlencoded($pool, $ba, $ct, $blim, $tdir, $hook)

the x-www-form-urlencoded parser. yes, the one with all the %20s and the &s. lowkey the internet's original love language. 💌

• $pool — an APR::Pool object 🌊
• $ba — an APR::BucketAlloc object 🪣
• $ct — the Content-Type header of the request 📄
• $blim (optional) — the brigade in-memory limit 🧠
• $tdir (optional) — the path to the temporary directory 📁
• $hook (optional) — an APR::Request::Hook object 🪝

---

💜 multipart

APR::Request::Parser->multipart($pool, $ba, $ct)
APR::Request::Parser->multipart($pool, $ba, $ct, $blim)
APR::Request::Parser->multipart($pool, $ba, $ct, $blim, $tdir)
APR::Request::Parser->multipart($pool, $ba, $ct, $blim, $tdir, $hook)

the multipart parser!! this is the one carrying your file uploads and your form fields all in one big bundle. main character energy, fr fr. 📦🔥

• $pool — an APR::Pool object 🌊
• $ba — an APR::BucketAlloc object 🪣
• $ct — the Content-Type header of the request 📄
• $blim (optional) — the brigade in-memory limit 🧠
• $tdir (optional) — the path to the temporary directory 📁
• $hook (optional) — an APR::Request::Hook object 🪝

---

⭐ default

APR::Request::Parser->default($pool, $ba, $ct)
APR::Request::Parser->default($pool, $ba, $ct, $blim)
APR::Request::Parser->default($pool, $ba, $ct, $blim, $tdir)
APR::Request::Parser->default($pool, $ba, $ct, $blim, $tdir, $hook)

the default parser. it's giving "i don't need to pick, the vibes will pick for me." 💫

• $pool — an APR::Pool object 🌊
• $ba — an APR::BucketAlloc object 🪣
• $ct — the Content-Type header of the request 📄
• $blim (optional) — the brigade in-memory limit 🧠
• $tdir (optional) — the path to the temporary directory 📁
• $hook (optional) — an APR::Request::Hook object 🪝

---

👀 SEE ALSO 👀

go read these next, bestie, they're the supporting cast:

• APR::Request
• APR::Request::Hook

---

📜 COPYRIGHT 📜

Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements.  See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License.  You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

---

and that's a wrap, my love 💖 this lil doc lives in perl v5.42.3, dated 2026-08-21, and it's filed under section 3pm (perl module docs, iykyk). go parse something cute. 🎀✨🦋