README

   1 NAME
   2     Catalyst - The Elegant MVC Web Application Framework
   3
   4 SYNOPSIS
   5         # use the helper to start a new application
   6         catalyst.pl MyApp
   7         cd MyApp
   8
   9         # add models, views, controllers
  10         script/create.pl model Something
  11         script/create.pl view Stuff
  12         script/create.pl controller Yada
  13
  14         # built in testserver
  15         script/server.pl
  16
  17         # command line interface
  18         script/test.pl /yada
  19
  20         use Catalyst;
  21
  22         use Catalyst qw/My::Module My::OtherModule/;
  23
  24         use Catalyst '-Debug';
  25
  26         use Catalyst qw/-Debug -Engine=CGI/;
  27
  28         sub default : Private { $_[1]->res->output('Hello') } );
  29
  30         sub index : Path('/index.html') {
  31             my ( $self, $c ) = @_;
  32             $c->res->output('Hello');
  33             $c->forward('_foo');
  34         }
  35
  36         sub product : Regex('/^product[_]*(\d*).html$/') {
  37             my ( $self, $c ) = @_;
  38             $c->stash->{template} = 'product.tt';
  39             $c->stash->{product} = $c->req->snippets->[0];
  40         }
  41
  42     See also Catalyst::Manual::Intro
  43
  44 DESCRIPTION
  45     Catalyst is based upon Maypole, which you should consider for smaller
  46     projects.
  47
  48     The key concept of Catalyst is DRY (Don't Repeat Yourself).
  49
  50     See Catalyst::Manual for more documentation.
  51
  52     Catalyst plugins can be loaded by naming them as arguments to the "use
  53     Catalyst" statement. Omit the "Catalyst::Plugin::" prefix from the
  54     plugin name, so "Catalyst::Plugin::My::Module" becomes "My::Module".
  55
  56         use Catalyst 'My::Module';
  57
  58     Special flags like -Debug and -Engine can also be specifed as arguments
  59     when Catalyst is loaded:
  60
  61         use Catalyst qw/-Debug My::Module/;
  62
  63     The position of plugins and flags in the chain is important, because
  64     they are loaded in exactly the order that they appear.
  65
  66     The following flags are supported:
  67
  68     -Debug
  69         enables debug output, i.e.:
  70
  71             use Catalyst '-Debug';
  72
  73         this is equivalent to:
  74
  75             use Catalyst;
  76             sub debug { 1 }
  77
  78     -Engine
  79         Force Catalyst to use a specific engine. Omit the
  80         "Catalyst::Engine::" prefix of the engine name, i.e.:
  81
  82             use Catalyst '-Engine=CGI';
  83
  84 METHODS
  85     debug
  86         Overload to enable debug messages.
  87
  88     config
  89         Returns a hashref containing your applications settings.
  90
  91     $c->engine
  92         Contains the engine class.
  93
  94     $c->log
  95         Contains the logging object. Unless it is already set Catalyst sets
  96         this up with a "Catalyst::Log" object. To use your own log class:
  97
  98             $c->log( MyLogger->new );
  99             $c->log->info("now logging with my own logger!");
 100
 101         Your log class should implement the methods described in the
 102         "Catalyst::Log" man page.
 103
 104 SUPPORT
 105     IRC:
 106
 107         Join #catalyst on irc.perl.org.
 108
 109     Mailing-Lists:
 110
 111         http://lists.rawmode.org/mailman/listinfo/catalyst
 112         http://lists.rawmode.org/mailman/listinfo/catalyst-dev
 113
 114 SEE ALSO
 115     Catalyst::Manual - The Catalyst Manual
 116     Catalyst::Engine - Core Engine
 117     Catalyst::Log - The Log Class.
 118     Catalyst::Request - The Request Object
 119     Catalyst::Response - The Response Object
 120     Catalyst::Test - The test suite.
 121
 122 AUTHOR
 123     Sebastian Riedel, "sri@oook.de"
 124
 125 THANK YOU
 126     Andrew Ford, Andrew Ruthven, Christian Hansen, Christopher Hicks, Dan
 127     Sully, Danijel Milicevic, David Naughton, Gary Ashton Jones, Jesse
 128     Sheidlower, Johan Lindstrom, Marcus Ramberg, Tatsuhiko Miyagawa and all
 129     the others who've helped.
 130
 131 LICENSE
 132     This library is free software . You can redistribute it and/or modify it
 133     under the same terms as perl itself.
 134