Catalyst::Engine::Apache2::MP19 - Catalyst Apache2 mod_perl 1.99x Engine
# 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 # (And remember to remove the Static::Simple plugin in production) <Location /static> SetHandler default-handler </Location> </VirtualHost>
This is the Catalyst engine specialized for Apache2 mod_perl version 1.99x.
mod_perl 1.99 was the beta version for mod_perl 2.0. Upgrading to 2.0 is strongly recommended.
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.
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 );
Catalyst, Catalyst::Engine, Catalyst::Engine::Apache2.
Sebastian Riedel, <sri@cpan.org>
Christian Hansen, <ch@ngmedia.com>
Andy Grundman, <andy@hybridized.org>
This program is free software, you can redistribute it and/or modify it under the same terms as Perl itself.
To install Catalyst::Engine::Apache, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Catalyst::Engine::Apache
CPAN shell
perl -MCPAN -e shell install Catalyst::Engine::Apache
For more information on module installation, please visit the detailed CPAN module installation guide.