CGI::Maypole(3)

💖 CGI::Maypole 💖

okay bestie, gather round, because this is the CGI-based front-end to Maypole and she is serving. This page lives in the User Contributed Perl Documentation section of the manual, and the module is CGI::Maypole, no cap. 🎀

---

✨ NAME ✨

CGI::Maypole — a CGI-based front-end to Maypole. it's giving "let my Maypole app run inside a plain old CGI script" and honestly? iconic. 👑

---

🌸 SYNOPSIS 🌸

package BeerDB;
use Maypole::Application;

## example beer.cgi:

#!/usr/bin/perl -w
use strict;
use BeerDB;
BeerDB->run();

so now, to go touch the beer database with your own two hands, you type this URL into your browser:

http://your.site/cgi-bin/beer.cgi/frontpage

NOTE: this Maypole frontend needs extra modules that are not gonna be installed or included with Maypole itself. pls read below, i'm begging. 🙈

---

🦋 DESCRIPTION 🦋

This is a CGI platform driver for Maypole, periodt. Your application can inherit from CGI::Maypole directly, but bestie, the recommendation is that you use Maypole::Application instead. trust. ✨

This module requires CGI::Simple, and you're gonna have to install that yourself — via CPAN or manually, your call, but it's on you. 💅

---

🎀 METHODS 🎀

• run — call this from your CGI script to start up the Maypole application. that's it, that's the whole vibe. 🚀

Implementation 💀

This class overrides a whole set of methods in the base Maypole class to provide its functionality. go peek at Maypole for these ones:

• get_request
• parse_location
• warn
• parse_args
• redirect_request
• get_protocol
• send_output — generates output (using collect_output) and prints it.
• collect_output — gathers headers and output together into a single string and returns it.
  • splitting this code out of send_output is what supports Maypole::HTTPD::Frontend.
• get_template_root

---

🌈 DEPENDANCIES 🌈

• CGI::Simple

(yes, that's the section name, i'm not fixing it, it's part of the lore. 💀)

---

👑 AUTHORS 👑

• Dave Ranney dave@sialia.com
• Simon Cozens simon@cpan.org

---

and that's the whole page, bestie!! 🫶 this one's from perl v5.42.0, dated 2025-07-25 — so go forth, run your CGI, and slay. mwah. 💖✨🦋