use strict;
use warnings;
-our $VERSION = "0.3";
+use CGI::Simple;
+use Maypole::Headers;
+use Maypole::Constants;
-sub run {
+our $VERSION = '2.12';
+
+__PACKAGE__->mk_accessors( qw/cgi/ );
+
+=head1 NAME
+
+CGI::Maypole - CGI-based front-end to Maypole
+
+=head1 SYNOPSIS
+
+ package BeerDB;
+ use Maypole::Application;
+
+ ## example beer.cgi:
+
+ #!/usr/bin/perl -w
+ use strict;
+ use BeerDB;
+ BeerDB->run();
+
+Now to access the beer database, type this URL into your browser:
+http://your.site/cgi-bin/beer.cgi/frontpage
+
+NOTE: this Maypole frontend requires additional modules that won't be installed
+or included with Maypole. Please see below.
+
+=head1 DESCRIPTION
+
+This is a CGI platform driver for Maypole. Your application can inherit from
+CGI::Maypole directly, but it is recommended that you use
+L<Maypole::Application>.
+
+This module requires CGI::Simple which you will have to install yourself via
+CPAN or manually.
+
+=head1 METHODS
+
+=over
+
+=item run
+
+Call this from your CGI script to start the Maypole application.
+
+=back
+
+=cut
+
+sub run
+{
my $self = shift;
- return $self->handler();
+ return $self->handler;
}
+=head1 Implementation
+
+This class overrides a set of methods in the base Maypole class to provide it's
+functionality. See L<Maypole> for these:
+
+=over
+
+=item get_request
+
+=cut
+
sub get_request {
- require CGI::Simple;
- shift->{cgi} = CGI::Simple->new();
+ my $self = shift;
+ my $request_options = $self->config->request_options || {};
+ $CGI::Simple::POST_MAX = $request_options->{POST_MAX} if ($request_options->{POST_MAX});
+ $self->cgi( CGI::Simple->new );
}
-sub parse_location {
- my $self = shift;
- $self->{path} = $self->{cgi}->url( -absolute => 1, -path_info => 1 );
- my $loc = $self->{cgi}->url( -absolute => 1 );
- no warnings 'uninitialized';
- $self->{path} =~ s/^($loc)?\///;
- $self->parse_path;
- $self->parse_args;
+=item parse_location
+
+=cut
+
+sub parse_location
+{
+ my $r = shift;
+ my $cgi = $r->cgi;
+
+ # Reconstruct the request headers (as far as this is possible)
+ $r->headers_in(Maypole::Headers->new);
+ for my $http_header ($cgi->http) {
+ (my $field_name = $http_header) =~ s/^HTTPS?_//;
+ $r->headers_in->set($field_name => $cgi->http($http_header));
+ }
+
+ $r->preprocess_location();
+
+ my $path = $cgi->url( -absolute => 1, -path_info => 1 );
+ my $loc = $cgi->url( -absolute => 1 );
+ {
+ no warnings 'uninitialized';
+ $path .= '/' if $path eq $loc;
+ if ($loc =~ /\/$/) {
+ $path =~ s/^($loc)?//;
+ } else {
+ $path =~ s/^($loc)?\///;
+ }
+ }
+ $r->path($path);
+
+ $r->parse_path;
+ $r->parse_args;
}
-sub parse_args {
- my $self = shift;
- my (%vars) = $self->{cgi}->Vars;
+=item warn
+
+=cut
+
+sub warn {
+ my ($self,@args) = @_;
+ my ($package, $line) = (caller)[0,2];
+ warn "[$package line $line] ", @args ;
+ return;
+}
+
+=item parse_args
+
+=cut
+
+sub parse_args
+{
+ my $r = shift;
+ my (%vars) = $r->cgi->Vars;
while ( my ( $key, $value ) = each %vars ) {
my @values = split "\0", $value;
$vars{$key} = @values <= 1 ? $values[0] : \@values;
}
- $self->{params} = {%vars};
- $self->{query} = {%vars};
+ $r->params( {%vars} );
+ $r->query( $r->params );
}
-sub send_output {
- my $r = shift;
- print $r->{cgi}->header(
- -type => $r->{content_type},
- -charset => $r->{document_encoding},
- -content_length => length $r->{output},
- );
- print $r->{output};
+=item redirect_request
+
+=cut
+
+# FIXME: use headers_in to gather host and other information?
+sub redirect_request
+{
+ my $r = shift;
+ my $redirect_url = $_[0];
+ my $status = "302";
+ if ($_[1]) {
+ my %args = @_;
+ if ($args{url}) {
+ $redirect_url = $args{url};
+ } else {
+ my $path = $args{path} || $r->cgi->url(-absolute => 1, -query=>1);
+ my $host = $args{domain};
+ ($host = $r->cgi->url(-base => 1)) =~ s/^https?:\/\///i unless ($host);
+ my $protocol = $args{protocol} || $r->get_protocol;
+ $redirect_url = "${protocol}://${host}/${path}";
+ }
+ $status = $args{status} if ($args{status});
+ }
+
+ $r->headers_out->set('Status' => $status);
+ $r->headers_out->set('Location' => $redirect_url);
+
+ return;
}
-sub get_template_root {
+=item get_protocol
+
+=cut
+
+sub get_protocol
+{
+ my $self = shift;
+ my $protocol = ($self->cgi->https) ? 'https' : 'http';
+ return $protocol;
+}
+
+=item send_output
+
+Generates output (using C<collect_output>) and prints it.
+
+=cut
+
+sub send_output
+{
my $r = shift;
- $r->{cgi}->document_root . "/" . $r->{cgi}->url( -relative => 1 );
+ print $r->collect_output;
}
-1;
+=item collect_output
-=head1 NAME
+Gathers headers and output together into a string and returns it.
-CGI::Maypole - CGI-based front-end to Maypole
+Splitting this code out of C<send_output> supports L<Maypole::HTTPD::Frontend>.
-=head1 SYNOPSIS
+=cut
- package BeerDB;
- use base 'CGI::Maypole;
- BeerDB->setup("dbi:mysql:beerdb");
- BeerDB->config->uri_base("http://your.site/cgi-bin/beer.cgi/");
- BeerDB->config->display_tables([qw[beer brewery pub style]]);
- # Now set up your database:
- # has-a relationships
- # untaint columns
+sub collect_output
+{
+ my $r = shift;
+
+ # Collect HTTP headers
+ my %headers = (
+ -type => $r->content_type,
+ -charset => $r->document_encoding,
+ -content_length => do { use bytes; length $r->output },
+ );
+ foreach ($r->headers_out->field_names) {
+ next if /^Content-(Type|Length)/;
+ $headers{"-$_"} = $r->headers_out->get($_);
+ }
- 1;
+ return $r->cgi->header(%headers) . $r->output;
+}
- ## example beer.cgi:
-
- #!/usr/bin/perl -w
- use strict;
- use BeerDB;
- BeerDB->run();
+=item get_template_root
-=head1 DESCRIPTION
+=cut
+
+sub get_template_root {
+ my $r = shift;
+ $r->cgi->document_root . "/" . $r->cgi->url( -relative => 1 );
+}
-This is a handler for Maypole which will use the CGI instead of Apache's
-C<mod_perl> 1.x. This handler can also be used for Apache 2.0.
+1;
+
+
+=back
+
+=head1 DEPENDANCIES
+
+CGI::Simple
=head1 AUTHORS
Dave Ranney C<dave@sialia.com>
Simon Cozens C<simon@cpan.org>
+
+=cut