require CGI::Simple;
require CGI::Cookie;
+$CGI::Simple::POST_MAX = 1048576;
+$CGI::Simple::DISABLE_UPLOADS = 0;
+
__PACKAGE__->mk_accessors('cgi');
=head1 NAME
=head1 SYNOPSIS
-See L<Catalyst>.
+A script using the Catalyst::Engine::CGI module might look like:
+
+ #!/usr/bin/perl -w
+
+ use strict;
+ use lib '/path/to/MyApp/lib';
+ use MyApp;
+
+ MyApp->run;
+
+The application module (C<MyApp>) would use C<Catalyst>, which loads the
+appropriate engine module.
=head1 DESCRIPTION
-This is the CGI engine for Catalyst.
+This is the Catalyst engine specialized for the CGI environment (using the
+C<CGI::Simple> and C<CGI::Cookie> modules). Normally Catalyst will select the
+appropriate engine according to the environment that it detects, however you
+can force Catalyst to use the CGI engine by specifying the following in your
+application module:
+
+ use Catalyst qw(-Engine=CGI);
+
+Catalyst::Engine::CGI generates a full set of HTTP headers, which means that
+applications using the engine must be be configured as "Non-parsed Headers"
+scripts (at least when running under Apache). To configure this under Apache
+name the starting with C<nph->.
+
+The performance of this way of using Catalyst is not expected to be
+useful in production applications, but it may be helpful for development.
-=head2 METHODS
+=head1 METHODS
-=head3 run
+=over 4
+
+=item $c->run
To be called from a CGI script to start the Catalyst application.
-=head3 cgi
+=item $c->cgi
This config parameter contains the C<CGI::Simple> object.
-=head2 OVERLOADED METHODS
+=back
+
+=head1 OVERLOADED METHODS
This class overloads some methods from C<Catalyst>.
-=head3 finalize_headers
+=over 4
+
+=item $c->finalize_headers
=cut
print $c->cgi->header(%headers);
}
-=head3 finalize_output
+=item $c->finalize_output
+
+Prints the response output to STDOUT.
=cut
print $c->response->output;
}
-=head3 prepare_cookies
+=item $c->prepare_cookies
+
+Sets up cookies.
=cut
sub prepare_cookies { shift->req->cookies( { CGI::Cookie->fetch } ) }
-=head3 prepare_headers
+=item $c->prepare_headers
=cut
}
}
-=head3 prepare_parameters
+=item $c->prepare_parameters
=cut
$c->req->parameters( {%vars} );
}
-=head3 prepare_path
+=item $c->prepare_path
=cut
$c->req->{path} =~ s/^($loc)?\///;
$c->req->{path} .= '/' if $c->req->path eq $loc;
my $base = $c->cgi->url;
+ if ( $ENV{CATALYST_TEST} ) {
+ my $script = $c->cgi->script_name;
+ $base =~ s/$script$//i;
+ }
$base = URI->new($base);
$base->path('/') if ( $ENV{CATALYST_TEST} || !$base->path );
$c->req->base( $base->as_string );
}
-=head3 prepare_request
+=item $c->prepare_request
=cut
sub prepare_request { shift->cgi( CGI::Simple->new ) }
-=head3 prepare_uploads
+=item $c->prepare_uploads
=cut
sub prepare_uploads {
my $c = shift;
for my $name ( $c->cgi->upload ) {
- my $filename = $c->req->params->{$name};
$c->req->uploads->{$name} = {
- fh => $c->cgi->upload($filename),
- filename => $filename,
- size => $c->cgi->upload_info( $filename, 'size' ),
- type => $c->cgi->upload_info( $filename, 'mime' )
+ fh => $c->cgi->upload($name),
+ size => $c->cgi->upload_info( $name, 'size' ),
+ type => $c->cgi->upload_info( $name, 'mime' )
};
}
}
sub run { shift->handler }
+=back
+
=head1 SEE ALSO
L<Catalyst>.
=cut
1;
-## Please see file perltidy.ERR