NAME

Catalyst - The Elegant MVC Web Application Framework

SYNOPSIS

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

__PACKAGE__->action( '!default' => sub { $_[1]->res->output('Hello') } );

__PACKAGE__->action(
    'index.html' => sub {
        my ( $self, $c ) = @_;
        $c->res->output('Hello');
        $c->forward('_foo');
    }
);

__PACKAGE__->action(
    '/^product[_]*(\d*).html$/' => sub {
        my ( $self, $c ) = @_;
        $c->stash->{template} = 'product.tt';
        $c->stash->{product} = $c->req->snippets->[0];
    }
);

See also Catalyst::Manual::Intro

DESCRIPTION

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.

Omit the Catalyst::Plugin:: prefix from plugins. So Catalyst::Plugin::My::Module becomes My::Module.

use Catalyst 'My::Module';

You can also set special flags like -Debug and -Engine.

use Catalyst qw/-Debug My::Module/;

The position of plugins and flags in the chain is important, because they are loaded in the same order they appear.

-Debug

use Catalyst '-Debug';

is equivalent to

use Catalyst;
sub debug { 1 }

-Engine

Force Catalyst to use a specific engine. Omit the Catalyst::Engine:: prefix.

use Catalyst '-Engine=CGI';

METHODS

debug

Overload to enable debug messages.

config

Returns a hashref containing your applications settings.

SUPPORT

IRC:

Join #catalyst on irc.perl.org.

Mailing-Lists:

http://lists.rawmode.org/mailman/listinfo/catalyst
http://lists.rawmode.org/mailman/listinfo/catalyst-dev

SEE ALSO

Catalyst::Manual, Catalyst::Test, Catalyst::Request, Catalyst::Response, Catalyst::Engine

AUTHOR

Sebastian Riedel, sri@oook.de

THANK YOU

Andrew Ruthven, Christopher Hicks, Danijel Milicevic, David Naughton, Gary Ashton Jones, Jesse Sheidlower, Johan Lindstrom, Marcus Ramberg, Tatsuhiko Miyagawa and all the others who've helped.

LICENSE

This library is free software . You can redistribute it and/or modify it under the same terms as perl itself.