---
name: "Catalyst::Engine::Apache2::MP19"
section: "3pm"
platform: "linux"
package: "libcatalyst-engine-apache-perl"
version: "1.16-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Catalyst::Engine::Apache2::MP19"
---

# Catalyst::Engine::Apache2::MP19(3pm)

Catalyst Apache2 mod\_perl 1.99x Engine

## NAME

Catalyst::Engine::Apache2::MP19 - Catalyst Apache2 mod\_perl 1.99x Engine

## SYNOPSIS

```
    # Set up your Catalyst app as a mod_perl 1.99x application in httpd.conf
    PerlSwitches -I/var/www/MyApp/lib
    # Preload your entire application
    PerlModule MyApp
    <VirtualHost *>
        ServerName    myapp.hostname.com
        DocumentRoot  /var/www/MyApp/root
        <Location />
            SetHandler          modperl
            PerlResponseHandler MyApp
        </Location>
        # you can also run your app in any non-root location
        <Location /some/other/path>
            SetHandler          perl-script
            PerlResponseHandler MyApp
        </Location>
        # Make sure to let Apache handle your static files
        # (It is not necessary to remove the Static::Simple plugin
        # in production; Apache will bypass Static::Simple if
        # configured in this way)
        <Location /static>
            SetHandler          default-handler
        </Location>
        # If not running at a root location in a VirtualHost,
        # you'll probably need to set an Alias to the location
        # of your static files, and allow access to this location:
        Alias /myapp/static /filesystem/path/to/MyApp/root/static
        <Directory /filesystem/path/to/MyApp/root/static>
            allow from all
        </Directory>
        <Location /myapp/static>
            SetHandler default-handler
        </Location>
    </VirtualHost>
```

## DESCRIPTION

This is the Catalyst engine specialized for Apache2 mod\_perl version 1.99x.

## WARNING

mod\_perl 1.99 was the beta version for mod\_perl 2.0.  Upgrading to 2.0 is strongly recommended.

## CGI ISSUES

In order to run Catalyst under mod\_perl 1.99 you will need to downgrade CGI to version 3.07, as it has dropped support for 1.99 in later versions.

## ModPerl::Registry

While this method is not recommended, you can also run your Catalyst application via a ModPerl::Registry script.

httpd.conf:

```
    PerlModule ModPerl::Registry
    Alias / /var/www/MyApp/script/myapp_registry.pl/
    <Directory /var/www/MyApp/script>
        Options +ExecCGI
    </Directory>
    <Location />
        SetHandler          perl-script
        PerlResponseHandler ModPerl::Registry
    </Location>
```

script/myapp\_registry.pl (you will need to create this):

```
    #!/usr/bin/perl
    use strict;
    use warnings;
    use MyApp;
    MyApp->handle_request( Apache::RequestUtil->request );
```

## METHODS

### ok\_constant

## SEE ALSO

Catalyst, Catalyst::Engine, Catalyst::Engine::Apache2.

## AUTHORS

- •

  Sebastian Riedel \<sri@cpan.org\>

- •

  Christian Hansen \<ch@ngmedia.com\>

- •

  Andy Grundman \<andy@hybridized.org\>

- •

  Tomas Doran \<bobtfish@bobtfish.net\>

## 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.