Hook(3pm)

💖 Hook(3pm) — User Contributed Perl Documentation 💖

okay bestie, don't panic — you found the rite of passage manpage, and ngl it's a short one. This is Hook(3pm), straight outta the User Contributed Perl Documentation corner of the perl world. let's get into it 🫶

---

✨ NAME ✨

APR::Request::Hook — it's a wrapper for libapreq2's hook API. that's it, that's the whole name section. iconic brevity.

---

🌸 SYNOPSIS 🌸

use APR::Request::Hook;

yeah. that's literally the whole thing. one line. no cap. 💅

---

🦋 DESCRIPTION 🦋

This manpage is documenting version 2.17 of the APR::Request::Hook package. 📌

So like… that's the version. Write it down. Put it in your notes app. It's 2.17, bestie.

---

👑 METHODS 👑

APR::Request::Hook

the class itself. the main character. let's meet the methods ✨

---

disable_uploads 🚫📁

APR::Request::Hook->disable_uploads($pool)
APR::Request::Hook->disable_uploads($pool, $next)

okay so this is a hook that returns APREQ_ERROR_GENERAL if a file upload field gets detected. like — nope, not today, no uploads for you. 🙅‍♀️

• $pool is an APR::Pool object.
• $next — if it's present — is the next APR::Request::Hook in the chain. 🔗

---

apr_xml_parser 🧚✨

APR::Request::Hook->apr_xml_parser($pool)
APR::Request::Hook->apr_xml_parser($pool, $next)

an Xml parser hook. it parses. it's xml. you get the vibe. 🎀

• $pool is an APR::Pool object.
• $next — if it's present — is the next APR::Request::Hook in the chain. 🔗

---

discard_brigade 🗑️💀

APR::Request::Hook->discard_brigade($pool)
APR::Request::Hook->discard_brigade($pool, $next)

this hook discards the brigade it receives from the parser. just straight up tossing it. gone. not me being dramatic, that's literally the method's whole job 😭

• $pool is an APR::Pool object.
• $next — if it's present — is the next APR::Request::Hook in the chain. 🔗

---

🌈 SEE ALSO 🌈

go read these next, bestie, iykyk:

• APR::Request
• APR::Request::Parser

---

📜 COPYRIGHT 📜

here comes the legal bit — it's giving very "read the fine print" energy, but it matters fr fr 🫶

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 the whole page, bestie!! 🎉 this was Hook(3pm), and the page itself came from perl v5.42.3, dated 2026-08-21. go forth and hook responsibly, you absolute icon 👑💖✨