1 package Catalyst::Engine::CGI;
4 use base 'Catalyst::Engine';
8 __PACKAGE__->mk_accessors('env');
12 Catalyst::Engine::CGI - The CGI Engine
16 A script using the Catalyst::Engine::CGI module might look like:
21 use lib '/path/to/MyApp/lib';
26 The application module (C<MyApp>) would use C<Catalyst>, which loads the
27 appropriate engine module.
31 This is the Catalyst engine specialized for the CGI environment.
33 =head1 OVERLOADED METHODS
35 This class overloads some methods from C<Catalyst::Engine>.
37 =head2 $self->finalize_headers($c)
41 sub finalize_headers {
42 my ( $self, $c ) = @_;
44 $c->response->header( Status => $c->response->status );
46 return unless *STDOUT->opened();
48 print $c->response->headers->as_string("\015\012");
52 =head2 $self->prepare_connection($c)
56 sub prepare_connection {
57 my ( $self, $c ) = @_;
58 local (*ENV) = $self->env || \%ENV;
60 $c->request->address( $ENV{REMOTE_ADDR} );
64 unless ( $c->config->{using_frontend_proxy} ) {
65 last PROXY_CHECK if $ENV{REMOTE_ADDR} ne '127.0.0.1';
66 last PROXY_CHECK if $c->config->{ignore_frontend_proxy};
68 last PROXY_CHECK unless $ENV{HTTP_X_FORWARDED_FOR};
70 # If we are running as a backend server, the user will always appear
71 # as 127.0.0.1. Select the most recent upstream IP (last in the list)
72 my ($ip) = $ENV{HTTP_X_FORWARDED_FOR} =~ /([^,\s]+)$/;
73 $c->request->address($ip);
76 $c->request->hostname( $ENV{REMOTE_HOST} );
77 $c->request->protocol( $ENV{SERVER_PROTOCOL} );
78 $c->request->user( $ENV{REMOTE_USER} );
79 $c->request->method( $ENV{REQUEST_METHOD} );
81 if ( $ENV{HTTPS} && uc( $ENV{HTTPS} ) eq 'ON' ) {
82 $c->request->secure(1);
85 if ( $ENV{SERVER_PORT} == 443 ) {
86 $c->request->secure(1);
90 =head2 $self->prepare_headers($c)
95 my ( $self, $c ) = @_;
96 local (*ENV) = $self->env || \%ENV;
98 # Read headers from %ENV
99 foreach my $header ( keys %ENV ) {
100 next unless $header =~ /^(?:HTTP|CONTENT|COOKIE)/i;
101 ( my $field = $header ) =~ s/^HTTPS?_//;
102 $c->req->headers->header( $field => $ENV{$header} );
106 =head2 $self->prepare_path($c)
111 my ( $self, $c ) = @_;
112 local (*ENV) = $self->env || \%ENV;
114 my $scheme = $c->request->secure ? 'https' : 'http';
115 my $host = $ENV{HTTP_HOST} || $ENV{SERVER_NAME};
116 my $port = $ENV{SERVER_PORT} || 80;
118 if ( exists $ENV{REDIRECT_URL} ) {
119 $base_path = $ENV{REDIRECT_URL};
120 $base_path =~ s/$ENV{PATH_INFO}$//;
123 $base_path = $ENV{SCRIPT_NAME} || '/';
126 # If we are running as a backend proxy, get the true hostname
129 unless ( $c->config->{using_frontend_proxy} ) {
130 last PROXY_CHECK if $host !~ /localhost|127.0.0.1/;
131 last PROXY_CHECK if $c->config->{ignore_frontend_proxy};
133 last PROXY_CHECK unless $ENV{HTTP_X_FORWARDED_HOST};
135 $host = $ENV{HTTP_X_FORWARDED_HOST};
137 # backend could be on any port, so
138 # assume frontend is on the default port
139 $port = $c->request->secure ? 443 : 80;
142 my $path = $base_path . ( $ENV{PATH_INFO} || '' );
146 $uri->scheme($scheme);
150 $uri->query( $ENV{QUERY_STRING} ) if $ENV{QUERY_STRING};
153 $uri = $uri->canonical;
154 $c->request->uri($uri);
157 # base must end in a slash
158 $base_path .= '/' unless ( $base_path =~ /\/$/ );
159 my $base = $uri->clone;
160 $base->path_query($base_path);
161 $c->request->base($base);
164 =head2 $self->prepare_query_parameters($c)
168 sub prepare_query_parameters {
169 my ( $self, $c ) = @_;
170 local (*ENV) = $self->env || \%ENV;
172 if ( $ENV{QUERY_STRING} ) {
173 $self->SUPER::prepare_query_parameters( $c, $ENV{QUERY_STRING} );
177 =head2 $self->prepare_request($c, (env => \%env))
181 sub prepare_request {
182 my ( $self, $c, %args ) = @_;
185 $self->env( $args{env} );
189 =head2 $self->prepare_write($c)
191 Enable autoflush on the output handle for CGI-based engines.
196 my ( $self, $c ) = @_;
198 # Set the output handle to autoflush
199 *STDOUT->autoflush(1);
201 $self->NEXT::prepare_write($c);
204 =head2 $self->read_chunk($c, $buffer, $length)
208 sub read_chunk { shift; shift; *STDIN->sysread(@_); }
214 sub run { shift; shift->handle_request(@_) }
218 L<Catalyst> L<Catalyst::Engine>.
222 Sebastian Riedel, <sri@cpan.org>
224 Christian Hansen, <ch@ngmedia.com>
226 Andy Grundman, <andy@hybridized.org>
230 This program is free software, you can redistribute it and/or modify it under
231 the same terms as Perl itself.