Catalyst - The Elegant MVC Web Application Framework
# use the helper to start a new application catalyst.pl MyApp cd MyApp # add models, views, controllers script/create.pl model Something script/create.pl view Stuff script/create.pl controller Yada # built in testserver script/server.pl # command line interface script/test.pl /yada use Catalyst; use Catalyst qw/My::Module My::OtherModule/; use Catalyst '-Debug'; use Catalyst qw/-Debug -Engine=CGI/; sub default : Private { $_[1]->res->output('Hello') } ); sub index : Path('/index.html') { my ( $self, $c ) = @_; $c->res->output('Hello'); $c->forward('foo'); } sub product : Regex('^product[_]*(\d*).html$') { my ( $self, $c ) = @_; $c->stash->{template} = 'product.tt'; $c->stash->{product} = $c->req->snippets->[0]; }
See also Catalyst::Manual::Intro
Catalyst is based upon Maypole, which you should consider for smaller projects.
The key concept of Catalyst is DRY (Don't Repeat Yourself).
See Catalyst::Manual for more documentation.
Catalyst plugins can be loaded by naming them as arguments to the "use Catalyst" statement. Omit the Catalyst::Plugin:: prefix from the plugin name, so Catalyst::Plugin::My::Module becomes My::Module.
Catalyst::Plugin::
Catalyst::Plugin::My::Module
My::Module
use Catalyst 'My::Module';
Special flags like -Debug and -Engine can also be specifed as arguments when Catalyst is loaded:
use Catalyst qw/-Debug My::Module/;
The position of plugins and flags in the chain is important, because they are loaded in exactly the order that they appear.
The following flags are supported:
enables debug output, i.e.:
use Catalyst '-Debug';
this is equivalent to:
use Catalyst; sub debug { 1 }
Force Catalyst to use a specific engine. Omit the Catalyst::Engine:: prefix of the engine name, i.e.:
Catalyst::Engine::
use Catalyst '-Engine=CGI';
Overload to enable debug messages.
Returns a hashref containing your applications settings.
Contains the engine class.
Contains the logging object. Unless it is already set Catalyst sets this up with a Catalyst::Log object. To use your own log class:
Catalyst::Log
$c->log( MyLogger->new ); $c->log->info("now logging with my own logger!");
Your log class should implement the methods described in the Catalyst::Log man page.
Instant plugins for Catalyst. Classdata accessor/mutator will be created, class loaded and instantiated.
MyApp->plugin( 'prototype', 'HTML::Prototype' ); $c->prototype->define_javascript_functions;
mod_perl2 support is considered experimental and may contain bugs.
IRC:
Join #catalyst on irc.perl.org.
Mailing-Lists:
http://lists.rawmode.org/mailman/listinfo/catalyst http://lists.rawmode.org/mailman/listinfo/catalyst-dev
Web:
http://catalyst.perl.org
Sebastian Riedel, sri@oook.de
sri@oook.de
Andy Grundman, Andrew Ford, Andrew Ruthven, Autrijus Tang, Christian Hansen, Christopher Hicks, Dan Sully, Danijel Milicevic, David Naughton, Gary Ashton Jones, Jesse Sheidlower, Jody Belka, Johan Lindstrom, Leon Brocard, Marcus Ramberg, Tatsuhiko Miyagawa and all the others who've helped.
This library is free software . You can redistribute it and/or modify it under the same terms as perl itself.
To install Catalyst, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Catalyst
CPAN shell
perl -MCPAN -e shell install Catalyst
For more information on module installation, please visit the detailed CPAN module installation guide.