The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Catalyst::Engine::Apache::MP13 - Catalyst Apache mod_perl 1.3x Engine

SYNOPSIS

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

DESCRIPTION

This is the Catalyst engine specialized for Apache mod_perl version 1.3x.

Apache::Registry

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

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>

script/myapp_registry.pl (you will need to create this):

    #!/usr/bin/perl

    use strict;
    use warnings;
    use MyApp;

    MyApp->handle_request( Apache->request );

METHODS

ok_constant

OVERLOADED METHODS

This class overloads some methods from Catalyst::Engine::Apache.

$c->engine->finalize_headers

SEE ALSO

Catalyst, Catalyst::Engine, Catalyst::Engine::Apache.

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.