# mod_perl
if (MP2) {
require Apache2;
+ require Apache::Connection;
require Apache::RequestIO;
require Apache::RequestRec;
require Apache::SubRequest;
=head1 DESCRIPTION
-The Apache Engine.
+This is the Catalyst engine specialized for Apache (i.e. for mod_perl).
-=head2 METHODS
+=head1 METHODS
-=head3 apache_request
+=over 4
+
+=item $c->apache_request
Returns an C<Apache::Request> object.
-=head3 original_request
+=item $c->original_request
Returns the original Apache request object.
-=head2 OVERLOADED METHODS
+=back
+
+=head1 OVERLOADED METHODS
This class overloads some methods from C<Catalyst::Engine>.
-=head3 finalize_headers
+=over 4
+
+=item $c->finalize_headers
=cut
return 0;
}
-=head3 finalize_output
+=item $c->finalize_output
=cut
$c->original_request->print( $c->response->{output} );
}
-=head3 prepare_cookies
+=item $c->prepare_connection
+
+=cut
+
+sub prepare_connection {
+ my $c = shift;
+ $c->req->hostname( $c->apache_request->connection->remote_host );
+ $c->req->address( $c->apache_request->connection->remote_ip );
+}
+
+=item $c->prepare_cookies
=cut
{ Apache::Cookie->new( $c->apache_request )->fetch } );
}
-=head3 prepare_headers
+=item $c->prepare_headers
=cut
$c->req->headers->header( %{ $c->apache_request->headers_in } );
}
-=head3 prepare_parameters
+=item $c->prepare_parameters
=cut
$c->req->parameters( \%args );
}
-=head3 prepare_path
+=item $c->prepare_path
=cut
no warnings 'uninitialized';
$c->req->{path} =~ s/^($loc)?\///;
my $base = URI->new;
- $base->scheme( $c->apache_request->protocol =~ /HTTPS/ ? 'https' : 'http' );
+ $base->scheme( $ENV{HTTPS} ? 'https' : 'http' );
$base->host( $c->apache_request->hostname );
$base->port( $c->apache_request->get_server_port );
- $base->path( $c->apache_request->location );
+ my $path = $c->apache_request->location;
+ $base->path( $path =~ /\/$/ ? $path : "$path/" );
$c->req->base( $base->as_string );
}
-=head3 prepare_request
+=item $c->prepare_request($r)
=cut
$c->original_request($r);
}
-=head3 prepare_uploads
+=item $c->prepare_uploads
=cut
my $c = shift;
for my $upload ( $c->apache_request->upload ) {
$upload = $c->apache_request->upload($upload) if MP2;
- $c->req->uploads->{ $upload->name } = {
- fh => $upload->fh,
- filename => $upload->filename,
- size => $upload->size,
- type => $upload->type
+ $c->req->uploads->{ $upload->filename } = {
+ fh => $upload->fh,
+ size => $upload->size,
+ type => $upload->type
};
}
}
+=back
+
=head1 SEE ALSO
L<Catalyst>.