/ 
Catalyst-5.00
/ Catalyst

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

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

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.

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.

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:

-Debug

enables debug output, i.e.:

use Catalyst '-Debug';

this is equivalent to:

use Catalyst;
sub debug { 1 }
-Engine

Force Catalyst to use a specific engine. Omit the Catalyst::Engine:: prefix of the engine name, i.e.:

use Catalyst '-Engine=CGI';

METHODS

debug

Overload to enable debug messages.

config

Returns a hashref containing your applications settings.

$c->engine

Contains the engine class.

$c->log

Contains the logging object. Unless it is already set Catalyst sets this up with a Catalyst::Log object. To use your own log class:

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

LIMITATIONS

FCGI and mod_perl2 support are considered experimental and may contain bugs.

You may encounter problems accessing the built in test server on public ip addresses on the internet, thats because of a bug in HTTP::Daemon.

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 - The Catalyst Manual
Catalyst::Engine - Core Engine
Catalyst::Log - The Log Class.
Catalyst::Request - The Request Object
Catalyst::Response - The Response Object
Catalyst::Test - The test suite.

AUTHOR

Sebastian Riedel, sri@oook.de

THANK YOU

Andy Grundman, Andrew Ford, Andrew Ruthven, Christian Hansen, Christopher Hicks, Dan Sully, 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.