Plack::...ler::CGI(3)

🎀 Plack::Handler::CGI 🎀

okay bestie, welcome to the manual page for Plack::Handler::CGI — that's the CGI handler for Plack, it lives in section 3 of the User Contributed Perl Documentation, and honestly? it's giving "small module, big main character energy." pull up a chair, we're doing this 💖

---

✨ NAME ✨

Plack::Handler::CGI — CGI handler for Plack, fr fr. that's the whole name, that's the whole vibe 🦋

---

🌸 SYNOPSIS 🌸

so you wanna run a PSGI application as a CGI script? periodt. literally just rename your .psgi to .cgi and swap out the shebang line like this:

#!/usr/bin/env plackup
# rest of the file can be the same as other .psgi file

yep that's it, the rest of the file stays exactly the same as any other .psgi file. slay ✨

orrr, alternative route, you can make a .cgi file that contains something like this instead:

#!/usr/bin/perl
use Plack::Loader;
my $app = Plack::Util::load_psgi("/path/to/app.psgi");
Plack::Loader->auto->run($app);

this one will auto-recognize the CGI environment variable to load this class. it just knows. iykyk 💅

and if you really wanna explicitly load the CGI handler — like, no auto-magic, you're doing it by hand — you can! for instance you might do this when you want to embed a PSGI application server built into a CGI-compatible perl-based web server:

use Plack::Handler::CGI;
Plack::Handler::CGI->new->run($app);

iconic behavior honestly 👑

---

💜 DESCRIPTION 💜

okay so, real talk: this is a handler module to run any PSGI application as a CGI script. that's its whole job and it does it beautifully. no notes. 🫶

---

🌈 UTILITY METHODS 🌈

⭐ setup_env()

my $env = Plack::Handler::CGI->setup_env();
my $env = Plack::Handler::CGI->setup_env(\%override_env);

this one sets up the PSGI environment hash for a CGI request, pulling from %ENV, and then hands it right back to you.

and get this — you can pass in a hashref of key/value pairs to override the defaults if that's what you wanna do. your request, your rules, bestie 💖

---

👀 SEE ALSO 👀

• Plack — yeah, the whole parent ecosystem, go say hi 🦋

---

lowkey reminder: the descriptions above are the whole story — nothing extra, nothing invented, just the facts with a glow-up 💅

---

and that's a wrap! this page came to you from perl v5.42.3, dated 2026-10-18, filed under Plack::...ler::CGI(3) in the User Contributed Perl Documentation. mwah, bye bestie, go run some CGI 💖✨🎀