Cataly...::MP13(3pm)

✨ Catalyst::Engine::Apache::MP13 — the mod_perl 1.3x engine, bestie edition ✨

okay so this is a 3pm perl manual page — a User Contributed Perl Documentation one, no less — and it's all about Catalyst::Engine::Apache::MP13, the Catalyst engine that's built specifically for Apache mod_perl version 1.3x. if that's your setup, this is your girl 💖

---

🌸 NAME 🌸

Catalyst::Engine::Apache::MP13 — the Catalyst Apache mod_perl 1.3x Engine. that's it, that's the whole name, and honestly? iconic. no notes. 👑

---

🎀 SYNOPSIS 🎀

here's how you set up your Catalyst app as a mod_perl 1.3x application in httpd.conf. copy it, love it, ship it:

# Set up your Catalyst app as a mod_perl 1.3x application in httpd.conf
<Perl>
    use lib qw( /var/www/MyApp/lib );
</Perl>

# Preload your entire application
PerlModule MyApp

<VirtualHost *>
    ServerName   myapp.hostname.com
    DocumentRoot /var/www/MyApp/root

    <Location />
        SetHandler       perl-script
        PerlHandler      MyApp
    </Location>

    # you can also run your app in any non-root location
    <Location /some/other/path>
        SetHandler      perl-script
        PerlHandler     MyApp
    </Location>

    # Make sure to let Apache handle your static files
    # (And remember to remove the Static::Simple plugin in production)
    <Location /static>
        SetHandler      default-handler
    </Location>
</VirtualHost>

⚠️ heads up bestie: let Apache handle your static files, and remember to remove the Static::Simple plugin in production. the config comments said it, so i'm saying it. do not skip this. 🫶

---

💅 DESCRIPTION 💅

This is the Catalyst engine specialized for Apache mod_perl version 1.3x. that's the whole vibe. it exists so your app can thrive under mod_perl 1.3x and nothing else. periodt. ✨

🦋 Apache::Registry 🦋

okay so while this method is not recommended, you can also run your Catalyst application via an Apache::Registry script. it's giving "you can, but should you?" energy. 😭

httpd.conf:

PerlModule Apache::Registry
Alias / /var/www/MyApp/script/myapp_registry.pl/

<Directory /var/www/MyApp/script>
    Options +ExecCGI
</Directory>

<Location />
    SetHandler  perl-script
    PerlHandler Apache::Registry
</Location>

and then script/myapp_registry.pl — you will need to create this, it does not spawn itself, bestie:

#!/usr/bin/perl

use strict;
use warnings;
use MyApp;

MyApp->handle_request( Apache->request );

---

⭐ METHODS ⭐

ok_constant

yep, that's the method. it's listed. it's here. it's valid. slay. 💜

---

🌈 OVERLOADED METHODS 🌈

This class overloads some methods from "Catalyst::Engine::Apache". so if you were expecting the base behavior, surprise, it's different now. main character energy fr fr. 👑

$c->engine->finalize_headers

that's the overloaded one right there. 💖

---

👀 SEE ALSO 👀

• Catalyst
• Catalyst::Engine
• Catalyst::Engine::Apache

go read those too, iykyk. 📚✨

---

🫶 AUTHORS 🫶

• Sebastian Riedel <sri@cpan.org>
• Christian Hansen <ch@ngmedia.com>
• Andy Grundman <andy@hybridized.org>
• Tomas Doran <bobtfish@bobtfish.net>

four legends, one engine. we love to see it. 🎀

---

💖 COPYRIGHT AND LICENSE 💖

This software is copyright (c) 2010 by The "AUTHORS".

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

tl;dr: it's free, it's open, go wild, just keep the same terms as Perl 5 itself. 🧚

---

and that's the whole page bestie!! this was perl v5.36.0, dated 2022-12-06, from the User Contributed Perl Documentation collection — Cataly...::MP13(3pm), mwah, no cap. 💅🌸✨